Creación de infraestructura de Azure

Vantage 3.0 reemplaza este modelo de implementación. Vantage 2.7 y las versiones anteriores requerían la infraestructura especificada por ABBYY, creada mediante scripts de Ansible y Azure CLI proporcionados por ABBYY. Este modelo no es compatible con la versión 3.0: usted aprovisiona su propia infraestructura y ABBYY no proporciona scripts de aprovisionamiento ni ningún otro tipo de automatización de infraestructura. Esta página se aplica únicamente a Vantage 2.7. Consulte la descripción general de Vantage 3.0 y Migrar desde Vantage 2.7.

Esta página solo se aplica a implementaciones de Azure AKS. Para las implementaciones en máquinas virtuales, consulte la guía de Instalación.

Descripción general

Esta guía explica cómo crear la infraestructura de Azure necesaria para ABBYY Vantage mediante Azure CLI y plantillas ARM. La infraestructura se crea desde el contenedor del instalador de Vantage.

Requisitos previos

Antes de comenzar, asegúrese de contar con lo siguiente:

Una suscripción de Azure con permisos para crear y administrar recursos
Docker instalado en su equipo local
Acceso a Internet para descargar imágenes de contenedor
Para la configuración de alta disponibilidad: clúster de Redis implementado en máquinas virtuales (consulte Requisitos del sistema)

Puede comenzar a descargar imágenes de contenedor mientras crea la infraestructura, ya que es una operación que lleva tiempo.

Componentes de la infraestructura

Se crearán los siguientes recursos de Azure:

Azure Subscription
└── Resource Group
    ├── AKS Cluster
    │   ├── Services Node Pool (Standard_D8as_v5)
    │   └── Workers Node Pool (Standard_D16as_v5)
    ├── Storage Accounts (5)
    │   ├── Skills (Premium/Hot)
    │   ├── Processing (Standard/Hot)
    │   ├── Temporary (Standard/Hot)
    │   ├── Shared Folders (Premium FileStorage)
    │   └── Archive (Standard/Cool)
    ├── Azure SQL Server
    │   └── Elastic Pool Database
    └── Public IP Address

Step 1: Descargar la imagen del instalador

Primero, descargue la imagen del instalador de Vantage y súbala a su registro de contenedores.

# Iniciar sesión en el registro Docker de Vantage
docker login abyvtgonprm27.azurecr.io -u <username> -p <password>

# Descargar la imagen del instalador
docker pull abyvtgonprm27.azurecr.io/vantage-azure:2.7.1

# Etiquetar para su registro
docker tag abyvtgonprm27.azurecr.io/vantage-azure:2.7.1 \
  registry.yourdomain.tld/vantage/vantage-azure:2.7.1

# Publicar en su registro
docker push registry.yourdomain.tld/vantage/vantage-azure:2.7.1

Sustituya <username> y <password> por las credenciales proporcionadas durante la compra.

Step 2: Inicie el contenedor del instalador

Inicie el contenedor del instalador. Todos los comandos posteriores de esta guía se ejecutan dentro de este contenedor.

docker run -it registry.yourdomain.tld/vantage/vantage-azure:2.7.1

Paso 3: Iniciar sesión en Azure

En el contenedor, inicie sesión en su cuenta de Azure:

# Iniciar sesión en Azure (abre el navegador para la autenticación)
az login

# Establecer la suscripción
az account set --subscription <subscription_id>

Reemplaza <subscription_id> por el ID de tu suscripción de Azure.

Step 4: Crear grupo de recursos

Cree un grupo de recursos en la región de Azure que prefiera:

az group create --location <location> --resource-group <resource_group_name>

Ejemplo:

az group create --location eastus --resource-group vantage-prod-rg

Regiones comunes de Azure: eastus, eastus2, westus2, westeurope, northeurope

Paso 5: Crear un clúster de AKS

Obtener una vista previa de la implementación

Primero, comprueba qué recursos se crearán:

az deployment group what-if --name aks-cluster \
  --resource-group <resource_group_name> \
  --template-file files/infrastructure/azure/arms/Cluster.Manual.json \
  --parameters kubernetesClusterName=<cluster_name>

Los nombres de los clústeres no deben superar los 15 caracteres.

Crear el clúster

az deployment group create --name aks-cluster \
  --resource-group <resource_group_name> \
  --template-file files/infrastructure/azure/arms/Cluster.Manual.json \
  --parameters kubernetesClusterName=<cluster_name> \
  --parameters enableFIPS=false

