Saltar al contenido principal
Vantage 3.0 autoalojado se basa en tres componentes: un operador de Kubernetes, un único recurso personalizado visible para el usuario (Vantage) y ArgoCD. Se aplica un objeto Vantage que describe la instalación deseada; el operador reconcilia el estado de la instalación para que coincida con el recurso y delega en ArgoCD la sincronización de cada componente. Esta página explica conceptualmente cómo encajan estos elementos. Para obtener detalles a nivel de campo, consulte la referencia de la API.

Por qué este patrón

Vantage 2.7 autoalojado se ejecutaba con playbooks de Ansible proporcionados por ABBYY y scripts de Azure CLI que instalaban tanto la aplicación como la infraestructura de soporte de una sola vez. Ese modelo no es compatible con la versión 3.0. El operador de 3.0 separa las responsabilidades:
  • Infraestructura: usted la aprovisiona fuera del alcance del operador. ABBYY no proporciona automatización del aprovisionamiento para 3.0.
  • Aplicación: descrita de forma declarativa en el recurso Vantage. El operador se encarga de la resolución de dependencias de los componentes de Vantage Core, la migración de artefactos y la reconciliación mediante ArgoCD.
El software de terceros del que depende Vantage, como ArgoCD, su service mesh y su controlador de ingress, su integración de secretos y su pila de monitorización, queda fuera de ambos ámbitos: debe instalarlo usted mismo antes de instalar Vantage. El resultado: las actualizaciones se realizan instalando nuevas versiones correspondientes de los Helm charts vantage-operator y vantage-selfhosted.

El recurso personalizado Vantage

La CRD está registrada en vantage.abbyy.com/v1alpha1. Un recurso mínimo se ve así (a modo ilustrativo; consulte la referencia de la API para consultar la especificación completa):
spec.secrets es obligatorio y se debe especificar exactamente un proveedor (azure o kubernetes). spec.smtp es opcional; omítalo para usar el proveedor de correo predeterminado de SendGrid (proporcione una sendgridApiKey mediante su proveedor de secretos). Consulte Secretos y Key Vault para ver los proveedores admitidos. En la práctica, la mayoría de estos valores se configuran mediante el Helm chart vantage-selfhosted. Consulte Azure o Kubernetes autogestionado.

Conceptos clave

ConfigMap de cargas de trabajo

spec.workloads indica al operador el ConfigMap que contiene el manifiesto de charts e imágenes que componen una versión de Vantage. El operador lee este manifiesto, ejecuta la migración de OCI para copiar los artefactos a su registro y luego genera manifiestos Application de ArgoCD para cada componente. ABBYY compila y publica el ConfigMap como parte de cada lanzamiento de Vantage.

Secretos y certificados

El operador no almacena secretos directamente. Se admiten dos proveedores de secretos (Azure Key Vault mediante el controlador Secrets Store CSI y recursos Secret de Kubernetes ya existentes), y solo se configura uno por instalación. Consulte Secretos y Key Vault para ver los proveedores admitidos, los modos de identidad y el inventario completo de alias.

Migración de OCI

spec.ociMigration declara un trabajo de una sola ejecución que copia artefactos desde uno o varios registros de origen configurados a su registro de destino antes de la instalación. Una vez completada la migración, todas las extracciones posteriores de componentes se realizan desde su propio registro. ArgoCD extrae los charts de los componentes de ese registro mediante una conexión de repositorio que usted mismo configura. La autenticación del destino admite sin autenticación, autenticación básica o Azure Workload Identity con Azure RBAC. Las cargas de trabajo también necesitan acceso de extracción mediante Secrets de extracción de imágenes de Kubernetes o, en Azure, AcrPull concedido a la identidad administrada de AKS. Consulte acceso de extracción de imágenes de Azure o acceso al registro autogestionado.

Instalación de skills

Los skills se instalan mediante un trabajo de Kubernetes independiente en el namespace de instalación, no mediante una de las aplicaciones de ArgoCD generadas por el operador, por lo que ArgoCD no muestra el progreso de la instalación de skills. El recurso Vantage puede indicar Ready mientras el trabajo sigue ejecutándose, y Vantage se puede usar mientras tanto. Los comandos de monitorización están en Ciclo de vida.

Contrato del Runtime

El contrato del Runtime del operador (cómo procesa el recurso Vantage, qué condiciones vuelve a publicar y cómo forzar un reintento) se documenta por separado de esta visión general conceptual. Consulte Lifecycle.

Qué sigue

Referencia de la API

Referencia campo por campo de cada propiedad de spec y status.

Ciclo de vida

Fases de reconciliación, condiciones de estado y cómo forzar un reintento.

Valores del Helm chart

Referencia de todos los valores de Helm que aceptan los charts del operador y de Vantage.

Solución de problemas

Diagnóstico de problemas comunes del operador, ArgoCD, secrets, base de datos, ingress y mesh.