> ## 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.

# Upgrade

> Führen Sie ein Upgrade von Vantage 3.0 selbstgehostet durch, indem Sie passende neue Versionen des Operators und der Vantage-Helm-Charts installieren.

Upgrades von Vantage 3.0 selbstgehostet erfolgen operatorgesteuert. Führen Sie ein Upgrade der Helm-Releases `vantage-operator` und `vantage-selfhosted` auf dieselbe neue Version durch. Das neue `vantage-selfhosted`-Chart verweist auf eine versionierte Workloads-ConfigMap. Dadurch verarbeitet der Operator die Ressource `Vantage` erneut und reconciliiert die entsprechende Vantage-Version. Automatische Upgrades sind noch nicht implementiert.

<div id="upgrade-workflow">
  ## Upgrade-Workflow
</div>

Der Operator und die Vantage-Charts werden zusammen veröffentlicht und müssen versionsgleich bleiben. Durch die Installation des neuen Operators werden der kompatible Controller und die CRD vorbereitet; durch die Installation des passenden `vantage-selfhosted`-Charts wird der Verweis auf die versionierte Workloads-ConfigMap aktualisiert und das In-Place-Update ausgelöst.

So führen Sie das Upgrade durch:

<Steps>
  <Step title="Installierte Version prüfen">
    Bestätigen Sie die aktuell ausgeführte Version, indem Sie `status.installedVantageVersion` der `Vantage`-Ressource prüfen:

    ```bash theme={null}
    kubectl -n $install_namespace get vantages.vantage.abbyy.com $release_name -o yaml
    ```
  </Step>

  <Step title="Beide Charts upgraden">
    Führen Sie zuerst das Upgrade des Operators durch und aktualisieren Sie dann das Release `vantage-selfhosted` auf dieselbe Version.

    ```bash theme={null}
    helm upgrade --install vantage-operator $charts_uri/vantage-operator \
      --version $new_version \
      --namespace $operator_namespace \
      --wait

    helm upgrade --install $release_name $chart_uri/vantage-selfhosted \
      --version $new_version \
      --namespace $install_namespace \
      --values <your-values-file> \
      --wait
    ```

    Wenn Sie GitOps verwenden, aktualisieren Sie beide Chart-Revisionen auf dieselbe Version und lassen Sie sie von Ihrem Controller mit Ihrer vorhandenen Wertequelle rendern.
  </Step>

  <Step title="Warten, bis die Ressource reconciliiert ist">
    Überwachen Sie die `Vantage`-Ressource auf `Ready`:

    ```bash theme={null}
    kubectl -n $install_namespace wait \
      --for=condition=Ready vantages.vantage.abbyy.com/$release_name \
      --timeout=30m
    ```

    Für eine detailliertere Einsicht überwachen Sie den OCI-Migrations-Job und den Anwendungssynchronisierungsstatus von ArgoCD. Die Skill-Installation wird als separater Job ausgeführt, den ArgoCD nicht nachverfolgt; siehe [Lifecycle](/de/vantage/self-hosted/v3.0/lifecycle#skill-installation-runs-separately). Wenn ein Chart nicht reconciliiert werden kann, zeigt der Operator die Ursache in `status.degradationReasons[]` an.
  </Step>
</Steps>

<div id="whats-different-from-vantage-27">
  ## Was sich gegenüber Vantage 2.7 geändert hat
</div>

In der selbstgehosteten Version von Vantage 2.7 bedeutete ein Upgrade, den Ansible-Installer-Container mit einer aktualisierten Values-Datei auszuführen und per `helm upgrade` jedes Chart nacheinander zu aktualisieren – ein Vorgang, der Infrastruktur und Anwendungskonfiguration in einem Schritt betraf.

In 3.0 ist das Upgrade der Anwendung von Infrastrukturänderungen entkoppelt:

| Schritt                            | 2.7                                              | 3.0                                                                         |
| ---------------------------------- | ------------------------------------------------ | --------------------------------------------------------------------------- |
| Ein Upgrade auslösen               | Den Ansible-Installer-Container erneut ausführen | Die passenden neuen Versionen der Operator- und Vantage-Charts installieren |
| Änderungen pro Komponente anwenden | Ansible führt für jedes Chart `helm upgrade` aus | Der Operator erzeugt ArgoCD-`Application`-Manifeste; ArgoCD reconciliert    |

Das Installationsmodell aus 2.7 wird in 3.0 nicht unterstützt, und es gibt kein In-Place-Upgrade von 2.7. Der Wechsel von 2.7 ist eine Migration; siehe [Migration von Vantage 2.7](/de/vantage/self-hosted/v3.0/migration-from-2.7). Die Upgrades der Vantage-Charts decken nur Vantage Core ab: Software, die Sie separat installiert haben, etwa Ihren Monitoring-Stack, aktualisieren Sie selbst nach Ihrem eigenen Zeitplan.

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

<CardGroup cols={2}>
  <Card title="Architektur" icon="diagram-project" href="/de/vantage/self-hosted/v3.0/architecture">
    Was der Operator bei jedem Reconcile-Vorgang macht.
  </Card>

  <Card title="Bekannte Einschränkungen" icon="triangle-exclamation" href="/de/vantage/self-hosted/v3.0/known-limitations">
    Einschränkungen, die Sie vor der Planung eines Upgrade-Zeitfensters kennen sollten.
  </Card>
</CardGroup>