Este comando crea un clúster con la configuración Without high availability, capaz de procesar 50.000 páginas cada 8 horas. Para otras configuraciones, modifique la configuración del pool de nodos mediante la Performance Guide después de crear el clúster.

Para implementaciones que cumplan con FIPS, establezca enableFIPS=true. Consulte FIPS Compliance para obtener información adicional sobre la configuración.

Step 6: Crear cuentas de almacenamiento

Obtener una vista previa de la implementación

az deployment group what-if --name storage \
  --resource-group <resource_group_name> \
  --template-file files/infrastructure/azure/arms/StorageAccounts.Template.json

Crear cuentas de almacenamiento

az deployment group create --name storage \
  --resource-group <resource_group_name> \
  --template-file files/infrastructure/azure/arms/StorageAccounts.Template.json \
  --parameters kubernetesClusterName=<cluster_name> \
  --parameters enableFIPS=false

Recuperar las claves de la cuenta de almacenamiento

Obtén las claves de acceso y las claves secretas para rellenar la sección s3storage en env_specific.yml:

az deployment group show --name storage \
  --resource-group <resource_group_name> \
  --query properties.outputs -o yaml

Guarda el resultado; necesitarás estos valores para el archivo de configuración env_specific.yml.

Step 7: Crear Azure SQL Server

Obtenga una vista previa de la implementación

az deployment group what-if --name dbservers \
  --resource-group <resource_group_name> \
  --template-file files/infrastructure/azure/arms/Databases/DB.Server.Template.json \
  --parameters serverBaseName=<cluster_name> \
  --parameters dbAdminLogin=<db_username> \
  --parameters dbAdminPassword=<db_password>

Crear un servidor SQL

az deployment group create --name dbservers \
  --resource-group <resource_group_name> \
  --template-file files/infrastructure/azure/arms/Databases/DB.Server.Template.json \
  --parameters serverBaseName=<cluster_name> \
  --parameters dbAdminLogin=<db_username> \
  --parameters dbAdminPassword=<db_password>

Los parámetros dbAdminLogin y dbAdminPassword son las credenciales que se usan para acceder a las bases de datos. Guárdalos para la configuración de env_specific.yml.

Paso 8: Crear la base de datos SQL de Azure

Vista previa de la implementación

az deployment group what-if --name databases \
  --resource-group <resource_group_name> \
  --template-file files/infrastructure/azure/arms/Databases/SQL.Databases.Template.json \
  --parameters serverBaseName=<cluster_name>

Crear la base de datos

az deployment group create --name databases \
  --resource-group <resource_group_name> \
  --template-file files/infrastructure/azure/arms/Databases/SQL.Databases.Template.json \
  --parameters serverBaseName=<cluster_name>

Step 9: Obtener el grupo de recursos del nodo

Obtenga el nombre del grupo de recursos del nodo del clúster de AKS:

az aks show --name <cluster_name> -g <resource_group_name> \
  --query nodeResourceGroup -o tsv

Guarda este valor: colocarás la dirección IP pública en este grupo de recursos.

Step 10: Configurar la dirección IP pública

Cree una IP pública de Azure (IPv4 estática estándar) en el grupo de recursos de nodos del Step 9, o mueva una IP pública existente a ese grupo de recursos.
Anote la dirección IP para la configuración de env_specific.yml:
loadbalancer: external_ip: <your_public_ip_address>
Cree un registro A de DNS que apunte su dominio a esta dirección IP.

Paso 11: Instalar el controlador de GPU (opcional)

Si planea implementar workers de GPU para entrenar skills con Deep Learning:

ansible-playbook -i inventories/azure -v \
  playbooks/infrastructure/azure/02_install_gpu_driver.yml

Para conocer los requisitos de implementación con GPU, consulte Requisitos del sistema.

Resumen de los recursos creados

Después de completar estos pasos, tendrá:

Recurso	Propósito
Grupo de recursos	Contenedor para todos los recursos de Vantage
Clúster de AKS	Clúster de Kubernetes para ejecutar Vantage
Pool de nodos de servicios	Ejecuta los servicios de la plataforma Vantage
Pool de nodos worker	Ejecuta los workers de procesamiento de documentos
Cuenta de almacenamiento de Skills	Almacena definiciones y configuraciones de skills
Cuenta de almacenamiento de procesamiento	Almacena documentos durante el procesamiento
Cuenta de almacenamiento temporal	Almacenamiento temporal de transacciones
Cuenta de almacenamiento de carpetas compartidas	Acceso a la carpeta compartida para importación/exportación
Cuenta de almacenamiento de archivo	Archivo de documentos a largo plazo
Azure SQL Server	Servidor de base de datos
Base de datos SQL de Azure	Base de datos operativa de Vantage
Dirección IP pública	Acceso externo a Vantage

