Passer au contenu principal
Cette page décrit le contrat d’exécution entre vous et le opérateur Vantage : les phases que l’opérateur exécute à chaque réconciliation, les conditions qu’il publie sur la ressource Vantage et la manière de forcer une nouvelle tentative. Pour le schéma des champs, consultez la référence de l’API. Pour une vue d’ensemble conceptuelle, consultez Architecture.

​
Phases de réconciliation

La réconciliation de l’opérateur est structurée en cinq phases séquentielles. Chaque phase contient des validateurs ou des étapes qui doivent tous réussir avant que l’opérateur ne passe à la phase suivante. L’échec d’une seule étape est fatal à la réconciliation et apparaît dans status.degradationReasons[].

​
Conditions d’état

L’opérateur publie l’état de l’installation via des types de condition dans status.conditions[] :
  • Progressing : status vaut True tant que le processus est en cours.
  • Ready : status vaut True en cas de réussite.
  • Degraded : status vaut True si une erreur survient à un moment quelconque. Dans ce cas, status.degradationReasons[] contient les détails de la ou des erreurs.
Les procédures d’installation Azure et autogérées attendent condition=Ready (kubectl wait --for=condition=Ready vantages.vantage.abbyy.com/$release_name). Ready ne couvre pas l’installation des compétences, qui s’exécute dans le cadre d’un job distinct (voir ci-dessous), et vous devez également vérifier les applications ArgoCD générées. Consultez la référence Vantage.status pour le schéma d’état complet.

​
L’installation des compétences s’exécute séparément

Les compétences sont installées par un job Kubernetes distinct dans le namespace d’installation, et non par une application ArgoCD. Ce job n’apparaît pas dans ArgoCD et n’est pas pris en compte dans les conditions ci-dessus. Par conséquent, Ready n’indique pas que l’installation des compétences est terminée. Vous pouvez utiliser Vantage pendant l’exécution du job. Surveillez directement le job :

​
Forcer une nouvelle tentative

Pour relancer l’installation (par exemple, après avoir corrigé une autorisation dans Key Vault), annotez la ressource Vantage avec vantage.abbyy.com/reprocess (n’importe quelle valeur) :
La ressource personnalisée Vantage est modifiable, mais pour relancer l’installation de Vantage, la CR Vantage correspondante doit être annotée avec vantage.abbyy.com/reprocess (n’importe quelle valeur). Modifier uniquement spec.* ne relance pas une installation en échec ; après avoir corrigé la spécification, ajoutez l’annotation pour déclencher une nouvelle tentative.

​
Et ensuite

Référence de l’API

Référence champ par champ de toutes les propriétés spec et status.

Dépannage

Symptôme → diagnostic → correction des échecs de réconciliation courants.