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

# Vue d’ensemble

> Vue d’ensemble de l’architecture d’ABBYY Vantage 3.0 en mode auto-hébergé : un déploiement de la plateforme Vantage piloté par un opérateur Kubernetes et configuré de façon déclarative.

ABBYY Vantage 3.0 auto-hébergé est un déploiement de la plateforme Vantage hébergé sur l’infrastructure du client, conçu autour d’un opérateur Kubernetes. Vous déclarez une seule ressource personnalisée `Vantage` qui décrit l’installation souhaitée, et l’opérateur se charge de l’installation de Vantage Core : récupération de l’ensemble des dépendances de Vantage Core, validation de la configuration, copie des artefacts dans votre registre et réconciliation des release Helm via ArgoCD.

<div id="why-a-new-installer">
  ## Pourquoi un nouveau programme d’installation
</div>

Vantage 2.7 auto-hébergé nécessitait l’infrastructure précisément spécifiée par ABBYY, créée et configurée à l’aide de playbooks Ansible et de scripts Azure CLI fournis par ABBYY, exécutés dans un conteneur Docker. Ce modèle n’est plus pris en charge dans la version 3.0 : vous provisionnez votre propre infrastructure, et le passage depuis la version 2.7 implique une nouvelle installation avec migration des données, et non une mise à niveau sur l’instance existante. Le programme d’installation 3.0 adopte des modèles Kubernetes modernes : un opérateur, une ressource personnalisée déclarative et ArgoCD pour l’orchestration.

Il en résulte moins de composants à gérer au départ et des mises à niveau plus simples au fil du temps. Les clients assurent la maintenance de l’opérateur et de la ressource personnalisée ; à partir de là, l’opérateur réconcilie automatiquement les versions de Vantage Core.

<Note>
  **Vantage 3.0 utilise un modèle de déploiement différent de celui de la version 2.7 et des versions antérieures.** Les versions précédentes nécessitaient l’infrastructure précisément spécifiée par ABBYY, créée et configurée à l’aide des scripts Ansible et Azure CLI fournis par ABBYY. Ce modèle n’est plus pris en charge dans la version 3.0 :

  * Vous provisionnez votre propre infrastructure : le cluster Kubernetes, les bases de données, les comptes de stockage et le Key Vault. ABBYY ne fournit pas de scripts de provisionnement, de modèles ni d’autre automatisation d’infrastructure pour la version 3.0.
  * L’installateur déploie uniquement Vantage Core. Les logiciels tiers dont Vantage dépend, tels qu’ArgoCD, votre maillage de services et votre contrôleur d’ingress, votre intégration des secrets et votre stack de monitoring, sont installés et maintenus par vos soins, généralement via Helm.
  * Les configurations documentées correspondent aux scénarios testés par ABBYY. Vous pouvez adapter votre installation à partir des exemples documentés ; la validation de cette adaptation relève de votre responsabilité.
</Note>

<div id="architecture-at-a-glance">
  ## Architecture en un coup d’œil
</div>

| Composant                             | Rôle                                                                                                                                                        |
| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Vantage operator**                  | Opérateur Kubernetes déployé via Helm. Surveille la ressource personnalisée `Vantage` et réconcilie automatiquement l’état de l’installation.               |
| **`Vantage` ressource personnalisée** | Spécification déclarative de l’installation (`vantage.abbyy.com/v1alpha1`). DNS, secrets, SMTP, charges de travail.                                         |
| **ArgoCD**                            | Applique et réconcilie automatiquement les releases Helm de chaque composant qui constituent Vantage.                                                       |
| **OCI migration job**                 | Copie les artefacts Vantage depuis le registre source distribué par ABBYY vers votre registre de destination avant l’installation.                          |
| **Skill installer job**               | Installe les Skills Vantage via un job Kubernetes distinct. N’est pas suivi par ArgoCD.                                                                     |
| **Secrets provider**                  | Fournit les valeurs de l’application via Azure Key Vault et le Secrets Store CSI driver, ou via les Secrets Kubernetes natifs.                              |
| **maillage de services**              | Fournit le mTLS pour le trafic applicatif de Vantage. Les guides de déploiement pris en charge utilisent Istio sur AKS et Linkerd sur Kubernetes auto-géré. |
| **Ingress controller**                | Termine le HTTPS public et met en œuvre les conventions Vantage de routage par chemin et de réécriture.                                                     |