Siguientes pasos

Después de crear la infraestructura:

Configure env_specific.yml - Rellénelo con los valores de esta guía. Consulte Instalación para ver el formato completo de la configuración.
Descargue imágenes de contenedor - Sincronice las imágenes de Vantage con su registro de contenedores.
Ejecute la instalación - Complete la instalación con los playbooks.

Continúe con Instalación para ver el proceso de instalación completo.

Resolución de problemas

La implementación falla por un error de permisos

Asegúrate de que tu cuenta de Azure tenga los siguientes permisos:

Acceso de Colaborador a la suscripción o al grupo de recursos
Permiso para crear clústeres de AKS, cuentas de almacenamiento y bases de datos SQL

Nombre del clúster demasiado largo

Los nombres de los clústeres deben tener 15 caracteres o menos. Usa un nombre más corto.

El nombre de la cuenta de almacenamiento ya existe

Los nombres de las cuentas de Azure Storage deben ser únicos en todo el mundo. La plantilla de ARM genera los nombres en función del nombre de tu clúster. Si hay algún conflicto, prueba con un nombre de clúster distinto.

No se puede conectar a la base de datos SQL

Asegúrese de que las reglas de firewall de la base de datos SQL de Azure permitan conexiones desde las direcciones IP salientes del clúster de AKS. Es posible que deba agregar una regla de red virtual o permitir el acceso a los servicios de Azure.

Requisitos del sistema - Requisitos completos de infraestructura
Instalación - Guía completa de instalación
Cumplimiento de FIPS - Implementaciones con FIPS habilitado
Guía de rendimiento - Escalado y optimización del rendimiento

​Descripción general

​Requisitos previos

​Componentes de la infraestructura

​Step 1: Descargar la imagen del instalador

​Step 2: Inicie el contenedor del instalador

​Paso 3: Iniciar sesión en Azure

​Step 4: Crear grupo de recursos

​Paso 5: Crear un clúster de AKS

​Obtener una vista previa de la implementación

​Crear el clúster

​Step 6: Crear cuentas de almacenamiento

​Obtener una vista previa de la implementación

​Crear cuentas de almacenamiento

​Recuperar las claves de la cuenta de almacenamiento

​Step 7: Crear Azure SQL Server

​Obtenga una vista previa de la implementación

​Crear un servidor SQL

​Paso 8: Crear la base de datos SQL de Azure

​Vista previa de la implementación

​Crear la base de datos

​Step 9: Obtener el grupo de recursos del nodo

​Step 10: Configurar la dirección IP pública

​Paso 11: Instalar el controlador de GPU (opcional)

​Resumen de los recursos creados

​Siguientes pasos

​Resolución de problemas

​La implementación falla por un error de permisos

​Nombre del clúster demasiado largo

​El nombre de la cuenta de almacenamiento ya existe

​No se puede conectar a la base de datos SQL

​Documentación relacionada

Descripción general

Requisitos previos

Componentes de la infraestructura

Step 1: Descargar la imagen del instalador

Step 2: Inicie el contenedor del instalador

Paso 3: Iniciar sesión en Azure

Step 4: Crear grupo de recursos

Paso 5: Crear un clúster de AKS

Obtener una vista previa de la implementación

Crear el clúster

Step 6: Crear cuentas de almacenamiento

Obtener una vista previa de la implementación

Crear cuentas de almacenamiento

Recuperar las claves de la cuenta de almacenamiento

Step 7: Crear Azure SQL Server

Obtenga una vista previa de la implementación

Crear un servidor SQL

Paso 8: Crear la base de datos SQL de Azure

Vista previa de la implementación

Crear la base de datos

Step 9: Obtener el grupo de recursos del nodo

Step 10: Configurar la dirección IP pública

Paso 11: Instalar el controlador de GPU (opcional)

Resumen de los recursos creados

Siguientes pasos

Resolución de problemas

La implementación falla por un error de permisos

Nombre del clúster demasiado largo

El nombre de la cuenta de almacenamiento ya existe

No se puede conectar a la base de datos SQL

Documentación relacionada