Saltar al contenido principal
Esta página describe el contrato de ejecución entre usted y el operador de Vantage: las fases por las que pasa el operador en cada reconciliación, las condiciones que publica en el recurso Vantage y cómo forzar un reintento. Para el esquema a nivel de campo, consulte referencia de la API. Para obtener una descripción general conceptual, consulte Arquitectura.

Fases de reconciliación

La reconciliación del operador se estructura en cinco fases secuenciales. Cada fase contiene validadores o pasos que deben completarse correctamente antes de que el operador avance a la siguiente fase. Un fallo en cualquier paso es fatal para la reconciliación y se refleja en status.degradationReasons[].

Condiciones de estado

El operador publica el estado de la instalación mediante tipos de condición en status.conditions[]:
  • Progressing: status es True mientras el proceso sigue en curso.
  • Ready: status es True cuando finaliza correctamente.
  • Degraded: status es True si se produce un error en cualquier momento. En este caso, status.degradationReasons[] contiene los detalles del error o de los errores.
Los procedimientos de instalación de Azure y autogestionada esperan a condition=Ready (kubectl wait --for=condition=Ready vantages.vantage.abbyy.com/$release_name). Ready no abarca la instalación de skill, que se ejecuta como un trabajo independiente (consulte más abajo), y también debe verificar las aplicaciones de ArgoCD generadas. Consulte la referencia de Vantage.status para ver el esquema de estado completo.

La instalación de skill se realiza por separado

Las Habilidades se instalan mediante un trabajo de Kubernetes independiente en el namespace de instalación, no mediante una aplicación de ArgoCD. El trabajo no aparece en ArgoCD ni se refleja en las condiciones anteriores, por lo que Ready no indica que la instalación de skill haya finalizado. Puede usar Vantage mientras el trabajo está en ejecución. Supervise el trabajo directamente:

Forzar un reintento

Para reintentar la instalación (por ejemplo, después de corregir un permiso de Key Vault), agregue una anotación al recurso Vantage con vantage.abbyy.com/reprocess (cualquier valor):
El recurso personalizado Vantage es mutable, pero para reintentar la instalación de Vantage, el CR de Vantage correspondiente debe llevar la anotación vantage.abbyy.com/reprocess (cualquier valor). Editar solo spec.* no vuelve a intentar una instalación fallida; después de corregir spec, aplique la anotación para desencadenar el reintento.

Qué sigue

Referencia de la API

Referencia campo por campo de todas las propiedades de especificación y estado.

Solución de problemas

Síntoma → diagnóstico → solución para fallos comunes al reconciliar.