Azure Infrastructure Creation - ABBYY Documentation

Vantage 3.0 remplace ce modèle de déploiement. Vantage 2.7 et les versions antérieures nécessitaient l’infrastructure spécifiée par ABBYY, créée à l’aide des scripts Ansible et Azure CLI fournis par ABBYY. Ce modèle n’est pas pris en charge dans la version 3.0 : vous provisionnez votre propre infrastructure, et ABBYY ne fournit pas de scripts de provisionnement ni d’autre outil d’automatisation de l’infrastructure. Cette page s’applique uniquement à Vantage 2.7. Voir la Vue d’ensemble de Vantage 3.0 et Migrer depuis Vantage 2.7.

Cette page s’applique uniquement aux déploiements Azure AKS. Pour les déploiements sur machine virtuelle, consultez le guide Installation.

Vue d’ensemble

Ce guide vous explique comment créer l’infrastructure Azure requise pour ABBYY Vantage à l’aide d’Azure CLI et de modèles ARM. Cette infrastructure est créée depuis le conteneur d’installation de Vantage.

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

Un abonnement Azure avec les autorisations nécessaires pour créer et gérer des ressources
Docker installé sur votre machine locale
Un accès à Internet pour télécharger les images de conteneurs
Pour une configuration en haute disponibilité : un cluster Redis déployé sur des VM (voir Exigences système)

Vous pouvez commencer à télécharger les images de conteneurs pendant la création de l’infrastructure, car il s’agit d’une opération longue.

Composants de l’infrastructure

Les ressources Azure suivantes seront créées :

Azure Subscription
└── groupe de ressources
    ├── cluster AKS
    │   ├── pool de nœuds de services (Standard_D8as_v5)
    │   └── pool de nœuds de workers (Standard_D16as_v5)
    ├── comptes de stockage (5)
    │   ├── Skills (Premium/Hot)
    │   ├── Processing (Standard/Hot)
    │   ├── Temporary (Standard/Hot)
    │   ├── Shared Folders (Premium FileStorage)
    │   └── Archive (Standard/Cool)
    ├── serveur Azure SQL
    │   └── Elastic Pool Database
    └── adresse IP publique

Étape 1 : Télécharger l’image du programme d’installation

Commencez par télécharger l’image du programme d’installation de Vantage et la charger dans votre registre de conteneurs.

# Connexion au registre Docker Vantage
docker login abyvtgonprm27.azurecr.io -u <username> -p <password>

# Télécharger l'image de l'installateur
docker pull abyvtgonprm27.azurecr.io/vantage-azure:2.7.1

# Tagger pour votre registre
docker tag abyvtgonprm27.azurecr.io/vantage-azure:2.7.1 \
  registry.yourdomain.tld/vantage/vantage-azure:2.7.1

# Pousser vers votre registre
docker push registry.yourdomain.tld/vantage/vantage-azure:2.7.1

Remplacez <username> et <password> par les identifiants fournis lors de l’achat.

Étape 2 : Lancer le conteneur d’installation

Démarrez le conteneur d’installation. Toutes les commandes suivantes de ce guide s’exécutent dans ce conteneur.

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

Étape 3 : Se connecter à Azure

À l’intérieur du conteneur, connectez-vous à votre compte Azure :

# Connexion à Azure (ouvre le navigateur pour l'authentification)
az login

# Définir l'abonnement
az account set --subscription <subscription_id>

Remplacez <subscription_id> par votre ID d’abonnement Azure.

Étape 4 : Créer un groupe de ressources

Créez un groupe de ressources dans la région Azure de votre choix :

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

Exemple :

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

Régions Azure courantes : eastus, eastus2, westus2, westeurope, northeurope

Étape 5 : Créer un cluster AKS

Aperçu du déploiement

Commencez par vérifier quelles ressources seront créées :

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>

Les noms de cluster ne doivent pas comporter plus de 15 caractères.

Créer le cluster

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

Cette commande crée un cluster dans la configuration sans haute disponibilité, capable de traiter 50 000 pages sur une période de 8 heures. Pour les autres configurations, modifiez les paramètres du pool de nœuds à l’aide du Performance Guide après la création du cluster.

Pour les déploiements conformes à la norme FIPS, définissez enableFIPS=true. Consultez FIPS Compliance pour plus d’informations sur la configuration.

Étape 6 : Créer des comptes de stockage

Vérifier le déploiement

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

Créer des comptes de stockage

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

Récupérer les clés du compte de stockage

Récupérez les clés d’accès et les clés secrètes pour renseigner la section s3storage dans env_specific.yml :

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

Enregistrez ces résultats : vous aurez besoin de ces valeurs pour le fichier de configuration env_specific.yml.

Étape 7 : Créer le serveur Azure SQL

Afficher un aperçu du déploiement

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>

Créer un serveur 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>

Les paramètres dbAdminLogin et dbAdminPassword sont les identifiants utilisés pour accéder aux bases de données. Conservez-les pour la configuration env_specific.yml.

Étape 8 : Créer une base de données Azure SQL

Prévisualiser le déploiement

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>

Créer une base de données

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>

Étape 9 : Obtenir le groupe de ressources des nœuds

Récupérez le nom du groupe de ressources des nœuds du cluster AKS :

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

Conservez cette valeur : vous placerez l’adresse IP publique dans ce groupe de ressources.

Étape 10 : Configurer l’adresse IP publique

Créez une adresse IP publique Azure (IPv4 statique standard) dans le groupe de ressources des nœuds de l’étape 9, ou déplacez une adresse IP publique existante vers ce groupe de ressources.

