Անցնել պարունակությանը

Temporal

Այս հոդվածում

Տեղեկատվություն

Temporal-ը բաց կոդով հարթակ է վստահելի բաշտված հավելվածների ստեղծման համար: Այն լուծում է ժամանակակից մշակման հիմնական մարտահրավերներից մեկը՝ անկայուն միջավայրերում կարևոր գործընթացների կատարումն ապահովելը: Այն թույլ է տալիս ծրագրավորողներին կենտրոնանալ բիզնես տրամաբանության վրա, այլ ոչ թե ենթակառուցվածքային ձախողումների վերամշակման վրա:

Temporal. Հիմնական հնարավորություններ

  • Workflow Orchestration: Ապահովում է երկարատև բիզնես գործընթացների հուսալի կատարումը: Ավտոմատ կերպով հանդարձարում է ձախողումները և կրկնությունները (retries), երաշխավորելով առաջադրանքների ավարտը:
  • Distributed Transactions: Ապահովում է տարբեր ծառայությունների միջև գործողությունների հետ nhấtական կատարումը՝ առանց բաշտված তালাկներ (distributed locks) օգտագործելու:
  • Timeouts և Ժամանակացույց: Թույլ է տալիս սահմանել թայմերներ և պլանավորել առաջադրանքները բարձր ճշտությամբ, նույնիսկ երկարատև գործընթացների համար:
  • Scalability: Աջակցում է հորիզոնական մասշտաբավորմանը՝ բարձր ծանրաբեռնվածությունն ապահովելու համար: Բաղադրիչները կարող են մասշտաբավորվել անկախ:
  • Historical Debugging: Պահպանում է գործընթացների կատարման պատմությունը՝ հնարավորություն տալով վերլուծել և ուղղել (debug) workflow-ները:
  • Versioning: Աջակցում է workflow-ների անվտանգ թարմացումներին՝ առանց ընթացիկ առաջադրանքների կատարումը ընդհատելու:
  • Observability: Ինտեգրվում է մոնիթորինգի և թրեյսինգի (tracing) համակարգերի հետ հավելվածի վերահսկման համար:
  • Multi-tenancy: Ապահովում է մեկուսացում և ռեսուրսների կառավարում բազմաթիվ թիմերի կամ հավելվածների համար:

Տեղակայման հնարավորություններ

ID Ծրագրային ապահովման անվանում Համատեղելի ՕՀ VM BM VGPU GPU Նվազագույն CPU (միջուկներ) Նվազագույն RAM (ԳԲ) Նվազագույն HDD/SSD (ԳԲ) Սեփական դոմեն Ակտիվ
266 Temporal Ubuntu 24.04 + + + + 2 2 30 Ոչ ՊԱՏՎԻՐԵԼ

Temporal-ի տեղակայումից հետո սկսել աշխատանքը

Վճարումից հետո ձեր գրանցված էլեկտրոնային հասցեին կուղարկվի ծանուցում սերվերի պատրաստ լինելու մասին: Այն կներառի VPS IP հասցեն և մուտքի տվյալները: Մեր ընկերության հաճախորդները կառավարում են սարքավորումները server management panel և API — Invapi միջոցով:

Հետևելով webpanel թեգի հղմանը՝ կբացվի նույնականացման (authorization) պատուհան:

Արտադրողական տվյալները կարող եք գտնել server management panel-ի Configuration >> Tags թաբում կամ ուղարկված էլեկտրոնային նամակում:

  • Temporal management panel-ին մուտք գործելու հղումը web interface-ի միջոցով: webpanel թեգի մեջ:
  • Login և Password սերվերի կառավարման համար. տրամադրվում է էլեկտրոնային նամակով սերվերի հանձնման պահին:

Web interface ունեցող հիմնական բաղադրիչները.

Name Local address and port External address
Temporal UI localhost:8080 https://temporal{server_id_from_invapi}.hostkey.in
Grafana localhost:8085 https://temporal{server_id_from_invapi}.hostkey.in/grafana/
Prometheus localhost:9090 https://temporal{server_id_from_invapi}.hostkey.in/prometheus/
Prometheus Metrics - https://temporal{server_id_from_invapi}.hostkey.in/prometheus/metrics

Գլխավոր էկրանը և նավիգացիան

