Temporal¶

Dans cet article

• Temporal. Fonctionnalités principales
• Fonctionnalités de déploiement
• Prise en main après le déploiement de Temporal
• Écran d'accueil et navigation
• Test de Temporal avec Go (Facultatif)
• Commander un serveur Temporal via l'API

Temporal. Fonctionnalités principales¶

• Orchestration de workflows : Fournit une exécution robuste de processus métier de longue durée. Gère automatiquement les pannes et les tentatives, garantissant l'achèvement des tâches.
• Transactions distribuées : Assure une exécution cohérente des opérations à travers différents services sans utiliser de verrous distribués.
• Délais d'expiration et planification : Permet de définir des minuteries et de planifier des tâches avec une grande précision, même pour les processus longs.
• Évolutivité : Prend en charge l'évolutivité horizontale pour gérer des charges élevées. Les composants peuvent être mis à l'échelle indépendamment.
• Débogage historique : Conserve l'historique de l'exécution des processus, permettant l'analyse et le débogage des workflows.
• Gestion des versions : Prend en charge les mises à jour sécurisées des workflows sans interrompre les tâches en cours.
• Observabilité : S'intègre aux systèmes de surveillance et de traçage pour le contrôle de l'application.
• Multi-locataire : Fournit l'isolation et la gestion des ressources pour plusieurs équipes ou applications.

Fonctionnalités de déploiement¶

• Dépendances préinstallées :
  • Docker ;
  • Git (pour le clonage de référentiels).
• Composants supplémentaires :
  • Nginx (pour le proxy inverse) ;
  • Postgresql (base de données) ;
  • Elasticsearch (pour le stockage de l'historique des workflows) ;
  • Grafana (pour la surveillance) ;
  • Prometheus (pour la collecte des métriques) ;
  • Jaeger (pour la traçabilité distribuée) ;
  • OpenTelemetry Collector (pour la collecte de télémétrie).
• Répertoire du projet : /root/docker-compose
• Fichier de personnalisation : /root/docker-compose/docker-compose-multirole_edited.yaml

Composants principaux avec une interface web :

Prise en main après le déploiement de Temporal¶

Après le paiement, une notification concernant la disponibilité du serveur sera envoyée à votre adresse e-mail enregistrée. Elle contiendra l'adresse IP du VPS et les identifiants de connexion pour l'accès. Les clients de notre entreprise gèrent le matériel via le panneau de gestion des serveurs et l'API — Invapi.

Après avoir suivi le lien depuis la balise webpanel, une fenêtre d'autorisation s'ouvrira.

Les données d'autorisation peuvent être trouvées dans l'onglet Configuration >> Tags du panneau de gestion du serveur ou dans l'e-mail envoyé :

• Lien pour accéder au panneau de gestion Temporal via l'interface web : dans la balise webpanel ;
• Login et Password pour la gestion du serveur : fournis par e-mail lors de la remise du serveur.

Écran d'accueil et navigation¶

Après avoir suivi le lien depuis la balise webpanel, l'interface web Temporal s'ouvrira :

L'écran principal affiche une liste de workflows (Workflows) dans l'espace de noms sélectionné. Le message "No Workflows running in this Namespace" indique l'absence de processus actifs à ce moment-là.

Éléments principaux de l'interface :

• Sidebar sur la gauche permet d'accéder aux différentes sections du système ;
• Top bar affiche l'espace de noms actuel (par défaut, "default") ;
• Bouton Start Workflow dans le coin supérieur droit pour démarrer de nouveaux processus ;
• Process table avec les colonnes Status, Workflow ID, Run ID, Type, Start, End.

Capacités fonctionnelles

1. Démarrage d'un nouveau processus de workflow :

   • Cliquez sur le bouton Start Workflow dans le coin supérieur droit ;
   • Remplissez les paramètres nécessaires dans le formulaire qui apparaît ;
   • Confirmez la création du processus.

2. Affichage et filtrage des processus :

   • Utilisez le bouton Filter pour sélectionner des processus en fonction de divers critères ;
   • Choisissez n'importe quel processus dans le tableau pour afficher des informations détaillées.

3. Exemples de code :

   • Accédez aux exemples d'intégration via les liens vers les référentiels GitHub :
   • samples-go - exemples Go ;
   • samples-java - exemples Java ;
   • samples-typescript - exemples TypeScript ;
   • samples-python - exemples Python ;
   • samples-dotnet - exemples .NET ;
   • samples-php - exemples PHP.

4. Modification des paramètres :

   • Sélecteur UTC dans le coin supérieur droit pour changer de fuseau horaire ;
   • Bouton (Gear) destiné à accéder aux paramètres supplémentaires de l'interface.

Cas d'utilisation typiques :

• Surveillance des processus : Vérification régulière de l'état des tâches en cours ;
• Débogage : Analyse détaillée des erreurs en cas de panne ;
• Gestion de la charge de travail : Démarrage, mise en pause et annulation des processus ;
• Développement de nouveaux processus : Utilisation d'exemples de code pour créer des workflows personnalisés.

Test de Temporal avec Go (Facultatif)¶

1. Installer Go¶

Avant de commencer les tests, installez Go sur le serveur :

Mettre à jour les listes de paquets

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. Cloner le référentiel d'exemples Temporal¶

Aller dans le répertoire personnel

cd ~

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

cd samples-go

3. Tester à l'aide de l'exemple Saga¶

Le modèle Saga est utilisé pour gérer les transactions distribuées, garantissant la possibilité de revenir en arrière (compenser) en cas d'erreur.

Structure de l'exemple Saga

saga/
├── worker/main.go     # Processus worker gérant les tâches
├── start/main.go      # Initialise le processus worker
├── activity.go        # Définition des actions (retrait/dépôt de fonds)
├── workflow.go        # Définition de la séquence d'actions
└── shared.go          # Définitions communes

Exécuter le test :

1. Démarrer le worker (exécuter dans le premier terminal) :

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

   Le worker s'enregistrera auprès de Temporal et attendra une tâche. Des messages journal concernant les tentatives d'obtention de tâches apparaîtront.

2. Démarrer le starter (exécuter dans le deuxième terminal) :

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

   Le starter initie le processus de transfert d'argent d'un compte à un autre.

Résultat attendu :

Dans les journaux du worker, vous verrez :

1. Retrait d'argent du compte 001-001 ;
2. Dépôt d'argent sur le compte 002-002 ;
3. Une erreur spécialement créée dans l'activité StepWithError ;
4. Trois tentatives d'exécution de l'activité défectueuse ;
5. Lancement d'actions compensatoires :
   • Retour des fonds vers le compte d'origine ;
   • Annulation du retrait d'argent.

4. Vérifier les résultats via l'interface web Temporal¶

1. Ouvrez l'interface web Temporal dans votre navigateur (via la balise webpanel) ;
2. Dans l'interface, trouvez le workflow avec l'ID transfer-money-workflow ;
3. Vous verrez l'historique d'exécution complet du workflow, y compris toutes les activités et actions compensatoires :

Commander un serveur Temporal via l'API¶