> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Lebenszyklus

> Laufzeitvertrag für die Vantage-Custom-Resource: Reconciliierungs-Phasen, Statusbedingungen und das Erzwingen eines erneuten Versuchs.

Diese Seite dokumentiert den Laufzeitvertrag zwischen Ihnen und dem Vantage operator: die Phasen, die der Operator bei jedem Reconciliierungsvorgang durchläuft, die Statusbedingungen, die er für die Ressource `Vantage` zurückmeldet, und wie Sie einen erneuten Versuch erzwingen. Das Schema auf Feldebene finden Sie in der [API-Referenz](/de/vantage/self-hosted/v3.0/api-reference). Einen konzeptionellen Überblick finden Sie unter [Architektur](/de/vantage/self-hosted/v3.0/architecture).

<div id="reconcile-phases">
  ## Reconciliierungs-Phasen
</div>

Der Reconciliierungs-Ablauf des Operators ist in fünf aufeinanderfolgende Phasen gegliedert. Jede Phase enthält Validierungen oder Schritte, die alle erfolgreich abgeschlossen werden müssen, bevor der Operator zur nächsten Phase übergeht. Ein Fehler in einem beliebigen Schritt führt zum Abbruch des Reconciliierungs-Ablaufs und wird in `status.degradationReasons[]` ausgewiesen.

| # | Phase                | Was passiert                                                                                                                                                                                                                                                                                                                                  |
| - | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1 | **Vorabprüfung**     | Validiert die Konfiguration. Während der Vorabprüfung wird die Secrets-Konfiguration validiert.                                                                                                                                                                                                                                               |
| 2 | **Secrets**          | Stellt sicher, dass die secretsbezogenen Ressourcen für den konfigurierten Secrets-Provider vorhanden sind. Für den Azure Key Vault-Provider stellt der Operator pro Chart `SecretProviderClass`-Ressourcen bereit; der Secrets Store CSI driver liefert die Werte beim Start an Pods. Der Operator materialisiert Secret-Werte nicht selbst. |
| 3 | **OCI-Migration**    | Führt den einmaligen Job aus, der Vantage-Artefakte aus der von ABBYY bereitgestellten Quell-Registry in die Ziel-Registry kopiert, die unter `spec.ociMigration.destination` angegeben ist. Wird übersprungen, wenn `spec.ociMigration.enabled: false`.                                                                                      |
| 4 | **Installation**     | Generiert ArgoCD-`Application`-Manifeste für jede Vantage-Komponente aus der Workloads-ConfigMap und wendet sie an.                                                                                                                                                                                                                           |
| 5 | **Synchronisierung** | Überwacht den Status der ArgoCD-Anwendung, weist Fehler pro Komponente über `status.degradationReasons[]` aus und aktualisiert die Bedingungen `Progressing`, `Ready` und `Degraded` entsprechend.                                                                                                                                            |

<div id="status-conditions">
  ## Statusbedingungen
</div>

Der Operator meldet den Installationsstatus über Bedingungstypen in `status.conditions[]`:

* **`Progressing`**: `status` ist `True`, solange der Prozess läuft.
* **`Ready`**: `status` ist bei erfolgreichem Abschluss `True`.
* **`Degraded`**: `status` ist `True`, wenn zu irgendeinem Zeitpunkt ein Fehler auftritt. In diesem Fall enthält `status.degradationReasons[]` die Details zu den Fehlern.

Die Installationsverfahren für Azure und selbstverwaltete Umgebungen warten auf `condition=Ready` (`kubectl wait --for=condition=Ready vantages.vantage.abbyy.com/$release_name`). `Ready` deckt die Skill-Installation nicht ab, da diese als separater Job ausgeführt wird (siehe unten), und Sie sollten außerdem die generierten ArgoCD-Anwendungen prüfen. Das vollständige Status-Schema finden Sie in der [`Vantage.status`-Referenz](/de/vantage/self-hosted/v3.0/api-reference#vantagestatus).

<div id="skill-installation-runs-separately">
  ### Die Installation der Skills läuft separat
</div>

Skills werden über einen separaten Kubernetes-Job im Install-Namespace installiert, nicht über eine ArgoCD-Anwendung. Der Job wird in ArgoCD nicht angezeigt und ist in den obigen Bedingungen nicht enthalten. `Ready` bedeutet daher nicht, dass die Installation der Skills abgeschlossen ist. Sie können Vantage verwenden, während der Job läuft.

Überwachen Sie den Job direkt:

```bash theme={null}
kubectl -n $install_namespace wait --for=create job/$install_namespace-skill-installer-job
kubectl -n $install_namespace wait --for=condition=Complete job/$install_namespace-skill-installer-job
```

<div id="forcing-a-retry">
  ## Erneuten Installationsversuch erzwingen
</div>

Um die Installation erneut auszuführen (zum Beispiel nach dem Korrigieren einer Key Vault-Berechtigung), versehen Sie die `Vantage`-Ressource mit der Annotation `vantage.abbyy.com/reprocess` (beliebiger Wert):

```bash theme={null}
kubectl -n $install_namespace annotate vantages.vantage.abbyy.com/$release_name \
  vantage.abbyy.com/reprocess="$(date +%s)" --overwrite
```

Die `Vantage` Custom-Resource ist änderbar. Um die Installation von Vantage jedoch erneut auszuführen, muss die entsprechende `Vantage`-CR mit `vantage.abbyy.com/reprocess` annotiert werden (beliebiger Wert). Das Bearbeiten von `spec.*` allein startet keinen erneuten Versuch nach einer fehlgeschlagenen Installation. Korrigieren Sie zunächst die Spezifikation und fügen Sie dann die Annotation hinzu, um den erneuten Versuch auszulösen.

<div id="whats-next">
  ## Nächste Schritte
</div>

<CardGroup cols={2}>
  <Card title="API-Referenz" icon="code" href="/de/vantage/self-hosted/v3.0/api-reference">
    Detaillierte Referenz zu jedem Feld jeder Spezifikation und Statuseigenschaft.
  </Card>

  <Card title="Fehlerbehebung" icon="stethoscope" href="/de/vantage/self-hosted/v3.0/troubleshooting">
    Symptom → Diagnose → Lösung für häufige Fehler beim Reconciliieren.
  </Card>
</CardGroup>