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

# Descripción general

> Descripción general de la arquitectura de ABBYY Vantage 3.0 autoalojado: una implementación de la plataforma Vantage gestionada por un operador de Kubernetes y configurada de forma declarativa.

ABBYY Vantage 3.0 self-hosted es una implementación de la plataforma Vantage alojada en la infraestructura del cliente y basada en un operador de Kubernetes. Se declara un único recurso personalizado `Vantage` que describe la instalación que desea, y el operador se encarga de la instalación de Vantage Core: obtiene el conjunto de dependencias de Vantage Core, valida la configuración, copia los artefactos en su registry y reconcilia las release de Helm mediante ArgoCD.

<div id="why-a-new-installer">
  ## Por qué un nuevo instalador
</div>

Vantage 2.7 autoalojado requería la infraestructura exacta especificada por ABBYY, creada y configurada mediante playbooks de Ansible proporcionados por ABBYY y scripts de Azure CLI que se ejecutaban en un contenedor Docker. Ese modelo no es compatible con 3.0: usted aprovisiona su propia infraestructura, y pasar de 2.7 implica una instalación nueva más una migración de datos, no una actualización sobre la instalación existente. El instalador de 3.0 adopta patrones modernos de Kubernetes: un operador, un recurso personalizado declarativo y ArgoCD para la orquestación.

El resultado es que hay menos componentes que gestionar desde el primer día y actualizaciones más sencillas con el tiempo. Los clientes mantienen el operador y el recurso personalizado; a partir de ahí, el operador reconcilia las versiones de Vantage Core.

<Note>
  **Vantage 3.0 usa un modelo de implementación distinto al de 2.7 y versiones anteriores.** Las versiones anteriores requerían la infraestructura especificada exactamente por ABBYY, creada y configurada mediante scripts de Ansible y Azure CLI proporcionados por ABBYY. Ese modelo no es compatible con 3.0:

  * Usted aprovisiona su propia infraestructura: el clúster de Kubernetes, las bases de datos, las cuentas de almacenamiento y el Key Vault. ABBYY no proporciona scripts de aprovisionamiento, plantillas ni ningún otro tipo de automatización de infraestructura para 3.0.
  * El instalador implementa únicamente Vantage Core. El software de terceros del que depende Vantage, como ArgoCD, su service mesh y controlador de ingress, su integración con secrets y su pila de monitorización, lo instala y mantiene usted, normalmente mediante Helm.
  * Las configuraciones documentadas son escenarios que ABBYY ha probado. Puede adaptar su instalación basándose en los ejemplos documentados; validar cualquier adaptación es su responsabilidad.
</Note>

<div id="architecture-at-a-glance">
  ## Arquitectura de un vistazo
</div>

| Componente                    | Función                                                                                                                                                         |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Vantage operator**          | Operador de Kubernetes implementado mediante Helm. Supervisa el recurso personalizado `Vantage` y reconcilia el estado de la instalación.                       |
| **`Vantage` custom resource** | Especificación declarativa de la instalación (`vantage.abbyy.com/v1alpha1`). DNS, secrets, SMTP, cargas de trabajo.                                             |
| **ArgoCD**                    | Aplica y reconcilia los release de Helm de cada componente que conforman Vantage.                                                                               |
| **OCI migration job**         | Copia los artefactos de Vantage desde el registro de origen distribuido por ABBYY a su registro de destino antes de la instalación.                             |
| **Skill installer job**       | Instala skills de Vantage mediante un trabajo de Kubernetes independiente. ArgoCD no realiza su seguimiento.                                                    |
| **Secrets provider**          | Proporciona valores de la aplicación mediante Azure Key Vault y el controlador Secrets Store CSI, o mediante Secrets nativos de Kubernetes.                     |
| **malla de servicios**        | Proporciona mTLS para el tráfico de la aplicación de Vantage. Las guías de implementación compatibles usan Istio en AKS y Linkerd en Kubernetes autogestionado. |
| **Ingress controller**        | Finaliza el HTTPS público e implementa el contrato de enrutamiento por rutas y reescritura de Vantage.                                                          |