ABBYY fournit le Vantage operator, l’OCI migration job et le Skill installer job. ArgoCD, le maillage de services, le contrôleur d’ingress, l’intégration des secrets et la pile de supervision sont des prérequis tiers que vous devez installer et maintenir avant d’installer Vantage.

Lorsque l’opérateur réconcilie une ressource `Vantage`, le processus se déroule en cinq phases :

1. **Preflight** : valide la configuration. Lors des vérifications preflight, la configuration des secrets est validée.
2. **Secrets** : prépare le provider de secrets configuré. Avec Azure Key Vault, l’opérateur provisionne des ressources `SecretProviderClass` et le pilote CSI fournit les valeurs au démarrage des pods. Avec le provider Kubernetes, l’opérateur valide les Secrets natifs que vous avez créés au préalable dans le namespace d’installation.
3. **OCI Migration** : exécute l’OCI migration job pour copier les artefacts dans votre registre de destination.
4. **Installation** : génère les manifestes d’Application ArgoCD pour chaque composant et les applique.
5. **Sync** : surveille l’état des applications ArgoCD et le remonte à la ressource personnalisée `Vantage`.

L’installation des Skills s’exécute dans un job Kubernetes distinct qui n’est pas suivi par ArgoCD ; Vantage reste utilisable pendant l’exécution de ce job. Voir [Lifecycle](/fr/vantage/self-hosted/v3.0/lifecycle#skill-installation-runs-separately).

<div id="what-changes-from-vantage-27">
  ## Ce qui change par rapport à Vantage 2.7
</div>

| Aspect                              | 2.7 auto-hébergé                                                                           | 3.0 auto-hébergé                                                                                                                                      |
| ----------------------------------- | ------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Programme d’installation            | playbooks Ansible dans un conteneur Docker                                                 | opérateur Kubernetes + ArgoCD                                                                                                                         |
| Provisionnement de l’infrastructure | scripts Ansible et Azure CLI fournis par ABBYY pour une infrastructure spécifiée par ABBYY | provisionnée par vous ; aucune automatisation fournie par ABBYY                                                                                       |
| Configuration                       | fichier `env_specific.yaml`                                                                | ressource personnalisée `Vantage` déclarative                                                                                                         |
| Cibles de déploiement               | machines virtuelles Azure ou on-premises                                                   | AKS ou Kubernetes autogéré                                                                                                                            |
| Maillage de services                | non inclus dans l’installation                                                             | Istio sur AKS ou Linkerd sur Kubernetes autogéré, avec mTLS pour le trafic applicatif                                                                 |
| Secrets                             | fichiers YAML / variables d’environnement                                                  | coffre de clés cloud via le Secrets Store CSI driver, ou ressources Kubernetes `Secret` préexistantes                                                 |
| Mises à jour                        | réexécution des scripts d’installation et des playbooks Ansible fournis par ABBYY          | mise à niveau des versions correspondantes de l’opérateur et des charts Vantage ; l’opérateur réconcilie automatiquement les versions de Vantage Core |

<div id="where-to-go-next">
  ## Étapes suivantes
</div>

<CardGroup cols={2}>
  <Card title="Prérequis" icon="list-check" href="/fr/vantage/self-hosted/v3.0/prerequisites">
    Cluster, services, secrets et certificats requis avant l’installation.
  </Card>

  <Card title="Architecture" icon="diagram-project" href="/fr/vantage/self-hosted/v3.0/architecture">
    Comment l’opérateur utilise la ressource personnalisée `Vantage`.
  </Card>

  <Card title="Installer sur Azure" icon="cloud" href="/fr/vantage/self-hosted/v3.0/providers/azure">
    Installation étape par étape sur AKS avec Azure Key Vault.
  </Card>

  <Card title="Kubernetes autogéré" icon="server" href="/fr/vantage/self-hosted/v3.0/providers/self-managed">
    Installation avec l’ingress, le maillage, les secrets, le stockage et les services de données gérés par le client.
  </Card>

  <Card title="Référence de l’API" icon="code" href="/fr/vantage/self-hosted/v3.0/api-reference">
    Référence champ par champ de la ressource personnalisée `Vantage`.
  </Card>
</CardGroup>