Հետևելով webpanel թեգի հղմանը, կբացվի Temporal web interface-ը:

Temporal UI

Գլխավոր էկրանը ցուցադրում է workflow-ների (Workflows) ցուցակը ընտրված namespace-ում: "No Workflows running in this Namespace" հաղորդագրությունը նշանակում է, որ տվյալ պահին ակտիվ գործընթացներ չկան:

Ինտերֆեյսի հիմնական տարրերը.

  • Sidebar-ը ձախ կողմում ապահովում է համակարգի տարբեր բաժիններ հասանելիություն:
  • Top bar-ը ցույց է տալիս ընթացիկ namespace-ը (լռելக்கրոպես՝ "default"):
  • Start Workflow կոճակը վերևի աջ անկյունում՝ նոր գործընթացներ սկսելու համար:
  • Process table՝ Status, Workflow ID, Run ID, Type, Start, End սյունակներով:

Ֆունկցիոնալ հնարավորություններ

  1. Նոր Workflow գործընթաց սկսել:

    • Սեղմեք Start Workflow կոճակին վերևի աջ անկյունում:
    • Լրացրեք անհրաժեշտ պարամետրերը հայտնվող ձևում:
    • Հաստատեք գործընթացի ստեղծումը:
  2. Գործընթացների դիտում և ֆիլտրում:

    • Օգտագործեք Filter կոճակը՝ տարբեր չափանիշներով գործընթացներ ընտրելու համար:
    • Ընտրեք ցուցակից ցանկացած գործընթաց՝ մանրամասն տեղեկատվություն տեսնելու համար:
  3. Code Examples:

    • Հասանելիություն ստացեք ինտեգրման օրինակներին՝ սկզբնական GitHub պահոցների (repository) հղումների միջոցով.
    • samples-go - Go օրինակներ;
    • samples-java - Java օրինակներ;
    • samples-typescript - TypeScript օրինակներ;
    • samples-python - Python օրինակներ;
    • samples-dotnet - .NET օրինակներ;
    • samples-php - PHP օրինակներ.
  4. Կարգավորումների փոփոխություն:

    • UTC selector վերևի աջ անկյունում՝ ժամային գոտիներ փոխելու համար:
    • (Gear) կոճակը նախատեսված է ինտերֆեյսի լրացուցիչ կարգավորումներին հասնելու համար:

Օգտագործման տիպիկ դ cases:

  • Գործընթացների մոնիթորինգ: Ընթացիկ առաջադրանքների կարգավիճակի պարբերական ստուգում:
  • Debugging: Սխալների մանրամասն վերլուծություն ձախողումների դեպքում:
  • Workloads-ի կառավարում: Գործընթացների սկիզբ, դադարեցում և չեղարկում:
  • Նոր գործընթացների մշակում: Կոդի օրինակների օգտագործում՝ ստեղծողական workflow-ներ ստեղծելու համար:

Նշում

Temporal-ից օգտվելու մասին մանրամասն տեղեկատվությունը կարելի է գտնել պաշտոնական մշակողների փաստաթղթերում.

Temporal-ի թեստավորում Go լեզվով (Կամընտիր)

Տեղեկատվություն

Ստորև ներկայացված է անհրաժեշտ բաղադրիչների տեղակայման և Go լեզվով Saga pattern օրինակով Temporal-ի թեստավորման գործընթացը: Այս թեստը ցույց է տալիս հարթակի հիմնական հնարավորությունը՝ երկարատև բիզնես գործընթացների հուսալի կատարում և ձախողումների ավտոմատ մշտադրում: Saga pattern-ը լուծում է բաշտված համակարգերում գործարքների ատոմիկության խնդիրը՝ փոխհատուցող գործողությունների մեխանիզմի միջոցով:

1. Տեղադրել Go

Նախքան թեստավորումը սկսելը, տեղադրեք Go-ն սերվերի վրա.

Թարմացնել փաթեթների ցուցակները

apt update
Տեղադրել անհրաժեշտությունները

apt install -y wget git curl
Ներբեռնել Go-ի վերջին տարբերակը (այս պահին՝ 1.22.1)

wget https://golang.org/dl/go1.22.1.linux-amd64.tar.gz
Արխիվը արտահանել /usr/local դեպքում

