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

# Mise à niveau

> Mettez à niveau Vantage 3.0 auto-hébergé en installant les nouvelles versions correspondantes de l’opérateur et des charts Helm Vantage.

Les mises à niveau de Vantage 3.0 auto-hébergé sont gérées par l’opérateur. Mettez à niveau les releases Helm `vantage-operator` et `vantage-selfhosted` vers la même nouvelle version. Le nouveau chart `vantage-selfhosted` fait référence à une ConfigMap versionnée de charges de travail, ce qui amène l’opérateur à retraiter la ressource `Vantage` et à réconcilier la release Vantage correspondante. Les mises à niveau automatiques ne sont pas encore implémentées.

<div id="upgrade-workflow">
  ## Workflow de mise à niveau
</div>

L’opérateur et les charts Vantage sont publiés ensemble et doivent rester alignés sur la même version. L’installation du nouvel opérateur prépare le contrôleur et la CRD compatibles ; l’installation du chart `vantage-selfhosted` correspondant met à jour la référence ConfigMap des charges de travail versionnées et déclenche la mise à jour sur place.

Pour effectuer la mise à niveau :

<Steps>
  <Step title="Vérifier la version installée">
    Confirmez la version actuellement déployée en vérifiant `status.installedVantageVersion` sur la ressource `Vantage` :

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

  <Step title="Mettre à niveau les deux charts">
    Mettez d’abord l’opérateur à niveau, puis mettez la release `vantage-selfhosted` à niveau vers la même 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
    ```

    Si vous utilisez GitOps, mettez à jour les révisions des deux charts vers la même version et laissez votre contrôleur les générer à partir de votre source de valeurs existante.
  </Step>

  <Step title="Attendre la réconciliation de la ressource">
    Surveillez la ressource `Vantage` jusqu’à l’état `Ready` :

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

    Pour une visibilité plus fine, surveillez le job de migration OCI et l’état de synchronisation de l’application ArgoCD. L’installation des Skills s’exécute comme un job distinct qu’ArgoCD ne suit pas ; voir [Lifecycle](/fr/vantage/self-hosted/v3.0/lifecycle#skill-installation-runs-separately). Si un chart ne parvient pas à se réconcilier, l’opérateur indique la cause dans `status.degradationReasons[]`.
  </Step>
</Steps>

<div id="whats-different-from-vantage-27">
  ## Différences par rapport à Vantage 2.7
</div>

Dans Vantage 2.7 auto-hébergé, une mise à niveau consistait à exécuter le conteneur d’installation Ansible avec un fichier de valeurs mis à jour et à le laisser lancer `helm upgrade` sur chaque chart à tour de rôle, une opération qui modifiait à la fois l’infrastructure et la configuration de l’application en une seule étape.

Dans la version 3.0, la mise à niveau de l’application est dissociée des changements d’infrastructure :

| Step                                      | 2.7                                              | 3.0                                                                                        |
| ----------------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------ |
| Déclencher une mise à niveau              | Relancer le conteneur d’installation Ansible     | Installer les nouvelles versions correspondantes de l’opérateur et des charts Vantage      |
| Appliquer les modifications par composant | Ansible exécute `helm upgrade` pour chaque chart | L’opérateur génère des manifestes ArgoCD `Application` ; ArgoCD réconcilie automatiquement |

Le modèle d’installation de la version 2.7 n’est pas pris en charge dans la version 3.0, et il n’existe pas de mise à niveau directe depuis la version 2.7. Le passage depuis la version 2.7 est une migration ; voir [Migrer depuis Vantage 2.7](/fr/vantage/self-hosted/v3.0/migration-from-2.7). Les mises à niveau des charts Vantage couvrent uniquement Vantage Core : les logiciels que vous avez installés séparément, comme votre pile de supervision, doivent être mis à niveau par vos soins, selon votre propre calendrier.

<div id="whats-next">
  ## Prochaines étapes
</div>

<CardGroup cols={2}>
  <Card title="Architecture" icon="diagram-project" href="/fr/vantage/self-hosted/v3.0/architecture">
    Ce que l’opérateur fait à chaque cycle de réconciliation.
  </Card>

  <Card title="Limites connues" icon="triangle-exclamation" href="/fr/vantage/self-hosted/v3.0/known-limitations">
    Contraintes à prendre en compte avant de planifier une fenêtre de mise à niveau.
  </Card>
</CardGroup>