ACI — Maintenance du backend

1.1 Pourquoi effectuer des opérations de maintenance

Cette application est conçue pour être résiliente et ne nécessite pas de maintenance fréquente. Cependant, dans certaines situations, il peut être nécessaire de redémarrer la stack pour appliquer une nouvelle version ou récupérer d'un état d'erreur.

Par exemple, si le traitement des données échoue, des fichiers temporaires peuvent s'accumuler dans les volumes Redis ou RabbitMQ. Redémarrer le Container Group efface l'état en mémoire et réinitialise la file d'attente.

Remarque : Cette section couvre uniquement la maintenance au niveau ACI. La configuration réseau ou pare-feu spécifique à votre organisation est hors du périmètre de ce document.

1.2 Quand effectuer une maintenance ?

1.2.1 Échec des traitements de données

Le premier signal indiquant que votre application nécessite une attention particulière est lorsque les traitements de données lancés depuis Dynamics 365 affichent un statut Failed. Avant d'agir, vérifiez la description de l'erreur pour écarter des problèmes dans vos règles de dédoublonnage ou d'autres intégrations.

Si l'erreur pointe vers le serveur lui-même, passez à la section 1.3, Comment procéder.

1.2.2 Traitements de données en attente

Si la file d'attente reste bloquée sur le même message et empêche les traitements de données, videz le volume RabbitMQ et redémarrez le Container Group.

1. Étape 1 — Supprimer le contenu du partage de fichiers RabbitMQ :

   az storage file delete-batch \
     --account-name dqeunifystorage \
     --source rabbitvol

2. Étape 2 — Redémarrer le Container Group :

   az container restart \
     --resource-group <resource-group> \
     --name dqe-unify

1.3 Comment procéder

1.3.1 Étape 1 – Récupérer les logs

Les logs sont gérés par ACI. Utilisez Azure CLI pour les récupérer.

Afficher les logs du Unify Server :

az container logs \
  --resource-group <resource-group> \
  --name dqe-unify \
  --container-name unify-server

Afficher les logs du Queue Worker :

az container logs \
  --resource-group <resource-group> \
  --name dqe-unify \
  --container-name queue-worker

Suivre les logs en temps réel :

az container logs \
  --resource-group <resource-group> \
  --name dqe-unify \
  --container-name unify-server \
  --follow

1.3.2 Étape 2 – Reconstruire / mettre à jour l'application

Pour déployer une nouvelle version d'image, supprimez le Container Group et redéployez depuis le YAML mis à jour.

1. Étape 1 — Supprimer le Container Group existant :

   az container delete \
     --resource-group <resource-group> \
     --name dqe-unify \
     --yes

2. Étape 2 — Optionnel : vider les volumes persistants si nécessaire :

   az storage file delete-batch --account-name dqeunifystorage --source redisvol
   az storage file delete-batch --account-name dqeunifystorage --source rabbitvol

3. Étape 3 — Redéployer avec le YAML mis à jour :

   az container create \
     --resource-group <resource-group> \
     --file container-group.yaml

1.3.3 Étape 3 – Redémarrer

Pour un simple redémarrage sans redéploiement :

az container restart \
  --resource-group <resource-group> \
  --name dqe-unify

Surveiller le redémarrage :

az container show \
  --resource-group <resource-group> \
  --name dqe-unify \
  --query "containers[].{Name:name, State:instanceView.currentState.state}" \
  -o table

Tous les conteneurs doivent atteindre l'état Running. Si un conteneur affiche Terminated ou reste bloqué, vérifiez ses logs et contactez le support DQE Software si le problème ne peut pas être résolu.