Saltar al contenido principal
Vantage 3.0 autoalojado se distribuye en dos charts de Helm: vantage-operator (el controlador que supervisa el Vantage recurso personalizado) y vantage-selfhosted (el chart que crea el recurso Vantage y los manifiestos complementarios en el namespace de instalación que elija). Esta página contiene la referencia de valores de ambos. Para consultar los detalles del CRD a nivel de campo, consulte referencia de la API. Para ver un procedimiento de instalación, elija Azure o Self-Managed Kubernetes.
Instale versiones compatibles de vantage-operator y vantage-selfhosted. El procedimiento actual para entornos autogestionados usa la versión 0.70.13 para ambos charts.

​
vantage-operator

Se instala una vez por clúster, en el namespace que elija. El operador se encarga de reconciliar la instalación de Vantage definida por el recurso personalizado Vantage.
Instale exactamente una instancia por clúster. El chart usa nombres de recursos de ámbito de clúster y sin plantillas (manager-role ClusterRole, manager-rolebinding ClusterRoleBinding, controller-manager ServiceAccount). Una segunda instalación en el mismo clúster (incluso en un namespace diferente) entra en conflicto con estos recursos. Consulte Limitaciones conocidas.

​
Secciones de nivel superior

  • nameOverride / fullnameOverride: reemplazan parcial o totalmente el prefijo del nombre del recurso generado.
  • manager: la implementación del operador: replicas, image, args del contenedor (la elección de líder está habilitada de forma predeterminada), env (nombre del pod y namespace mediante la downward API), imagePullSecrets, contextos de seguridad del pod y del contenedor (non-root, sin escalado de privilegios, sistema de archivos raíz de solo lectura), resources y programación (affinity, nodeSelector, tolerations).
  • rbacHelpers: ClusterRoles opcionales de administrador, editor y visor para trabajar con los CRD de vantage.abbyy.com. Deshabilitado de forma predeterminada.
  • crd: ciclo de vida de los CRD: instala los CRD con el chart (enable) y los conserva al desinstalarlo (keep).
  • metrics: el endpoint /metrics protegido por RBAC.
  • certManager: integración con cert-manager para los certificados del webhook y del endpoint de métricas. Deshabilitado de forma predeterminada.
  • prometheus: un ServiceMonitor de Prometheus para el endpoint de métricas. Requiere prometheus-operator en el clúster. Deshabilitado de forma predeterminada.

​
Valores destacados

Los valores predeterminados reflejan el values.yaml generado por el chart para esta versión. El propio chart es la referencia canónica; consulte Inspeccionar los valores disponibles. El chart del operador no acepta ninguna configuración de la aplicación Vantage. La configuración de la aplicación reside por completo en el recurso personalizado Vantage, que crea el chart vantage-selfhosted.

​
vantage-selfhosted

Se instala una vez por cada instancia de Vantage, en el namespace que elija. Este chart contiene el recurso personalizado Vantage, un ConfigMap con los datos de las cargas de trabajo de Vantage y su RBAC asociado, así como los CRD y roles relacionados con Vantage procedentes del repositorio upstream de infraestructura de ABBYY. La mayoría de los valores se asignan directamente a campos del recurso personalizado Vantage. Consulte la referencia de la API para conocer el contrato de cada campo.

​
Bloques de nivel superior

  • operator: puntero a la instalación del operador (namespace y controllerManagerServiceAccount). El chart usa estos valores para vincular el ClusterRole lector de Secrets del operador en el namespace de la release de Vantage.
  • ingress: configuración integrada del ingress de Istio. Establece enabled: false si proporcionas otro controlador de ingress.
  • vantage: la carga útil de Vantage.spec: databaseProvider, dnsRecord, mailFrom, platformAdminEmail, secrets, vantageVersion, workloads, idReadingEnabled, keda, ociMigration, reportingEnabled, serviceAccountName, smtp, storage, techcore.
  • observability: configuración de ServiceMonitor de Prometheus generada por el chart. Este es un bloque de nivel superior, no un campo de Vantage.spec.

​
Valores obligatorios

​
Valores opcionales

​
Valores disponibles

El chart vantage-operator, incluido su archivo values.yaml, se genera mediante el complemento Helm de Kubebuilder; las plantillas del chart vantage-selfhosted se mantienen manualmente. En ambos casos, el chart publicado es la referencia canónica sobre lo que admite una versión determinada. Las tablas de esta página resumen una instantánea validada; cuando esta página y el chart no coincidan, tome como referencia el chart:
$charts_uri, $chart_uri y las variables de versión siguen las convenciones de Install variables. Para inspeccionar los manifiestos generados antes de aplicarlos:

​
Configuración de operador vs Vantage

La configuración se divide claramente:

​
Implementación de workers de TechCore

El chart vantage-selfhosted aplica un recurso personalizado Vantage; después, el operador implementa un subconjunto de los charts de workers de TechCore en función de spec.techcore.*. La selección se realiza en el operador, pero la siguiente matriz es la referencia definitiva; úsela para predecir qué workers se ejecutarán con una configuración determinada.

​
Convención de nomenclatura

Los charts de worker se nombran vtc-{version}-worker-{name}, donde {version} proviene de spec.techcore.version y {previousVersion} de spec.techcore.previousVersion. Los números de versión son simples prefijos de nombre; no tienen ningún significado semántico para el operador. El conjunto de workers disponibles proviene del ConfigMap de cargas de trabajo que ABBYY publica con cada release.

​
Dos pasadas de implementación

Configurar keepPreviousVersion: true mantiene en ejecución los workers de la versión anterior de TechCore junto con los nuevos, lo que resulta útil para actualizaciones graduales de TechCore. El CRD requiere que se establezca previousVersion cuando esta opción es true.

​
Matriz de inclusión: pasada de la versión actual

​
Matriz de inclusión: pasada de la versión anterior

Solo se ejecuta cuando spec.techcore.keepPreviousVersion: true.
La lectura de ID es una cuestión de plataforma, no de TechCore. El flag que la controla es spec.idReadingEnabled, que está fuera de spec.techcore. Consulte la referencia de Vantage.spec.
La matriz solo decide la inclusión dentro de los workers que existan en el ConfigMap de cargas de trabajo para la versión seleccionada. Los charts que no estén presentes en las cargas de trabajo de esa versión simplemente no están disponibles para desplegarse. Por ejemplo, worker-ocr-join hoy solo se incluye en el conjunto de cargas de trabajo de vtc-2, así que, incluso con keepPreviousVersion: true y previousVersion: 2, solo se despliega como vtc-2-worker-ocr-join.

​
Qué sigue

Referencia de la API

Referencia campo por campo del recurso personalizado Vantage.

Instalación en Azure

Procedimiento de instalación que utiliza estos charts.

Kubernetes autogestionado

Instalación con ingress, mesh, secrets, almacenamiento y servicios de datos gestionados por el cliente.