Temporal¶

In dit artikel

• Temporal. Belangrijkste functies
• Implementatiefuncties
• Aan de slag na het implementeren van Temporal
• Startscherm en navigatie
• Temporal testen met Go (optioneel)
• Een Temporal-server bestellen via de API

Temporal. Belangrijkste functies¶

• Workflow-orchestratie: Biedt robuuste uitvoering van langlopende bedrijfsprocessen. Handelt automatisch fouten en opnieuw pogingen af en garandeert het voltooien van taken.
• Gedistribueerde transacties: Zorgt voor consistente uitvoering van bewerkingen over verschillende services zonder gebruik te maken van gedistribueerde vergrendelingen.
• Time-outs en planning: Staart het instellen van timers en het plannen van taken toe met hoge precisie, zelfs voor lange processen.
• Schaalbaarheid: Ondersteunt horizontale schaalbaarheid om hoge belastingen aan te kunnen. Componenten kunnen onafhankelijk van elkaar worden geschaald.
• Historisch debuggen: Bewaart de geschiedenis van de procesuitvoering, waardoor analyse en debuggen van workflows mogelijk zijn.
• Versiebeheer: Ondersteunt veilige workflow-updates zonder onderbreking van lopende taken.
• Waarnembaarheid: Integreert met monitoring- en tracing-systemen voor applicatiebeheer.
• Multi-tenancy: Biedt isolatie en resourcebeheer voor meerdere teams of applicaties.

Implementatiefuncties¶

• Vooraf geïnstalleerde afhankelijkheden:
  • Docker;
  • Git (voor het klonen van repositories).
• Aanvullende componenten:
  • Nginx (voor reverse proxy);
  • Postgresql (database);
  • Elasticsearch (voor het opslaan van workflowgeschiedenis);
  • Grafana (voor monitoring);
  • Prometheus (voor het verzamelen van metrieken);
  • Jaeger (voor gedistribueerd tracing);
  • OpenTelemetry Collector (voor het verzamelen van telemetrie).
• Projectmap: /root/docker-compose
• Aanpassingsbestand: /root/docker-compose/docker-compose-multirole_edited.yaml

Belangrijkste componenten met een webinterface:

Aan de slag na het implementeren van Temporal¶

Na betaling ontvangt u een melding over de gereedheid van de server op uw geregistreerde e-mailadres. Deze bevat het VPS-IP-adres en inloggegevens voor toegang. Klanten van ons bedrijf beheren de hardware via het serverbeheerpaneel en de API — Invapi.

Na het volgen van de link van de webpanel-tag opent er een autorisatievenster.

Autorisatiegegevens zijn te vinden in het tabblad Configuration >> Tags van het serverbeheerpaneel of in de verzonden e-mail:

• Link voor toegang tot het Temporal-beheerpaneel via de webinterface: in de webpanel-tag;
• Login en Wachtwoord voor het beheren van de server: verstrekt in een e-mail bij de overdracht van de server.

Startscherm en navigatie¶

Na het volgen van de link van de webpanel-tag opent de Temporal-webinterface:

Het hoofdscherm toont een lijst met workflows (Workflows) in de geselecteerde namespace. Het bericht "No Workflows running in this Namespace" geeft aan dat er op dat moment geen actieve processen zijn.

Belangrijkste elementen van de interface:

• Sidebar aan de linkerkant biedt toegang tot verschillende secties van het systeem;
• Top bar toont de huidige namespace (standaard "default");
• Start Workflow-knop in de rechterbovenhoek voor het starten van nieuwe processen;
• Proces tabel met kolommen Status, Workflow ID, Run ID, Type, Start, Eind.

Functionele mogelijkheden

1. Een nieuw workflowproces starten:

   • Klik op de Start Workflow-knop in de rechterbovenhoek;
   • Vul de benodigde parameters in het verschijnende formulier in;
   • Bevestig het aanmaken van het proces.

2. Processen bekijken en filteren:

   • Gebruik de Filter-knop om processen te selecteren op basis van verschillende criteria;
   • Kies een willekeurig proces uit de tabel voor het bekijken van gedetailleerde informatie.

3. Codevoorbeelden:

   • Toegang tot integratievoorbeelden via GitHub-repository-links:
   • samples-go - Go-voorbeelden;
   • samples-java - Java-voorbeelden;
   • samples-typescript - TypeScript-voorbeelden;
   • samples-python - Python-voorbeelden;
   • samples-dotnet - .NET-voorbeelden;
   • samples-php - PHP-voorbeelden.

4. Instellingen wijzigen:

   • UTC-selector in de rechterbovenhoek voor het wijzigen van de tijdzone;
   • (Tandwiel)-knop is bedoeld voor toegang tot aanvullende interface-instellingen.

Typische gebruiksscenario's:

• Processen monitoren: Regelmatig de status van lopende taken controleren;
• Debuggen: Gedetailleerde analyse van fouten bij falen;
• Workloads beheren: Processen starten, pauzeren en annuleren;
• Nieuwe processen ontwikkelen: Codevoorbeelden gebruiken om aangepaste workflows te maken.

Temporal testen met Go (optioneel)¶

1. Go installeren¶

Voordat u met het testen begint, installeert u Go op de server:

Pakketlijsten bijwerken

apt update

apt install -y wget git curl

wget https://golang.org/dl/go1.22.1.linux-amd64.tar.gz

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. De Temporal-voorbeeldenrepository klonen¶

Ga naar de home-directory

cd ~

git clone https://github.com/temporalio/samples-go.git

cd samples-go

3. Testen met het Saga-voorbeeld¶

Het Saga-patroon wordt gebruikt voor het beheren van gedistribueerde transacties, waarbij het mogelijk is om terug te draaien (compenseren) bij fouten.

Structuur van het Saga-voorbeeld

saga/
├── worker/main.go     # Workerproces dat taken afhandelt
├── start/main.go      # Initialiseert het workerproces
├── activity.go        # Definitie van acties (geld opnemen/storten)
├── workflow.go        # Definitie van de reeks acties
└── shared.go          # Algemene definities

Test uitvoeren:

1. Start de worker (uitvoeren in het eerste terminalvenster):

   cd ~/samples-go
   go run saga/worker/main.go
   

   De worker registreert zich bij Temporal en wacht op een taak. Er verschijnen logberichten over pogingen om taken op te halen.

2. Start de starter (uitvoeren in het tweede terminalvenster):

   cd ~/samples-go
   go run saga/start/main.go
   

   De starter start het proces van het overmaken van geld van de ene account naar de andere.

Verwacht resultaat:

In de logs van de worker ziet u:

1. Geldopname van account 001-001;
2. Geldstorting op account 002-002;
3. Een speciaal gecreëerde fout in activiteit StepWithError;
4. Drie pogingen om de defecte activiteit uit te voeren;
5. Start van compenserende acties:
   • Terugbetaling van het geld naar het oorspronkelijke account;
   • Annulering van de geldopname.

4. Resultaten verifiëren via de Temporal-webinterface¶

1. Open de Temporal-webinterface in uw browser (via de webpanel-tag);
2. Zoek in de interface de workflow met ID transfer-money-workflow;
3. U ziet de volledige uitvoeringsgeschiedenis van de workflow, inclusief alle activiteiten en compenserende acties:

Een Temporal-server bestellen via de API¶