Vantage) et ArgoCD. Vous appliquez un objet Vantage qui décrit l’installation souhaitée ; l’opérateur réconcilie automatiquement l’état de l’installation avec la ressource, en déléguant à ArgoCD la synchronisation de chaque composant. Cette page présente ces différents éléments d’un point de vue conceptuel. Pour plus de détails au niveau des champs, consultez la référence API.
Pourquoi cette approche
- Infrastructure : provisionnée par vos soins, hors du périmètre de l’opérateur. ABBYY ne fournit pas d’automatisation du provisionnement pour la version 3.0.
- Application : décrite de manière déclarative dans la ressource
Vantage. L’opérateur gère la résolution des dépendances pour les composants Vantage Core, la migration des artefacts et la réconciliation via ArgoCD.
vantage-operator et vantage-selfhosted.
La ressource personnalisée Vantage
vantage.abbyy.com/v1alpha1. Une ressource minimale se présente ainsi (à titre d’illustration ; voir la référence API pour la spécification complète) :
spec.secrets est obligatoire, et un seul fournisseur (azure ou kubernetes) doit être spécifié. spec.smtp est facultatif ; omettez-le pour utiliser le fournisseur de messagerie SendGrid par défaut (fournissez une sendgridApiKey via votre fournisseur de secrets). Voir Secrets and Key Vault pour connaître les fournisseurs pris en charge.
En pratique, vous définissez la plupart de ces valeurs via le chart Helm vantage-selfhosted. Voir Azure ou Kubernetes autogéré.
Concepts clés
ConfigMap des charges de travail
spec.workloads indique à l’opérateur une ConfigMap contenant le manifeste des charts et des images qui composent une version de Vantage. L’opérateur lit ce manifeste, effectue la migration OCI pour copier les artefacts dans votre registre, puis génère des manifestes ArgoCD Application pour chaque composant. La ConfigMap est générée et publiée par ABBYY pour chaque version de Vantage.
Secrets et certificats
Secret préexistantes), et un seul est configuré pour chaque installation. Voir Secrets and Key Vault pour connaître les fournisseurs pris en charge, les modes d’identité et l’inventaire complet des alias.
Migration OCI
spec.ociMigration déclare un job ponctuel qui copie des artefacts depuis un ou plusieurs registres sources configurés vers votre registre de destination avant l’installation. Une fois la migration terminée, tous les téléchargements ultérieurs de composants se font depuis votre propre registre. ArgoCD récupère les charts des composants depuis ce registre via une connexion au dépôt que vous configurez vous-même. L’authentification du registre de destination prend en charge l’absence d’authentification, l’authentification basique ou Azure Workload Identity avec Azure RBAC. Les charges de travail doivent également disposer d’un accès de pull via des Secrets Kubernetes d’extraction d’images ou, sur Azure, de l’autorisation AcrPull accordée à l’identité managée AKS. Voir Accès de pull d’images Azure ou accès au registre autogéré.
Installation des Skills
Vantage peut indiquer l’état Ready alors que le job est toujours en cours d’exécution, et Vantage reste utilisable entre-temps. Les commandes de surveillance figurent dans Cycle de vie.
Contrat du Runtime
Vantage, les conditions qu’il renvoie et la manière de forcer une nouvelle tentative) est documenté séparément de cette présentation conceptuelle. Voir cycle de vie.
Pour la suite
Référence API
Référence détaillée de chaque propriété de spec et de status.
Cycle de vie
Phases de réconciliation, conditions de status et forçage d’une nouvelle tentative.
Valeurs du chart Helm
Référence de chaque valeur Helm acceptée par l’opérateur et les charts Vantage.
Dépannage
Diagnostic des problèmes courants liés à l’opérateur, à ArgoCD, aux secrets, à la base de données, à l’ingress et au maillage.