Saltar al contenido principal
El installer autoalojado de Vantage 3.0 se basa en un único custom resource de Kubernetes: un objeto Vantage del grupo de API vantage.abbyy.com/v1alpha1. Los campos siguientes constituyen el contrato completo entre usted y el operador. Para obtener una visión conceptual de cómo el operador utiliza este recurso, consulte Arquitectura. Para ver el procedimiento de instalación, elija Azure o Kubernetes autogestionado.

Grupo de la API

Vantage

El recurso Vantage de nivel superior. El chart vantage-selfhosted contiene una instancia de CR Vantage, creada en el namespace en el que instaló ese chart.

Vantage.spec

spec define el estado deseado de Vantage
Validación de secrets: has(self.kubernetes) != has(self.azure): se debe especificar exactamente un proveedor.
Validación de updatePolicy: !has(self.auto): las actualizaciones automáticas aún no son compatibles.
Validación de updatePolicy: (has(self.auto) ? 1 : 0) + (has(self.manual) ? 1 : 0) == 1: se debe especificar exactamente una directiva de actualización.
Validación de ociMigration: !has(self.enabled) || self.enabled == false || has(self.destination): destination es obligatorio cuando ociMigration está habilitado.
Validación de la base de datos y los informes: PostgreSQL se selecciona con el valor exacto PostgreSQL. Los informes están disponibles solo para SQL Server; el recurso se rechaza cuando databaseProvider es PostgreSQL y reportingEnabled es true.
Validación de techcore: !self.keepPreviousVersion || has(self.previousVersion): previousVersion es obligatorio cuando keepPreviousVersion es true.

Vantage.spec.keda

keda configura el escalado automático basado en KEDA para las cargas de trabajo de Vantage compatibles. Instale KEDA y el servicio de Prometheus requerido antes de habilitarlo. Los charts actuales de cargas de trabajo de Vantage requieren KEDA 2.17.x. Algunos recursos ScaledObject consultan http://prometheus-operated.observability.svc.cluster.local:9090; consulte Escalado automático con KEDA.

Vantage.spec.smtp

smtp configura el servidor de correo SMTP. Es una alternativa opcional a SendGrid; solo se usa cuando está configurado.

Vantage.spec.workloads

workloads configura el ConfigMap que contiene datos sobre charts e imágenes

Vantage.spec.secrets

secrets configura el proveedor de secretos que se utiliza para suministrar a las cargas de trabajo de Vantage los secretos de la aplicación (cadenas de conexión a la base de datos, claves de API y certificados). Debe especificarse exactamente un proveedor. Consulte Secretos y Key Vault para ver el modelo conceptual y la lista completa de alias.

Vantage.spec.secrets.azure

azure configura Azure Key Vault (mediante el controlador Secrets Store CSI) como fuente de secretos.

Vantage.spec.secrets.azure.objects[alias]

AzureSecretObjectConfig describe un único objeto de Key Vault que sirve de base para un alias de secreto.

Vantage.spec.secrets.kubernetes

kubernetes usa recursos Secret de Kubernetes ya existentes en el namespace de instalación.

Vantage.spec.secrets.kubernetes.objects[alias]

Cada entrada asocia un alias de secreto con un nombre de Secret de Kubernetes.

Vantage.spec.storage

storage configura las opciones avanzadas de almacenamiento. Si se omite, Vantage usa el backend predeterminado de Azure Blob y lee las cadenas de conexión de los alias de secret storage*ConnectionString. Consulte Secretos y Key Vault.

Vantage.spec.storage.custom

custom configura un backend de almacenamiento personalizado (respaldado por PVC mediante una StorageClass de Kubernetes).
La StorageClass de Kubernetes a la que se hace referencia ya debe estar configurada en el clúster antes de instalar Vantage con un backend de almacenamiento personalizado.

Vantage.spec.updatePolicy

updatePolicy controla cómo el operador gestiona las actualizaciones de Vantage.

Vantage.spec.updatePolicy.auto

auto habilita las actualizaciones automáticas de versión. Aún no se ha implementado.

Vantage.spec.ociMigration

ociMigration configura la copia de artefactos desde un registro de origen a un destino antes de la instalación. Omítalo por completo o establezca enabled=false para omitir la migración. Cuando está habilitado, destination es obligatorio.
Validación de destination: !self.host.contains(’/’): el host no debe contener una ruta; use el campo repository para la ruta del registro
Validación de destination: !self.host.contains(’://’): el host no debe incluir un esquema (por ejemplo, https://)
Acceso de extracción de imágenes para el trabajo de migración: ejecute el trabajo con una ServiceAccount que incluya su pull secret del registro (serviceAccountName), o haga referencia al secreto en la entrada de origen (sources[].credentialsRef.name). En Azure, conceder AcrPull a la identidad administrada de AKS es la alternativa más sencilla a los pull secrets. El acceso de ArgoCD a su registro se configura por separado, como una Connection de repositorio de ArgoCD. Consulte Image pull access y Connect ArgoCD to your OCI registry.

Vantage.spec.ociMigration.destination

destination es el lugar al que se copian los artefactos.

Vantage.spec.ociMigration.destination.credentialsRef

credentialsRef hace referencia a un Secret que contiene las claves de username y password, o a un Secret de tipo kubernetes.io/dockerconfigjson. Si se especifica, tiene prioridad sobre username/password.

Vantage.spec.ociMigration.destination.workloadIdentity

workloadIdentity define la configuración para usar la identidad de la carga de trabajo (cuenta de servicio de Kubernetes) para acceder al registro.

Vantage.spec.ociMigration.imagePullSecrets[index]

LocalObjectReference contiene información suficiente para localizar el objeto al que se hace referencia dentro del mismo namespace.

Vantage.spec.ociMigration.sources[index]

ContainerRegistryConfig define la configuración de conexión al registro de contenedores.

Vantage.spec.ociMigration.sources[index].credentialsRef

credentialsRef hace referencia a un Secret que contiene claves de nombre de usuario y contraseña, o a un Secret de tipo kubernetes.io/dockerconfigjson. Si se especifica, tiene prioridad sobre username/password.

Vantage.spec.ociMigration.sources[index].workloadIdentity

workloadIdentity define la configuración para usar la identidad de la carga de trabajo (cuenta de servicio de Kubernetes) para acceder al registro.

Vantage.spec.techcore

techcore contiene la configuración del motor de procesamiento TechCore

Vantage.spec.techcore.nnTrainingWorkers

nnTrainingWorkers configura los workers de entrenamiento de redes neuronales

Vantage.status

status define el estado observado de Vantage
La instalación de la skill se ejecuta como un trabajo de Kubernetes independiente que no se refleja en status.conditions[] ni se muestra a través de ArgoCD. Vantage puede utilizarse mientras el trabajo está en ejecución. Consulte Lifecycle para ver los comandos de supervisión.

Vantage.status.conditions[index]

Condition contiene detalles sobre un aspecto del estado actual de este recurso de la API.

Vantage.status.degradationReasons[index]

DegradationReason representa el motivo por el que un único componente de la instalación está degradado.