tar -C /usr/local -xzf go1.22.1.linux-amd64.tar.gz
Կարգավորել շրջակա միջավայրի փոփոխականները

echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
echo 'export GOPATH=$HOME/go' >> ~/.bashrc
echo 'export PATH=$PATH:$GOPATH/bin' >> ~/.bashrc
Կիրառել փոփոխությունները ընթացիկ սեսիայում

source ~/.bashrc
Ստուգել տեղադրումը

go version

2. Կլոնելել Temporal Examples պահոցը

Անցնել home դիրք

cd ~
Կլոնելել Go օրինակների պահոցը

git clone https://github.com/temporalio/samples-go.git
Անցնել օրինակների թղթապանակ

cd samples-go

3. Թեստավորում Saga օրինակի օգտագործմամբ

Saga pattern-ն օգտագործվում է բաշտված գործարքների կառավարման համար՝ ապահովելով սխալների դեպքում հետադարձ գործողությունների (rollback/compensate) հնարավորությունը:

Saga օրինակի կառուցվածքը

saga/
├── worker/main.go     # Task-երն իրականացնող worker գործընթացը
├── start/main.go      # Ինիցիալիզացնում է worker գործընթացը
├── activity.go        # Գործողությունների սահմանում (արտահանում/վերադարձում միջոցներ)
├── workflow.go        # Գործողությունների հաջորդականության սահմանում
└── shared.go          # Ընդհանուր սահմանումներ

Գործարկել թեստը.

  1. Սկսել worker-ը (կատարել առաջին terminal-ում).

    cd ~/samples-go
    go run saga/worker/main.go
    
    Worker-ը կռեգիստրացիա կանցցնի Temporal-ում և կսպասի առաջադրանքին: Կհայտնվեն լոգերային հաղորդագրություններ առաջադրանքներ ստանալու փորձերի մասին:

  2. Սկսել starter-ը (կատարել երկրորդ terminal-ում).

    cd ~/samples-go
    go run saga/start/main.go
    
    Starter-ը նախաձեռնում է փողի փոխանցման գործընթացը մի հաշվից մյուսը:

Ակնկալվող արդյունքը.

Worker-ի լոգերներում դուք կտեսնեք.

  1. Գումարի արտահանում 001-001 հաշվից:
  2. Գումարի ներդրում 002-002 հաշվի վրա:
  3. Հատուկ ստեղծված սխալ StepWithError activity-ում:
  4. Չկայացած activity-ի կատարման երեք փորձեր:
  5. Փոխհատուցող գործողությունների գործարկում.
    • Գումարի վերադարձ սկզբնական հաշվին:
    • Գումարի արտահանման չեղարկում:

4. Ստուգել արդյունքները Temporal Web Interface-ի միջոցով

  1. Բացեք Temporal web interface-ը ձեր բրաউզերում (via webpanel թեգի միջոցով):
  2. Ինտերֆեյսում գտեք transfer-money-workflow ID պարունակող workflow-ը.
  3. Դուք կտեսնեք workflow-ի ամբողջական կատարման պատմությունը, ներառյալ բոլոր activity-ները և փոխհատուցող գործողությունները.

Տեղեկատվություն

Temporal web interface-ում դուք կտեսնեք, որ transfer-money-workflow-ի կարգավիճակը "Failed" է: Սա սխալ չէ թեստի կարգավորման կամ կատարման մեջ, այլ սպասվող վարքագիծ է Saga օրինակի համար: Այս օրինակը հատուկ նախագծված է սխալի հանդեպ հանդելու դեպքում փոխհատուցման մեխանիզմը ցույց տալու համար: StepWithError activity-ն միտIntentional (կանխամտածված) սխալ է գեներացնում արտահանումից և ներդրումից հետո՝ ցույց տալով, թե ինչպես են գործարկվում փոխհատուցող գործողությունները: "Failed" կարգավիճակը նշանակում է, որ փոխհատուցման մեխանիզմը ճիշտ աշխատել է, և համակարգը վերադարձել է կայուն վիճակ՝ սխալը հայտնաբերելուց հետո:

Temporal սերվերի պատվիրումը API-ի միջոցով

Այս ծրագրի տեղադրումը API-ի միջոցով իրականացնելու համար հետևեք այս հրահանգներին.

question_mark
Is there anything I can help you with?
question_mark
AI Assistant ×