> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Valores de los charts de Helm
> Referencia de los valores expuestos por los charts de Helm `vantage-operator` y `vantage-selfhosted`.
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](/es/vantage/self-hosted/v3.0/api-reference). Para ver un procedimiento de instalación, elija [Azure](/es/vantage/self-hosted/v3.0/providers/azure) o [Self-Managed Kubernetes](/es/vantage/self-hosted/v3.0/providers/self-managed).
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](/es/vantage/self-hosted/v3.0/known-limitations#one-operator-instance-per-cluster).
### 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](#inspecting-available-values).
| Valor | Propósito |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `manager.replicas` | Número de réplicas del operador. Predeterminado `1`. |
| `manager.image.repository` / `tag` / `pullPolicy` | Imagen de contenedor del operador. `pullPolicy` usa `IfNotPresent` de forma predeterminada. |
| `manager.imagePullSecrets` | Secrets de extracción para la imagen del operador cuando su registro requiere autenticación; por ejemplo, `--set "manager.imagePullSecrets[0].name=my-pull-secret"`. Predeterminado `[]`. No es necesario en AKS cuando se concede `AcrPull` a la identidad de kubelet. Consulte [Acceso de extracción de imágenes](/es/vantage/self-hosted/v3.0/providers/azure#image-pull-access). |
| `manager.args` | Argumentos del contenedor. Predeterminado `[--leader-elect]` (elección de líder habilitada). |
| `manager.resources` | Solicitudes y límites de CPU/memoria. Valores predeterminados: solicitudes de `10m` de CPU / `64Mi` de memoria, límites de `500m` de CPU / `128Mi` de memoria. |
| `manager.affinity` / `manager.nodeSelector` / `manager.tolerations` | Controles estándar de planificación de Kubernetes para el pod del operador. Vacío de forma predeterminada. |
| `rbacHelpers.enable` | Instala roles auxiliares de administrador, editor y visor para los CRD de `vantage.abbyy.com`. Predeterminado `false`. |
| `crd.enable` | Instala los CRD con el chart. Predeterminado `true`. |
| `crd.keep` | Mantiene los CRD (y los recursos `Vantage` que definen) en el clúster cuando se desinstala el chart. Predeterminado `true`. |
| `metrics.enable` / `metrics.port` | Expone el endpoint `/metrics` protegido por RBAC. Valores predeterminados `true` / `8443`. |
| `certManager.enable` | Usa cert-manager para los certificados del webhook y del endpoint de métricas. Predeterminado `false`. |
| `prometheus.enable` | Crea un `ServiceMonitor` de Prometheus para el endpoint de métricas. Requiere prometheus-operator en el clúster. Predeterminado `false`. |
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](/es/vantage/self-hosted/v3.0/api-reference) 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
| Valor | Se asigna a | Notas |
| ------------------------------------------------------------------------------------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `operator.namespace` | N/A | Donde instaló `vantage-operator`. |
| `operator.controllerManagerServiceAccount` | N/A | `ServiceAccount` del controlador del operador que se vinculará al `ClusterRole` de lector de secretos en el namespace de esta versión de Vantage. Cámbielo solo si la instalación del operador usa un nombre distinto del predeterminado. |
| `ingress.tls.secretName` | N/A | Obligatorio cuando el `ingress` integrado de Istio está habilitado. Nombre del `Secret` `kubernetes.io/tls` existente en el namespace de la puerta de enlace de `ingress` externo de Istio. No se usa cuando `ingress.enabled` es `false`. |
| `vantage.dnsRecord` | `Vantage.spec.dnsRecord` | Nombre de host DNS en el que Vantage está accesible. |
| `vantage.mailFrom` | `Vantage.spec.mailFrom` | Remitente del correo saliente. |
| `vantage.platformAdminEmail` | `Vantage.spec.platformAdminEmail` | Administrador inicial de la plataforma. |
| `vantage.secrets.azure` o `vantage.secrets.kubernetes` | `Vantage.spec.secrets` | Se requiere exactamente un proveedor de secretos. Consulte [Secretos y Key Vault](/es/vantage/self-hosted/v3.0/secrets-and-keyvault). |
| `vantage.workloads.configMap` / `metadataTemplateKey` / `secretsKey` / `workloadsKey` | `Vantage.spec.workloads` | Apunta al `ConfigMap` que contiene los datos de las cargas de trabajo. El propio chart incluye y crea este `ConfigMap`. |
### Valores opcionales
| Valor | Propósito |
| ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `ingress.enabled` | Habilita el ingress integrado del chart. Establezca `false` cuando use Traefik u otro controlador de ingress administrado por el cliente. Valor predeterminado: `true`. |
| `vantage.databaseProvider` | Motor de base de datos para los servicios de Vantage. Valores aceptados: `SqlServer` (predeterminado) o `PostgreSQL`; distingue entre mayúsculas y minúsculas. |
| `vantage.secrets.azure.identityMode` | Uno de `workloadIdentity` (predeterminado), `podIdentity`, `vmManagedIdentity`. Consulte [Secretos y Key Vault](/es/vantage/self-hosted/v3.0/secrets-and-keyvault#azure-key-vault-provider). |
| `vantage.secrets.azure.userAssignedIdentityID` | Client ID de la UAMI que se usará cuando `identityMode` sea `vmManagedIdentity`. |
| `vantage.secrets.azure.objects` | Asignación de alias de secreto → `{objectName, objectType, objectVersion}` para objetos de Key Vault cuyos nombres no coinciden con el alias. |
| `vantage.secrets.kubernetes` | Usa recursos `Secret` de Kubernetes ya existentes en lugar de Azure Key Vault. La asignación opcional `objects` reemplaza los nombres de secreto predeterminados. |
| `vantage.smtp.host` / `port` / `login` / `password` | SMTP saliente. Solo se usa cuando se configura; SendGrid es el valor predeterminado. Se asigna a `Vantage.spec.smtp`. |
| `vantage.serviceAccountName` | `ServiceAccount` predeterminada para las cargas de trabajo de Vantage. Se asigna a `Vantage.spec.serviceAccountName`. Valor predeterminado: `default`. Para extraer imágenes con un pull Secret, agregue el Secret a `imagePullSecrets` de esta `ServiceAccount`. Consulte [Acceso de extracción de imágenes de Azure](/es/vantage/self-hosted/v3.0/providers/azure#image-pull-access) o [acceso al registro autogestionado](/es/vantage/self-hosted/v3.0/providers/self-managed#configure-registry-access). |
| `vantage.storage.custom.storageClass` / `size` | Usa un backend respaldado por `StorageClass` de Kubernetes en lugar de Azure Blob. Se asigna a `Vantage.spec.storage.custom`. |
| `vantage.idReadingEnabled` | Activa o desactiva las funciones de lectura de ID. Valor predeterminado: `false`. |
| `vantage.reportingEnabled` | Activa o desactiva las funciones de reporting de SQL Server. Valor predeterminado: `false`. Debe permanecer en `false` con PostgreSQL. |
| `vantage.ociMigration.enabled` | Ejecuta el trabajo de migración de OCI. Valor predeterminado: `true`. |
| `vantage.ociMigration.serviceAccountName` | `ServiceAccount` con la que se ejecuta el trabajo de migración de OCI. Se asigna a `Vantage.spec.ociMigration.serviceAccountName`. Para extraer la imagen del trabajo con un pull secret, agregue el secret a `imagePullSecrets` de esta `ServiceAccount`. |
| `vantage.ociMigration.sources[]` | Registros de origen desde los que se copian artefactos. El origen documentado es `sources[0].host=abbyy.jfrog.io` y `sources[0].repository=abbyy-docker`. Establezca `sources[].credentialsRef.name` en un `Secret` que contenga las credenciales del registro; esta es la alternativa a una `ServiceAccount` del trabajo de migración para la configuración de extracción. |
| `vantage.ociMigration.destination.host` / `repository` | Registro de destino al que se copian los artefactos. |
| `vantage.keda.enabled` | Configura si se usa [KEDA](https://keda.sh/) para el escalado automático de las cargas de trabajo de Vantage. Los charts actuales de cargas de trabajo de Vantage requieren KEDA 2.17.x. Consulte [Escalado automático con KEDA](/es/vantage/self-hosted/v3.0/performance/autoscaling). |
| `observability.prometheus.namespace` | Namespace que contiene Prometheus. Valor predeterminado: `observability`. Algunos escaladores automáticos de Vantage requieren el `Service` `prometheus-operated` en este namespace. |
| `observability.prometheus.serviceMonitor.create` | Crea el `ServiceMonitor` que recopila métricas de los endpoints `/metrics-text` de Vantage. Valor predeterminado: `false`. |
| `observability.prometheus.serviceMonitor.selectorMatchLabels` | Etiquetas requeridas para que su instancia de Prometheus seleccione el `ServiceMonitor` de Vantage. Valor predeterminado: `{}`. |
| `vantage.techcore.versions` | Versiones del motor TechCore. |
| `vantage.techcore.nnTrainingWorkers.enabled` / `gpu` | Workers de entrenamiento de redes neuronales. |
## 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:
```bash theme={null}
# vantage-operator
helm show values $charts_uri/vantage-operator --version $operator_version
# vantage-selfhosted
helm show values $chart_uri/vantage-selfhosted --version $selfhosted_version
```
`$charts_uri`, `$chart_uri` y las variables de versión siguen las convenciones de [Install variables](/es/vantage/self-hosted/v3.0/providers/azure#install-variables).
Para inspeccionar los manifiestos generados antes de aplicarlos:
```bash theme={null}
helm template $release_name $chart_uri/vantage-selfhosted \
--version $selfhosted_version \
--namespace $install_namespace \
-f my-values.yaml
```
## Configuración de operador vs Vantage
La configuración se divide claramente:
| Aspecto | Se define en | Justificación |
| ------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------ |
| Runtime de operador (réplicas, imagen, secretos de extracción, planificación, ciclo de vida de CRD, métricas) | Valores de Helm de `vantage-operator` | Ajustes operativos para administradores del clúster. |
| Aplicación de Vantage (secretos, SMTP, cargas de trabajo, almacenamiento, techcore) | Valores de Helm de `vantage-selfhosted` → `Vantage.spec` | El CRD es el contrato de la API; el chart es solo la forma de definirlo. |
## 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
| Pasada | Cuándo se ejecuta | charts considerados |
| ---------------- | ------------------------------------------------ | ------------------------------- |
| Versión actual | Siempre | `vtc-{version}-worker*` |
| Versión anterior | Cuando `spec.techcore.keepPreviousVersion: true` | `vtc-{previousVersion}-worker*` |
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
| Patrón del chart | Se incluye cuando |
| ---------------------------- | -------------------------------------------------------------------- |
| `worker-id-reading` | Nunca (excluido en todas las configuraciones) |
| `nn-extraction-training` | `nnTrainingWorkers.enabled: true` and `nnTrainingWorkers.gpu: false` |
| `nn-extraction-training-gpu` | `nnTrainingWorkers.enabled: true` and `nnTrainingWorkers.gpu: true` |
| `nn-nlp-model-train` | `nnTrainingWorkers.enabled: true` and `nnTrainingWorkers.gpu: false` |
| `nn-nlp-model-train-gpu` | `nnTrainingWorkers.enabled: true` and `nnTrainingWorkers.gpu: true` |
| Todos los demás workers | Siempre |
### Matriz de inclusión: pasada de la versión anterior
Solo se ejecuta cuando `spec.techcore.keepPreviousVersion: true`.
| Patrón de chart | Se incluye cuando |
| ------------------------------------- | ------------------------------------------------------------------- |
| `worker-id-reading` | Nunca |
| `nn-extraction-training*` (CPU y GPU) | Nunca (el entrenamiento de NN solo se ejecuta en la versión actual) |
| `nn-nlp-model-train*` (CPU y GPU) | Nunca (el entrenamiento de NN solo se ejecuta en la versión actual) |
| Todos los demás workers | Siempre |
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`](/es/vantage/self-hosted/v3.0/api-reference#vantagespec).
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 campo por campo del recurso personalizado `Vantage`.
Procedimiento de instalación que utiliza estos charts.
Instalación con ingress, mesh, secrets, almacenamiento y servicios de datos gestionados por el cliente.