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 Orchestration: Zorgt voor een robuuste uitvoering van langlopende bedrijfsprocessen. Handelt storingen en retries automatisch af, wat de voltooiing van taken garandeert.
• Distributed Transactions: Zorgt voor een consistente uitvoering van operaties over verschillende services zonder gebruik te maken van gedistribueerde locks.
• Timeouts and Scheduling: Maakt het mogelijk om timers in te stellen en taken met hoge precisie in te plannen, zelfs voor langdurige processen.
• Scalability: Ondersteunt horizontale schaalbaarheid om hoge belastingen op te vangen. Componenten kunnen onafhankelijk van elkaar worden geschaald.
• Historical Debugging: Bewaart de geschiedenis van de procesuitvoering, wat analyse en debugging van workflows mogelijk maakt.
• Versioning: Ondersteunt veilige workflow-updates zonder lopende taken te onderbreken.
• Observability: Integreert met monitoring- en tracingsystemen voor applicatiecontrole.
• Multi-tenancy: Biedt isolatie en resourcebeheer voor meerdere teams of applicaties.

Implementatiefuncties¶

Aan de slag na het implementeren van Temporal¶

Na betaling wordt er een melding over de gereedheid van de server naar uw geregistreerde e-mailadres gestuurd. Deze bevat het VPS IP-adres en de inloggegevens voor toegang. Onze klanten beheren de hardware via het server management panel and API — Invapi.

Nadat u op de link heeft geklikt via het webpanel tag, wordt er een autorisatiewinstven geopend.

De autorisatiedata vindt u in het tabblad Configuration >> Tags van het server management panel of in de verzonden e-mail:

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

Belangrijkste componenten met een webinterface:

Startscherm en navigatie¶

Nadat u op de link heeft geklikt via het webpanel tag, wordt de Temporal webinterface geopend:

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

Hoofdelementen van de interface:

• Sidebar aan de linkerkant biedt toegang tot verschillende secties van het systeem;
• Top bar toont de huidige namespace (standaard is dit "default");
• Start Workflow knop in de rechterbovenhoek om nieuwe processen te starten;
• Process table met kolommen Status, Workflow ID, Run ID, Type, Start, End.

Functionele mogelijkheden

1. Een nieuwe Workflow Process starten:

   • Klik op de Start Workflow knop in de rechterbovenhoek;
   • Vul de benodigde parameters in het verschijnende formulier in;
   • Bevestig de procescreatie.

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 gedetailleerde informatie.

3. Codevoorbeelden:

   • Toegang tot integratievoorbeelden via de links naar de GitHub-repository:
   • 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;
   • (Gear) knop is bedoeld voor toegang tot aanvullende interface-instellingen.

Typische use cases:

• Monitoring Processes: Regelmatig de status van lopende taken controleren;
• Debugging: Gedetailleerde analyse van fouten in het geval van storingen;
• Managing Workloads: Processen starten, pauzeren en annuleren;
• Developing New Processes: Codevoorbeelden gebruiken om aangepaste workflows te maken.

Temporal testen met Go (Optioneel)¶

1. Installeer Go¶

Voordat u begint met testen, moet u Go op de server installeren:

Update package lists

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. Clone de Temporal Examples Repository¶

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 pattern wordt gebruikt voor het beheren van gedistribueerde transacties, wat de mogelijkheid biedt om terug te draaien (compenseren) in het geval van fouten.

Structuur van het Saga voorbeeld

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

Voer de test uit:

1. Start de worker (uitvoeren in de eerste terminal):

   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 de tweede terminal):

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

   De starter initieert het proces van geldoverboeking van het ene account naar het 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 activity StepWithError;
4. Drie pogingen om de defecte activity uit te voeren;
5. Het starten van compenserende acties:
   • Geld terugstorten naar het oorspronkelijke account;
   • De geldopname annuleren.

4. Resultaten verifiëren via de Temporal Web Interface¶

1. Open de Temporal webinterface in uw browser (via het webpanel tag);
2. Zoek in de interface naar 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¶

Om deze software te installeren met behulp van de API, volgt u deze instructie.