> ## 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.

# Referencia de la API

> Referencia de campos para el recurso personalizado de Vantage `vantage.abbyy.com/v1alpha1`, que rige las instalaciones autoalojadas de Vantage 3.0.

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](/es/vantage/self-hosted/v3.0/architecture). Para ver el procedimiento de instalación, elija [Azure](/es/vantage/self-hosted/v3.0/providers/azure) o [Kubernetes autogestionado](/es/vantage/self-hosted/v3.0/providers/self-managed).

<div id="api-group">
  ## Grupo de la API
</div>

| Grupo               | Versión    | Recurso   |
| ------------------- | ---------- | --------- |
| `vantage.abbyy.com` | `v1alpha1` | `Vantage` |

<div id="vantage">
  ## Vantage
</div>

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.

| Field        | Type     | Required | Description                                                                                     |
| ------------ | -------- | -------- | ----------------------------------------------------------------------------------------------- |
| `apiVersion` | `string` | Sí       | vantage.abbyy.com/v1alpha1                                                                      |
| `kind`       | `string` | Sí       | Vantage                                                                                         |
| `metadata`   | `object` | Sí       | Consulte la documentación de la API de Kubernetes para conocer los campos del campo `metadata`. |
| `spec`       | `object` | Sí       | spec define el estado deseado de Vantage. Consulte [`Vantage.spec`](#vantagespec).              |
| `status`     | `object` | No       | status define el estado observado de Vantage. Consulte [`Vantage.status`](#vantagestatus).      |

<div id="vantagespec">
  ## Vantage.spec
</div>

spec define el estado deseado de Vantage

| Campo                | Tipo      | Obligatorio | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| -------------------- | --------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `databaseProvider`   | `string`  | No          | Motor de base de datos utilizado por los servicios de Vantage. Los valores aceptados son `SqlServer` y `PostgreSQL`; el valor distingue entre mayúsculas y minúsculas. Predeterminado: `SqlServer`.                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `dnsRecord`          | `string`  | Sí          | dnsRecord es el registro DNS de la instalación de Vantage. Formato: `hostname`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `mailFrom`           | `string`  | Sí          | mailFrom es la dirección de correo electrónico utilizada como remitente para los correos salientes. Formato: `email`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `platformAdminEmail` | `string`  | Sí          | platformAdminEmail es la dirección de correo electrónico del administrador de la plataforma. Formato: `email`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `secrets`            | `object`  | Sí          | secrets selecciona y configura el proveedor de secretos. Se debe especificar exactamente un proveedor. Consulte [`secrets`](#vantagespecsecrets).                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `updatePolicy`       | `object`  | Sí          | updatePolicy controla cómo el operador gestiona las actualizaciones de Vantage. Use `manual: {}`; las actualizaciones automáticas aún no son compatibles. Consulte [`updatePolicy`](#vantagespecupdatepolicy).                                                                                                                                                                                                                                                                                                                                                                                                      |
| `vantageVersion`     | `string`  | Sí          | vantageVersion es la versión de Vantage que se va a instalar.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `workloads`          | `object`  | Sí          | workloads configura el ConfigMap que contiene datos sobre charts e imágenes. Consulte [`workloads`](#vantagespecworkloads).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `idReadingEnabled`   | `boolean` | No          | idReadingEnabled habilita las funciones de lectura de ID. Predeterminado: `false`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `keda`               | `object`  | No          | keda configura el escalado automático basado en KEDA. Consulte [`keda`](#vantagespeckeda).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `ociMigration`       | `object`  | No          | 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. Consulte [`ociMigration`](#vantagespecocimigration).                                                                                                                                                                                                                                                                                                                  |
| `reportingEnabled`   | `boolean` | No          | reportingEnabled habilita las funciones de informes de SQL Server. Debe permanecer en `false` cuando `databaseProvider` es `PostgreSQL`. Predeterminado: `false`.                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `serviceAccountName` | `string`  | No          | serviceAccountName es el nombre de la ServiceAccount que se utilizará para las cargas de trabajo de Vantage. Omítalo para usar la ServiceAccount predeterminada. Predeterminado: `default`. La descarga de imágenes para las cargas de trabajo de Vantage se configura aquí: agregue el Secret de extracción de su registro a `imagePullSecrets` de esta ServiceAccount. Consulte [acceso de extracción de imágenes en 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). |
| `smtp`               | `object`  | No          | smtp configura el servidor de correo SMTP. Si no se especifica, SendGrid se usa como proveedor de correo. Consulte [`smtp`](#vantagespecsmtp).                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `storage`            | `object`  | No          | storage configura opciones avanzadas de almacenamiento. De forma predeterminada, usa Azure Blob (mediante los alias `storage*ConnectionString`) cuando se omite. Consulte [`storage`](#vantagespecstorage).                                                                                                                                                                                                                                                                                                                                                                                                         |
| `techcore`           | `object`  | No          | techcore contiene la configuración del motor de procesamiento TechCore. Consulte [`techcore`](#vantagespectechcore).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |

<Note>
  **Validación de `secrets`**: `has(self.kubernetes) != has(self.azure)`: se debe especificar exactamente un proveedor.
</Note>

<Warning>
  **Validación de `updatePolicy`**: `!has(self.auto)`: las actualizaciones automáticas aún no son compatibles.
</Warning>

<Note>
  **Validación de `updatePolicy`**: `(has(self.auto) ? 1 : 0) + (has(self.manual) ? 1 : 0) == 1`: se debe especificar exactamente una directiva de actualización.
</Note>

<Note>
  **Validación de `ociMigration`**: `!has(self.enabled) || self.enabled == false || has(self.destination)`: destination es obligatorio cuando ociMigration está habilitado.
</Note>

<Warning>
  **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`.
</Warning>

<Note>
  **Validación de `techcore`**: `!self.keepPreviousVersion || has(self.previousVersion)`: previousVersion es obligatorio cuando keepPreviousVersion es true.
</Note>

<div id="vantagespeckeda">
  ## Vantage.spec.keda
</div>

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.

| Field     | Tipo      | Obligatorio | Descripción                                                                                                   |
| --------- | --------- | ----------- | ------------------------------------------------------------------------------------------------------------- |
| `enabled` | `boolean` | No          | Habilita los recursos `ScaledObject` de KEDA para las cargas de trabajo compatibles. Predeterminado: `false`. |

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](/es/vantage/self-hosted/v3.0/performance/autoscaling).

<div id="vantagespecsmtp">
  ## Vantage.spec.smtp
</div>

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

| Campo      | Tipo      | Obligatorio | Descripción                                                                    |
| ---------- | --------- | ----------- | ------------------------------------------------------------------------------ |
| `host`     | `string`  | Sí          | host es el nombre de host del servidor SMTP                                    |
| `login`    | `string`  | No          | login para la autenticación SMTP                                               |
| `password` | `string`  | No          | contraseña para la autenticación SMTP                                          |
| `port`     | `integer` | No          | port es el puerto del servidor SMTP. Predeterminado: `587` · Formato: `int32`. |
| `useSSL`   | `boolean` | No          | useSSL habilita TLS para las conexiones SMTP. Predeterminado: `false`.         |

<div id="vantagespecworkloads">
  ## Vantage.spec.workloads
</div>

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

| Campo                 | Tipo     | Obligatorio | Descripción                                                                                                             |
| --------------------- | -------- | ----------- | ----------------------------------------------------------------------------------------------------------------------- |
| `configMap`           | `string` | Sí          | configMap es el nombre del ConfigMap que contiene los datos de las cargas de trabajo                                    |
| `metadataTemplateKey` | `string` | Sí          | metadataTemplateKey es la clave del ConfigMap que contiene la plantilla de metadatos sobre la instalación de los charts |
| `secretsKey`          | `string` | Sí          | secretsKey es la clave del ConfigMap que contiene los metadatos de los secrets                                          |
| `workloadsKey`        | `string` | Sí          | workloadsKey es la clave del ConfigMap que contiene la lista de charts e imágenes                                       |

<div id="vantagespecsecrets">
  ## Vantage.spec.secrets
</div>

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](/es/vantage/self-hosted/v3.0/secrets-and-keyvault) para ver el modelo conceptual y la lista completa de alias.

| Field        | Tipo     | Obligatorio | Descripción                                                                                                                                          |
| ------------ | -------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `azure`      | `object` | No          | azure configura los secretos mediante Azure Key Vault y el controlador Secrets Store CSI. Consulte [`azure`](#vantagespecsecretsazure).              |
| `kubernetes` | `object` | No          | kubernetes usa recursos `Secret` de Kubernetes ya existentes en el namespace de instalación. Consulte [`kubernetes`](#vantagespecsecretskubernetes). |

<div id="vantagespecsecretsazure">
  ## Vantage.spec.secrets.azure
</div>

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

| Campo                    | Tipo                | Obligatorio | Descripción                                                                                                                                                                                                                                                                                                                 |
| ------------------------ | ------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `keyVaultName`           | `string`            | Sí          | `keyVaultName` es el Azure Key Vault que contiene los secretos.                                                                                                                                                                                                                                                             |
| `tenantId`               | `string`            | Sí          | `tenantId` es el tenant de Azure AD propietario del Key Vault.                                                                                                                                                                                                                                                              |
| `clientId`               | `string`            | No          | `clientId` es el ID de cliente de Azure AD de la identidad administrada asignada por el usuario que tiene acceso de lectura a Key Vault. Es obligatorio cuando `identityMode` es `workloadIdentity` (el valor predeterminado).                                                                                              |
| `identityMode`           | `enum`              | No          | `identityMode` selecciona cómo se autentica el controlador CSI ante Azure. Predeterminado: `workloadIdentity` · Enum: `workloadIdentity, podIdentity, vmManagedIdentity`.                                                                                                                                                   |
| `objects`                | `map[string]object` | No          | `objects` anula opcionalmente la asignación entre un alias de secreto y un objeto específico de Key Vault. Cuando un alias no está presente en este mapa, el propio alias se usa como nombre del objeto de Key Vault y el objeto se obtiene como tipo `secret`. Consulte [`objects`](#vantagespecsecretsazureobjectsalias). |
| `userAssignedIdentityID` | `string`            | No          | `userAssignedIdentityID` es el ID de cliente de la identidad administrada asignada por el usuario que debe usarse cuando `identityMode` es `vmManagedIdentity`.                                                                                                                                                             |

<div id="vantagespecsecretsazureobjectsalias">
  ## Vantage.spec.secrets.azure.objects\[alias]
</div>

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

| Field           | Type     | Required | Description                                                                                                               |
| --------------- | -------- | -------- | ------------------------------------------------------------------------------------------------------------------------- |
| `objectName`    | `string` | Sí       | objectName es el nombre del objeto en Azure Key Vault.                                                                    |
| `objectType`    | `enum`   | No       | objectType es el tipo de objeto de Key Vault. Predeterminado: `secret` · Enum: `secret, key, cert`.                       |
| `objectVersion` | `string` | No       | objectVersion fija una versión concreta del objeto de Key Vault. De forma predeterminada, se usa la versión más reciente. |

<div id="vantagespecsecretskubernetes">
  ## Vantage.spec.secrets.kubernetes
</div>

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

| Campo     | Tipo                | Obligatorio | Descripción                                                                                                                                                                                                                                         |
| --------- | ------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `objects` | `map[string]object` | No          | `objects` define los secretos de Kubernetes que se usan y asocia los alias de secretos con nombres de `Secret`. Si no se define, se usarán los nombres de secreto predeterminados. Consulte [`objects`](#vantagespecsecretskubernetesobjectsalias). |

<div id="vantagespecsecretskubernetesobjectsalias">
  ## Vantage.spec.secrets.kubernetes.objects\[alias]
</div>

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

| Campo        | Tipo     | Obligatorio | Descripción                                                                        |
| ------------ | -------- | ----------- | ---------------------------------------------------------------------------------- |
| `secretName` | `string` | Sí          | secretName es el nombre del `Secret` de Kubernetes en el namespace de instalación. |

<div id="vantagespecstorage">
  ## Vantage.spec.storage
</div>

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](/es/vantage/self-hosted/v3.0/secrets-and-keyvault#storage).

| Field    | Tipo     | Requerido | Descripción                                                                                                  |
| -------- | -------- | --------- | ------------------------------------------------------------------------------------------------------------ |
| `custom` | `object` | No        | custom configura un backend de almacenamiento personalizado. Consulte [`custom`](#vantagespecstoragecustom). |

<div id="vantagespecstoragecustom">
  ## Vantage.spec.storage.custom
</div>

`custom` configura un backend de almacenamiento personalizado (respaldado por PVC mediante una `StorageClass` de Kubernetes).

<Note>
  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.
</Note>

| Campo          | Tipo            | Obligatorio | Descripción                                                                                                                                          |
| -------------- | --------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `size`         | `int or string` | Sí          | `size` define el tamaño del PVC. Predeterminado: `300Gi`.                                                                                            |
| `storageClass` | `string`        | Sí          | `storageClass` define la clase de almacenamiento que se utilizará para que los PVC monten los volúmenes del backend de almacenamiento personalizado. |

<div id="vantagespecupdatepolicy">
  ## Vantage.spec.updatePolicy
</div>

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

| Campo    | Tipo     | Obligatorio | Descripción                                                                                                                                   |
| -------- | -------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `auto`   | `object` | No          | auto habilita las actualizaciones automáticas de versión. Aún no se ha implementado. Consulte [`auto`](#vantagespecupdatepolicyauto).         |
| `manual` | `object` | No          | manual deshabilita las actualizaciones automáticas. Las actualizaciones se realizan instalando una nueva versión del Helm chart del operador. |

<div id="vantagespecupdatepolicyauto">
  ## Vantage.spec.updatePolicy.auto
</div>

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

| Field        | Tipo     | Obligatorio | Descripción                                                                                    |
| ------------ | -------- | ----------- | ---------------------------------------------------------------------------------------------- |
| `releaseURL` | `string` | Sí          | releaseURL es la URL desde la que se obtiene el paquete de versión de Vantage. Formato: `uri`. |

<div id="vantagespecocimigration">
  ## Vantage.spec.ociMigration
</div>

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.

| Field                | Type              | Required | Description                                                                                                                                                                                                                                                                                           |
| -------------------- | ----------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `concurrency`        | `integer`         | Yes      | concurrency es la cantidad de artefactos que se copiarán en paralelo. Predeterminado: `5` · Mínimo: `1`.                                                                                                                                                                                              |
| `destination`        | `object`          | No       | destination es donde se copian los artefactos. Consulte [`destination`](#vantagespecocimigrationdestination).                                                                                                                                                                                         |
| `enabled`            | `boolean`         | No       | enabled habilita la migración de OCI. Predeterminado: `true`.                                                                                                                                                                                                                                         |
| `imagePullSecrets`   | `[]object`        | No       | imagePullSecrets es una lista opcional de referencias a secretos en el mismo namespace que se usarán para extraer la imagen del operador que se utiliza para ejecutar el trabajo de migración de OCI en este namespace. Consulte [`imagePullSecrets`](#vantagespecocimigrationimagepullsecretsindex). |
| `labels`             | `map[string]JSON` | No       | labels es el conjunto de etiquetas que deben aplicarse al trabajo de migración de OCI y a la plantilla del pod. Los valores que no sean de tipo cadena se convertirán en cadenas con \[fmt.Sprint]                                                                                                    |
| `serviceAccountName` | `string`          | No       | serviceAccountName es el nombre de la ServiceAccount que se usará para ejecutar el trabajo de migración de OCI. Agregue el pull secret de su registro a `imagePullSecrets` de esta ServiceAccount para dar al trabajo acceso para extraer imágenes.                                                   |
| `sources`            | `[]object`        | No       | sources son credenciales para acceder a los registros desde los que se copian los artefactos (el registro de origen distribuido por ABBYY). Longitud máxima: 20. Consulte [`sources`](#vantagespecocimigrationsourcesindex).                                                                          |

<Note>
  **Validación de `destination`**: !self.host.contains('/'): el host no debe contener una ruta; use el campo repository para la ruta del registro
</Note>

<Note>
  **Validación de `destination`**: !self.host.contains('://'): el host no debe incluir un esquema (por ejemplo, https\://)
</Note>

<Note>
  **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](/es/vantage/self-hosted/v3.0/providers/azure#image-pull-access) y [Connect ArgoCD to your OCI registry](/es/vantage/self-hosted/v3.0/providers/azure#connect-argocd-to-your-oci-registry).
</Note>

<div id="vantagespecocimigrationdestination">
  ## Vantage.spec.ociMigration.destination
</div>

destination es el lugar al que se copian los artefactos.

| Campo              | Tipo     | Obligatorio | Descripción                                                                                                                                                                                                                                                                                           |
| ------------------ | -------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `host`             | `string` | Sí          | host es el nombre de host del registro y, opcionalmente, el puerto (p. ej., registry.example.com, registry.example.com:5000)                                                                                                                                                                          |
| `credentialsRef`   | `object` | No          | credentialsRef hace referencia a un Secret que contiene las claves de nombre de usuario y contraseña, o a un Secret de tipo kubernetes.io/dockerconfigjson. Tiene prioridad sobre username/password si se especifica. Consulte [`credentialsRef`](#vantagespecocimigrationdestinationcredentialsref). |
| `password`         | `string` | No          | contraseña para la autenticación del registro (texto sin formato; use credentialsRef en producción)                                                                                                                                                                                                   |
| `repository`       | `string` | No          | repository es la ruta o el espacio de nombres del registro para los artefactos (p. ej., `my-registry-namespace`, `vantage/images`).                                                                                                                                                                   |
| `username`         | `string` | No          | nombre de usuario para la autenticación del registro (texto sin formato; use credentialsRef en producción)                                                                                                                                                                                            |
| `workloadIdentity` | `object` | No          | workloadIdentity define la configuración para usar la identidad de la carga de trabajo (service account de Kubernetes) para acceder al registro. Consulte [`workloadIdentity`](#vantagespecocimigrationdestinationworkloadidentity).                                                                  |

<div id="vantagespecocimigrationdestinationcredentialsref">
  ## Vantage.spec.ociMigration.destination.credentialsRef
</div>

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.

| Campo  | Tipo     | Obligatorio | Descripción                  |
| ------ | -------- | ----------- | ---------------------------- |
| `name` | `string` | Sí          | name es el nombre del Secret |

<div id="vantagespecocimigrationdestinationworkloadidentity">
  ## Vantage.spec.ociMigration.destination.workloadIdentity
</div>

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

| Campo           | Tipo     | Obligatorio | Descripción                                                                                                                       |
| --------------- | -------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `audience`      | `string` | No          | audience es el endpoint que debe usarse para intercambiar el token de la cuenta de servicio por un token de acceso de OAuth.      |
| `clientId`      | `string` | No          | clientId es el ID de cliente que debe usarse para intercambiar el token de la cuenta de servicio por un token de acceso de OAuth. |
| `tokenEndpoint` | `string` | No          | tokenEndpoint es el endpoint que debe usarse para intercambiar el token de la cuenta de servicio por un token de acceso de OAuth. |

<div id="vantagespecocimigrationimagepullsecretsindex">
  ## Vantage.spec.ociMigration.imagePullSecrets\[index]
</div>

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

| Campo  | Tipo     | Obligatorio | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ------ | -------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name` | `string` | No          | Nombre del objeto al que se hace referencia. En la práctica, este campo es obligatorio, pero por compatibilidad con versiones anteriores se permite que esté vacío. Las instancias de este tipo con un valor vacío aquí casi con toda seguridad son incorrectas. Más información: [https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names](https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names) |

<div id="vantagespecocimigrationsourcesindex">
  ## Vantage.spec.ociMigration.sources\[index]
</div>

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

| Campo              | Tipo     | Requerido | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ------------------ | -------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `host`             | `string` | Sí        | host es el nombre de host del registro, con un puerto opcional (p. ej., registry.example.com, registry.example.com:5000)                                                                                                                                                                                                                                                                                                         |
| `credentialsRef`   | `object` | No        | credentialsRef hace referencia a un Secret que contiene las claves username y password o a un Secret de tipo kubernetes.io/dockerconfigjson. Tiene prioridad sobre username/password si se especifica. Hacer referencia aquí a un pull secret es la alternativa a ejecutar el trabajo de migración con una ServiceAccount que lleve el secreto. Consulte [`credentialsRef`](#vantagespecocimigrationsourcesindexcredentialsref). |
| `password`         | `string` | No        | contraseña para la autenticación del registro (texto sin formato; use credentialsRef en producción)                                                                                                                                                                                                                                                                                                                              |
| `repository`       | `string` | No        | repository es la ruta/namespace del registro para artefactos (p. ej., `my-registry-namespace`, `vantage/images`).                                                                                                                                                                                                                                                                                                                |
| `username`         | `string` | No        | nombre de usuario para la autenticación del registro (texto sin formato; use credentialsRef en producción)                                                                                                                                                                                                                                                                                                                       |
| `workloadIdentity` | `object` | No        | workloadIdentity define la configuración para usar la identidad de la carga de trabajo (cuenta de servicio de Kubernetes) para acceder al registro. Consulte [`workloadIdentity`](#vantagespecocimigrationsourcesindexworkloadidentity).                                                                                                                                                                                         |

<div id="vantagespecocimigrationsourcesindexcredentialsref">
  ## Vantage.spec.ociMigration.sources\[index].credentialsRef
</div>

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.

| Campo  | Tipo     | Obligatorio | Descripción                  |
| ------ | -------- | ----------- | ---------------------------- |
| `name` | `string` | Sí          | name es el nombre del Secret |

<div id="vantagespecocimigrationsourcesindexworkloadidentity">
  ## Vantage.spec.ociMigration.sources\[index].workloadIdentity
</div>

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

| Campo           | Tipo     | Requerido | Descripción                                                                                                                    |
| --------------- | -------- | --------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `audience`      | `string` | No        | audience es el endpoint que debe usarse para intercambiar el token de la cuenta de servicio por un token de acceso OAuth.      |
| `clientId`      | `string` | No        | clientId es el Client ID que debe usarse para intercambiar el token de la cuenta de servicio por un token de acceso OAuth.     |
| `tokenEndpoint` | `string` | No        | tokenEndpoint es el endpoint que debe usarse para intercambiar el token de la cuenta de servicio por un token de acceso OAuth. |

<div id="vantagespectechcore">
  ## Vantage.spec.techcore
</div>

techcore contiene la configuración del motor de procesamiento TechCore

| Field                 | Tipo      | Obligatorio | Descripción                                                                                                                                          |
| --------------------- | --------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `version`             | `integer` | Sí          | version es la versión de TechCore que se va a desplegar (p. ej., 4). Mínimo: `1`.                                                                    |
| `keepPreviousVersion` | `boolean` | No          | keepPreviousVersion conserva la versión anterior durante las actualizaciones. Predeterminado: `false`.                                               |
| `nnTrainingWorkers`   | `object`  | No          | nnTrainingWorkers configura los workers de entrenamiento de redes neuronales. Consulte [`nnTrainingWorkers`](#vantagespectechcorenntrainingworkers). |
| `previousVersion`     | `integer` | No          | previousVersion es la versión desde la que se realiza la actualización. Obligatorio cuando keepPreviousVersion es true. Mínimo: `1`.                 |

<div id="vantagespectechcorenntrainingworkers">
  ## Vantage.spec.techcore.nnTrainingWorkers
</div>

nnTrainingWorkers configura los workers de entrenamiento de redes neuronales

| Campo     | Tipo      | Obligatorio | Descripción                                                                                     |
| --------- | --------- | ----------- | ----------------------------------------------------------------------------------------------- |
| `enabled` | `boolean` | No          | `enabled` activa los workers de entrenamiento de redes neuronales. Predeterminado: `false`.     |
| `gpu`     | `boolean` | No          | `gpu` activa la aceleración por GPU para los workers de entrenamiento. Predeterminado: `false`. |

<div id="vantagestatus">
  ## Vantage.status
</div>

status define el estado observado de Vantage

| Campo                     | Tipo       | Obligatorio | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ------------------------- | ---------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `availableVersions`       | `[]string` | No          | availableVersions es la lista de versiones disponibles en la URL de la release.                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `conditions`              | `[]object` | No          | conditions representan el estado actual del recurso de Vantage. Cada condición tiene un tipo único y refleja el estado de un aspecto específico del recurso. Los tipos de condición estándar incluyen: - "Available": el recurso es totalmente funcional - "Progressing": el recurso se está creando o actualizando - "Degraded": el recurso no pudo alcanzar o mantener su estado deseado El estado de cada condición es True, False o Unknown. Consulte [`conditions`](#vantagestatusconditionsindex). |
| `degradationReasons`      | `[]object` | No          | degradationReasons representan los motivos del estado degradado de la instalación. Consulte [`degradationReasons`](#vantagestatusdegradationreasonsindex).                                                                                                                                                                                                                                                                                                                                               |
| `installedVantageVersion` | `string`   | No          | installedVantageVersion es la versión que se está ejecutando actualmente.                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `observedGeneration`      | `integer`  | No          | observedGeneration es la generación de la especificación que ha sido "procesada" por el controlador. Formato: `int64`.                                                                                                                                                                                                                                                                                                                                                                                   |

<Note>
  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](/es/vantage/self-hosted/v3.0/lifecycle#skill-installation-runs-separately) para ver los comandos de supervisión.
</Note>

<div id="vantagestatusconditionsindex">
  ## Vantage.status.conditions\[index]
</div>

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

| Campo                | Tipo      | Obligatorio | Descripción                                                                                                                                                                                                                                                                                                                                                     |
| -------------------- | --------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `lastTransitionTime` | `string`  | Sí          | lastTransitionTime es la última vez que la condición pasó de un estado a otro. Debe ser el momento en que cambió la condición subyacente. Si se desconoce, se acepta usar la hora en que cambió el campo de la API. Formato: `date-time`.                                                                                                                       |
| `message`            | `string`  | Sí          | message es un mensaje legible para humanos que indica detalles sobre la transición. Puede ser una cadena vacía.                                                                                                                                                                                                                                                 |
| `reason`             | `string`  | Sí          | reason contiene un identificador programático que indica el motivo de la última transición de la condición. Los productores de tipos de condición específicos pueden definir los valores y significados esperados para este campo, y si los valores se consideran una API garantizada. El valor debe ser una cadena CamelCase. Este campo no puede estar vacío. |
| `status`             | `enum`    | Sí          | estado de la condición; uno de True, False, Unknown. Enumeración: `True, False, Unknown`.                                                                                                                                                                                                                                                                       |
| `type`               | `string`  | Sí          | tipo de condición en CamelCase o en foo.example.com/CamelCase.                                                                                                                                                                                                                                                                                                  |
| `observedGeneration` | `integer` | No          | observedGeneration representa el valor de .metadata.generation en el que se basó la condición al establecerse. Por ejemplo, si .metadata.generation es actualmente 12, pero .status.conditions\[x].observedGeneration es 9, la condición está desactualizada con respecto al estado actual de la instancia. Formato: `int64` · Mínimo: `0`.                     |

<div id="vantagestatusdegradationreasonsindex">
  ## Vantage.status.degradationReasons\[index]
</div>

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

| Field       | Tipo     | Obligatorio | Descripción                                                                                                                                     |
| ----------- | -------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `component` | `string` | Sí          | component es la parte de la instalación que está degradada.                                                                                     |
| `message`   | `string` | Sí          | message es una descripción de la degradación del componente legible para las personas.                                                          |
| `reason`    | `string` | Sí          | reason contiene un identificador programático que indica el motivo de la degradación del componente. El valor debe ser una cadena en CamelCase. |