ABBYY suministra el Vantage operator, el OCI migration job y el Skill installer job. ArgoCD, la malla de servicios, el controlador de ingress, la integración de secrets y la pila de supervisión son requisitos previos de terceros que debe instalar y mantener antes de instalar Vantage.

Cuando el operador reconcilia un recurso `Vantage`, el proceso avanza por cinco fases:

1. **Preflight**: valida la configuración. Durante las comprobaciones previas, se valida la configuración de secrets.
2. **Secrets**: prepara el proveedor de secrets configurado. Con Azure Key Vault, el operador aprovisiona recursos `SecretProviderClass` y el controlador CSI proporciona los valores al iniciar el pod. Con el proveedor de Kubernetes, el operador valida los Secrets nativos que creó previamente en el namespace de instalación.
3. **OCI Migration**: ejecuta el trabajo de migración de OCI para copiar los artefactos a su registro de destino.
4. **Installation**: genera manifiestos de ArgoCD Application para cada componente y los aplica.
5. **Sync**: supervisa el estado de las aplicaciones de ArgoCD y lo informa al recurso personalizado `Vantage`.

La instalación de skills se ejecuta como un trabajo de Kubernetes independiente que ArgoCD no supervisa; Vantage se puede usar mientras el trabajo termina. Consulte [Lifecycle](/es/vantage/self-hosted/v3.0/lifecycle#skill-installation-runs-separately).

<div id="what-changes-from-vantage-27">
  ## Qué cambia con respecto a Vantage 2.7
</div>

| Aspecto                              | 2.7 autoalojado                                                                                           | 3.0 autoalojado                                                                                                                     |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Instalador                           | playbooks de Ansible en un contenedor Docker                                                              | operador de Kubernetes + ArgoCD                                                                                                     |
| Aprovisionamiento de infraestructura | scripts de Ansible y de Azure CLI proporcionados por ABBYY para la infraestructura especificada por ABBYY | Aprovisionada por usted; sin automatización proporcionada por ABBYY                                                                 |
| Configuración                        | archivo `env_specific.yaml`                                                                               | recurso personalizado `Vantage` declarativo                                                                                         |
| Destinos de implementación           | máquinas virtuales de Azure u on-premises                                                                 | AKS o Kubernetes autogestionado                                                                                                     |
| Malla de servicios                   | No se incluye en la instalación                                                                           | Istio en AKS o Linkerd en Kubernetes autogestionado, con mTLS en el tráfico de la aplicación                                        |
| Secretos                             | archivos YAML / variables de entorno                                                                      | almacén de claves en la nube mediante el controlador Secrets Store CSI, o recursos `Secret` de Kubernetes ya existentes             |
| Actualizaciones                      | Vuelva a ejecutar los scripts de instalación y los playbooks de Ansible proporcionados por ABBYY          | Actualice las versiones correspondientes del operador y los charts de Vantage; el operador reconcilia las versiones de Vantage Core |

<div id="where-to-go-next">
  ## Adónde ir después
</div>

<CardGroup cols={2}>
  <Card title="Requisitos previos" icon="list-check" href="/es/vantage/self-hosted/v3.0/prerequisites">
    Clúster, servicios, secrets y certificados que deben estar configurados antes de la instalación.
  </Card>

  <Card title="Arquitectura" icon="diagram-project" href="/es/vantage/self-hosted/v3.0/architecture">
    Cómo el operador usa el recurso personalizado `Vantage`.
  </Card>

  <Card title="Instalar en Azure" icon="cloud" href="/es/vantage/self-hosted/v3.0/providers/azure">
    Instalación paso a paso en AKS con Azure Key Vault.
  </Card>

  <Card title="Kubernetes autogestionado" icon="server" href="/es/vantage/self-hosted/v3.0/providers/self-managed">
    Instalación con ingress, mesh, secrets, almacenamiento y servicios de datos gestionados por el cliente.
  </Card>

  <Card title="Referencia de la API" icon="code" href="/es/vantage/self-hosted/v3.0/api-reference">
    Referencia de los campos del recurso personalizado `Vantage`.
  </Card>
</CardGroup>