Notez l’adresse IP pour la configuration env_specific.yml :

loadbalancer:
  external_ip: <your_public_ip_address>

Créez un enregistrement DNS de type A faisant pointer votre domaine vers cette adresse IP.

Étape 11 : Installer le pilote GPU (facultatif)

Si vous prévoyez de déployer des workers GPU pour entraîner des Skills avec Deep Learning :

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

Pour les exigences relatives au déploiement sur GPU, voir Exigences système.

Résumé des ressources créées

Après avoir terminé ces étapes, vous disposerez de :

Ressource	Objectif
Groupe de ressources	Conteneur de toutes les ressources Vantage
cluster AKS	Cluster Kubernetes pour exécuter Vantage
Pool de nœuds de services	Exécute les services de la plateforme Vantage
Pool de nœuds de workers	Exécute les workers de traitement des documents
Compte de stockage des Skills	Stocke les définitions et les configurations des Skills
Compte de stockage Processing	Stocke les documents pendant leur traitement
Compte de stockage temporaire	Stockage temporaire des transactions
Compte de stockage des dossiers partagés	Accès au dossier partagé d’import/export
Compte de stockage d’archivage	Archive des documents à long terme
serveur Azure SQL	Serveur de base de données
base de données Azure SQL	Base de données opérationnelle de Vantage
adresse IP publique	Accès externe à Vantage

Étapes suivantes

Après avoir créé l’infrastructure :

Configurer env_specific.yml - Renseignez-le avec les valeurs indiquées dans ce guide. Consultez Installation pour le format de configuration complet.
Télécharger les images de conteneurs - Synchronisez les images Vantage avec votre registre de conteneurs.
Exécuter l’installation - Terminez l’installation à l’aide des playbooks.

Poursuivez avec Installation pour obtenir la procédure d’installation complète.

Dépannage

Échec du déploiement en raison d’une erreur d’autorisation

Assurez-vous que votre compte Azure dispose des autorisations suivantes :

Accès Contributeur à l’abonnement ou au groupe de ressources
Autorisation de créer des clusters AKS, des comptes de stockage et des bases de données SQL

Nom du cluster trop long

Les noms de cluster doivent contenir 15 caractères maximum. Utilisez un nom plus court.

Le nom du compte de stockage est déjà utilisé

Les noms de comptes de stockage Azure doivent être uniques à l’échelle mondiale. Le modèle ARM génère des noms à partir du nom de votre cluster. En cas de conflit, essayez un autre nom de cluster.

Impossible de se connecter à la base de données SQL

Assurez-vous que les règles du pare-feu de la base de données Azure SQL autorisent les connexions à partir des adresses IP sortantes du cluster AKS. Vous devrez peut-être ajouter une règle de réseau virtuel ou autoriser les services Azure.

Exigences système - Exigences complètes de l’infrastructure
Installation - Guide d’installation complet
Conformité à la norme FIPS - Déploiements avec le mode FIPS activé
Guide des performances - Scalabilité et optimisation des performances

​Vue d’ensemble

​Prérequis

​Composants de l’infrastructure

​Étape 1 : Télécharger l’image du programme d’installation

​Étape 2 : Lancer le conteneur d’installation

​Étape 3 : Se connecter à Azure

​Étape 4 : Créer un groupe de ressources

​Étape 5 : Créer un cluster AKS

​Aperçu du déploiement

​Créer le cluster

​Étape 6 : Créer des comptes de stockage

​Vérifier le déploiement

​Créer des comptes de stockage

​Récupérer les clés du compte de stockage

​Étape 7 : Créer le serveur Azure SQL

​Afficher un aperçu du déploiement

​Créer un serveur SQL

​Étape 8 : Créer une base de données Azure SQL

​Prévisualiser le déploiement

​Créer une base de données

​Étape 9 : Obtenir le groupe de ressources des nœuds

​Étape 10 : Configurer l’adresse IP publique

​Étape 11 : Installer le pilote GPU (facultatif)

​Résumé des ressources créées

​Étapes suivantes

​Dépannage

​Échec du déploiement en raison d’une erreur d’autorisation

​Nom du cluster trop long

​Le nom du compte de stockage est déjà utilisé

​Impossible de se connecter à la base de données SQL

​Documentation connexe

Vue d’ensemble

Prérequis

Composants de l’infrastructure

Étape 1 : Télécharger l’image du programme d’installation

Étape 2 : Lancer le conteneur d’installation

Étape 3 : Se connecter à Azure

Étape 4 : Créer un groupe de ressources

Étape 5 : Créer un cluster AKS

Aperçu du déploiement

Créer le cluster

Étape 6 : Créer des comptes de stockage

Vérifier le déploiement

Créer des comptes de stockage

Récupérer les clés du compte de stockage

Étape 7 : Créer le serveur Azure SQL

Afficher un aperçu du déploiement

Créer un serveur SQL

Étape 8 : Créer une base de données Azure SQL

Prévisualiser le déploiement

Créer une base de données

Étape 9 : Obtenir le groupe de ressources des nœuds

Étape 10 : Configurer l’adresse IP publique

Étape 11 : Installer le pilote GPU (facultatif)

Résumé des ressources créées

Étapes suivantes

Dépannage

Échec du déploiement en raison d’une erreur d’autorisation

Nom du cluster trop long

Le nom du compte de stockage est déjà utilisé

Impossible de se connecter à la base de données SQL

Documentation connexe