ACI — Backend-Wartung

1.1 Warum Wartungsmaßnahmen durchführen

Diese Anwendung ist auf hohe Ausfallsicherheit ausgelegt und erfordert keine häufigen Wartungsmaßnahmen. In manchen Situationen kann es jedoch erforderlich sein, den Stack neu zu starten, um eine neue Version anzuwenden oder sich von einem Fehlerzustand zu erholen.

Wenn beispielsweise die Datenverarbeitung fehlschlägt, können sich temporäre Dateien in den Redis- oder RabbitMQ-Volumes ansammeln. Ein Neustart der Container-Gruppe löscht den In-Memory-Zustand und setzt die Warteschlange zurück.

Hinweis: Dieser Abschnitt behandelt nur die Wartung auf ACI-Ebene. Netzwerk- oder Firewall-Konfigurationen, die spezifisch für Ihre Organisation sind, liegen außerhalb des Umfangs dieses Dokuments.

1.2 Wann sollten Sie Wartungsmaßnahmen durchführen?

1.2.1 Datenverarbeitungsprozesse fehlgeschlagen

Das erste Anzeichen dafür, dass Ihre Anwendung Aufmerksamkeit benötigt, ist, wenn von Dynamics 365 gestartete Datenverarbeitungsprozesse den Status Failed anzeigen. Bevor Sie handeln, prüfen Sie die Fehlerbeschreibung, um Probleme in Ihren Deduplizierungsregeln oder anderen Integrationen auszuschließen.

Wenn der Fehler auf den Server selbst hinweist, fahren Sie mit Abschnitt 1.3, Vorgehensweise, fort.

1.2.2 Datenverarbeitungsprozesse ausstehend

Wenn die Job-Warteschlange bei derselben Nachricht hängen bleibt und Datenverarbeitungsprozesse blockiert, leeren Sie das RabbitMQ-Volume und starten Sie die Container-Gruppe neu.

1. Schritt 1 — Löschen Sie den Inhalt der RabbitMQ-File-Share:

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

2. Schritt 2 — Starten Sie die Container-Gruppe neu:

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

1.3 Vorgehensweise

1.3.1 Schritt 1 – Logs abrufen

Die Logs werden von ACI verwaltet. Verwenden Sie die Azure CLI, um sie abzurufen.

Logs des Unify Servers anzeigen:

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

Logs des Queue Workers anzeigen:

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

Logs in Echtzeit verfolgen:

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

1.3.2 Schritt 2 – Anwendung neu erstellen / aktualisieren

Um eine neuere Image-Version bereitzustellen, löschen Sie die Container-Gruppe und stellen Sie sie anhand der aktualisierten YAML-Datei neu bereit.

1. Schritt 1 — Löschen Sie die bestehende Container-Gruppe:

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

2. Schritt 2 — Optional: Leeren Sie bei Bedarf die persistenten Volumes:

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

3. Schritt 3 — Stellen Sie mit der aktualisierten YAML-Datei erneut bereit:

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

1.3.3 Schritt 3 – Neustart

Für einen einfachen Neustart ohne erneute Bereitstellung:

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

Überwachen Sie den Neustart:

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

Alle Container sollten den Status Running erreichen. Wenn ein Container Terminated anzeigt oder hängen bleibt, prüfen Sie seine Logs und wenden Sie sich an den DQE Software Support, wenn das Problem nicht behoben werden kann.