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-ը:

Գլխավոր էկրանը ցուցադրում է 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 սյունակներով:
Ֆունկցիոնալ հնարավորություններ
-
Նոր Workflow գործընթաց սկսել:
- Սեղմեք
Start Workflowկոճակին վերևի աջ անկյունում: - Լրացրեք անհրաժեշտ պարամետրերը հայտնվող ձևում:
- Հաստատեք գործընթացի ստեղծումը:
- Սեղմեք
-
Գործընթացների դիտում և ֆիլտրում:
- Օգտագործեք
Filterկոճակը՝ տարբեր չափանիշներով գործընթացներ ընտրելու համար: - Ընտրեք ցուցակից ցանկացած գործընթաց՝ մանրամասն տեղեկատվություն տեսնելու համար:
- Օգտագործեք
-
Code Examples:
- Հասանելիություն ստացեք ինտեգրման օրինակներին՝ սկզբնական GitHub պահոցների (repository) հղումների միջոցով.
- samples-go - Go օրինակներ;
- samples-java - Java օրինակներ;
- samples-typescript - TypeScript օրինակներ;
- samples-python - Python օրինակներ;
- samples-dotnet - .NET օրինակներ;
- samples-php - PHP օրինակներ.
-
Կարգավորումների փոփոխություն:
- UTC selector վերևի աջ անկյունում՝ ժամային գոտիներ փոխելու համար:
(Gear) կոճակը նախատեսված է ինտերֆեյսի լրացուցիչ կարգավորումներին հասնելու համար:
Օգտագործման տիպիկ դ cases:
- Գործընթացների մոնիթորինգ: Ընթացիկ առաջադրանքների կարգավիճակի պարբերական ստուգում:
- Debugging: Սխալների մանրամասն վերլուծություն ձախողումների դեպքում:
- Workloads-ի կառավարում: Գործընթացների սկիզբ, դադարեցում և չեղարկում:
- Նոր գործընթացների մշակում: Կոդի օրինակների օգտագործում՝ ստեղծողական workflow-ներ ստեղծելու համար:
Նշում
Temporal-ից օգտվելու մասին մանրամասն տեղեկատվությունը կարելի է գտնել պաշտոնական մշակողների փաստաթղթերում.
Temporal-ի թեստավորում Go լեզվով (Կամընտիր)¶
Տեղեկատվություն
Ստորև ներկայացված է անհրաժեշտ բաղադրիչների տեղակայման և Go լեզվով Saga pattern օրինակով Temporal-ի թեստավորման գործընթացը: Այս թեստը ցույց է տալիս հարթակի հիմնական հնարավորությունը՝ երկարատև բիզնես գործընթացների հուսալի կատարում և ձախողումների ավտոմատ մշտադրում: Saga pattern-ը լուծում է բաշտված համակարգերում գործարքների ատոմիկության խնդիրը՝ փոխհատուցող գործողությունների մեխանիզմի միջոցով:
1. Տեղադրել Go¶
Նախքան թեստավորումը սկսելը, տեղադրեք Go-ն սերվերի վրա.
Թարմացնել փաթեթների ցուցակները
Տեղադրել անհրաժեշտությունները Ներբեռնել Go-ի վերջին տարբերակը (այս պահին՝ 1.22.1) Արխիվը արտահանել/usr/local դեպքում Կարգավորել շրջակա միջավայրի փոփոխականները Կիրառել փոփոխությունները ընթացիկ սեսիայում Ստուգել տեղադրումը 2. Կլոնելել Temporal Examples պահոցը¶
Անցնել home դիրք
Կլոնելել Go օրինակների պահոցը Անցնել օրինակների թղթապանակ3. Թեստավորում Saga օրինակի օգտագործմամբ¶
Saga pattern-ն օգտագործվում է բաշտված գործարքների կառավարման համար՝ ապահովելով սխալների դեպքում հետադարձ գործողությունների (rollback/compensate) հնարավորությունը:
Saga օրինակի կառուցվածքը
saga/
├── worker/main.go # Task-երն իրականացնող worker գործընթացը
├── start/main.go # Ինիցիալիզացնում է worker գործընթացը
├── activity.go # Գործողությունների սահմանում (արտահանում/վերադարձում միջոցներ)
├── workflow.go # Գործողությունների հաջորդականության սահմանում
└── shared.go # Ընդհանուր սահմանումներ
Գործարկել թեստը.
-
Սկսել worker-ը (կատարել առաջին terminal-ում).
Worker-ը կռեգիստրացիա կանցցնի Temporal-ում և կսպասի առաջադրանքին: Կհայտնվեն լոգերային հաղորդագրություններ առաջադրանքներ ստանալու փորձերի մասին: -
Սկսել starter-ը (կատարել երկրորդ terminal-ում).
Starter-ը նախաձեռնում է փողի փոխանցման գործընթացը մի հաշվից մյուսը:
Ակնկալվող արդյունքը.
Worker-ի լոգերներում դուք կտեսնեք.
- Գումարի արտահանում 001-001 հաշվից:
- Գումարի ներդրում 002-002 հաշվի վրա:
- Հատուկ ստեղծված սխալ
StepWithErroractivity-ում: - Չկայացած activity-ի կատարման երեք փորձեր:
- Փոխհատուցող գործողությունների գործարկում.
- Գումարի վերադարձ սկզբնական հաշվին:
- Գումարի արտահանման չեղարկում:
4. Ստուգել արդյունքները Temporal Web Interface-ի միջոցով¶
- Բացեք Temporal web interface-ը ձեր բրաউզերում (via webpanel թեգի միջոցով):
- Ինտերֆեյսում գտեք
transfer-money-workflowID պարունակող workflow-ը. - Դուք կտեսնեք workflow-ի ամբողջական կատարման պատմությունը, ներառյալ բոլոր activity-ները և փոխհատուցող գործողությունները.

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