Erstellen der Azure-Infrastruktur

Vantage 3.0 ersetzt dieses Bereitstellungsmodell. Vantage 2.7 und frühere Versionen erforderten die von ABBYY vorgegebene Infrastruktur, die mithilfe von ABBYY bereitgestellten Ansible- und Azure-CLI-Skripten eingerichtet wurde. In 3.0 wird dieses Modell nicht unterstützt: Sie stellen Ihre eigene Infrastruktur bereit, und ABBYY stellt keine Provisionierungsskripte oder andere Automatisierung für die Infrastruktur bereit. Diese Seite gilt nur für Vantage 2.7. Siehe den Vantage 3.0 Überblick und Migration von Vantage 2.7.

Diese Seite gilt nur für Azure AKS-Bereitstellungen. Informationen zu Bereitstellungen auf virtuellen Maschinen finden Sie im Leitfaden Installation.

Übersicht

Diese Anleitung zeigt Ihnen, wie Sie die erforderliche Azure-Infrastruktur für ABBYY Vantage mithilfe der Azure CLI und von ARM-Vorlagen erstellen. Die Infrastruktur wird aus dem Vantage-Installer-Container heraus erstellt.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Folgendes vorhanden ist:

Ein Azure-Abonnement mit Berechtigungen zum Erstellen und Verwalten von Ressourcen
Docker ist auf Ihrem lokalen Computer installiert
Internetzugang zum Herunterladen von Container-Images
Für eine hochverfügbare Konfiguration: ein auf VMs bereitgestellter Redis-Cluster (siehe Systemanforderungen)

Sie können bereits mit dem Herunterladen der Container-Images beginnen, während Sie die Infrastruktur erstellen, da dies einige Zeit in Anspruch nimmt.

Infrastrukturkomponenten

Die folgenden Azure-Ressourcen werden erstellt:

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

Schritt 1: Laden Sie das Image des Installationsprogramms herunter

Laden Sie zunächst das Image des Vantage-Installationsprogramms herunter und übertragen Sie es in Ihre Container-Registry.

# Bei der Vantage Docker-Registry anmelden
docker login abyvtgonprm27.azurecr.io -u <username> -p <password>

# Installationsprogramm-Image herunterladen
docker pull abyvtgonprm27.azurecr.io/vantage-azure:2.7.1

# Für Ihre Registry taggen
docker tag abyvtgonprm27.azurecr.io/vantage-azure:2.7.1 \
  registry.yourdomain.tld/vantage/vantage-azure:2.7.1

# In Ihre Registry übertragen
docker push registry.yourdomain.tld/vantage/vantage-azure:2.7.1

Ersetzen Sie <username> und <password> durch die bei der Beschaffung bereitgestellten Anmeldedaten.

Schritt 2: Den Installer-Container ausführen

Starten Sie den Installer-Container. Alle weiteren Befehle in diesem Leitfaden werden in diesem Container ausgeführt.

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

Schritt 3: Bei Azure anmelden

Melden Sie sich im Container bei Ihrem Azure-Konto an:

# Bei Azure anmelden (öffnet Browser zur Authentifizierung)
az login

# Abonnement festlegen
az account set --subscription <subscription_id>

Ersetzen Sie <subscription_id> durch Ihre Azure-Abonnement-ID.

Schritt 4: Ressourcengruppe erstellen

Erstellen Sie eine Ressourcengruppe in der gewünschten Azure-Region:

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

Beispiel:

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

Häufige Azure-Regionen: eastus, eastus2, westus2, westeurope, northeurope

Schritt 5: AKS-Cluster erstellen

Bereitstellung in der Vorschau anzeigen

Prüfen Sie zunächst, welche Ressourcen erstellt werden:

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>

Clusternamen dürfen nicht länger als 15 Zeichen sein.

Cluster erstellen

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

Dieser Befehl erstellt einen Cluster in der Konfiguration Without high availability, der 50.000 Seiten innerhalb von 8 Stunden verarbeiten kann. Für andere Konfigurationen passen Sie die Einstellungen des Knotenpools nach der Clustererstellung mithilfe des Performance-Leitfadens an.

Für FIPS-konforme Deployments setzen Sie enableFIPS=true. Weitere Konfigurationshinweise finden Sie unter FIPS Compliance.

Schritt 6: Speicherkonten erstellen

Bereitstellung in der Vorschau anzeigen

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

Speicherkonten erstellen

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

Schlüssel für das Speicherkonto abrufen

Rufen Sie die Zugriffsschlüssel und Geheimschlüssel ab, um den Abschnitt s3storage in env_specific.yml auszufüllen:

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

Notieren Sie sich die Ausgabe – Sie benötigen diese Werte für die Konfigurationsdatei env_specific.yml.

Schritt 7: Azure SQL Server erstellen

Bereitstellung in der Vorschau anzeigen

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>

SQL Server erstellen

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>

Die Parameter dbAdminLogin und dbAdminPassword sind die Anmeldedaten für den Zugriff auf die Datenbanken. Speichern Sie diese für die Konfiguration in env_specific.yml.

Schritt 8: Azure SQL Database erstellen

Bereitstellung in der Vorschau anzeigen

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>

Datenbank erstellen

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>

Schritt 9: Knotenressourcengruppe abrufen

Rufen Sie den Namen der Knotenressourcengruppe für den AKS-Cluster ab:

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

Speichern Sie diesen Wert – Sie werden die öffentliche IP-Adresse in dieser Ressourcengruppe anlegen.

Schritt 10: Öffentliche IP-Adresse konfigurieren

Erstellen Sie eine öffentliche Azure-IP-Adresse (Standard Static IPv4) in der Knoten-Ressourcengruppe aus Schritt 9 oder verschieben Sie eine vorhandene öffentliche IP-Adresse in diese Ressourcengruppe.
Notieren Sie die IP-Adresse für die env_specific.yml-Konfiguration:
loadbalancer: external_ip: <your_public_ip_address>
Erstellen Sie einen DNS-A-Eintrag, der Ihre Domain auf diese IP-Adresse verweist.

Schritt 11: GPU-Treiber installieren (optional)

Wenn Sie GPU-Worker für das Training von Skills mit Deep Learning bereitstellen möchten:

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

Informationen zu den GPU-Anforderungen für die Bereitstellung finden Sie unter Systemanforderungen.

Zusammenfassung der erstellten Ressourcen

Nach Abschluss dieser Schritte verfügen Sie über:

Ressource	Zweck
Resource Group	Container für alle Vantage-Ressourcen
AKS Cluster	Kubernetes-Cluster für den Betrieb von Vantage
Services-Knotenpool	Führt die Vantage-Plattform-Services aus
Workers-Knotenpool	Führt Worker für die Dokumentenverarbeitung aus
Skills-Speicherkonto	Speichert Skill-Definitionen und -Konfigurationen
Speicherkonto für die Verarbeitung	Speichert Dokumente während der Verarbeitung
Temporäres Speicherkonto	Temporärer Speicher für Vorgänge
Speicherkonto für freigegebene Ordner	Zugriff auf freigegebene Ordner für Import/Export
Archiv-Speicherkonto	Langfristiges Dokumentenarchiv
Azure SQL Server	Datenbankserver
Azure SQL Database	Vantage-Betriebsdatenbank
Öffentliche IP-Adresse	Externer Zugriff auf Vantage

Nächste Schritte

Nach dem Erstellen der Infrastruktur:

env_specific.yml konfigurieren - Tragen Sie die Werte aus diesem Leitfaden ein. Das vollständige Konfigurationsformat finden Sie unter Installation.
Container-Images herunterladen - Synchronisieren Sie die Vantage-Images mit Ihrer Container Registry.
Installation ausführen - Schließen Sie die Installation mithilfe der Playbooks ab.

Fahren Sie mit Installation fort, um den vollständigen Installationsprozess abzuschließen.

Fehlerbehebung

Deployment schlägt mit einem Berechtigungsfehler fehl

Stellen Sie sicher, dass Ihr Azure-Konto über die folgenden Berechtigungen verfügt:

Contributor-Berechtigungen für das Abonnement oder die Ressourcengruppe
Berechtigung zum Erstellen von AKS-Clustern, Speicherkonten und SQL-Datenbanken

Clustername zu lang

Clusternamen dürfen höchstens 15 Zeichen lang sein. Verwenden Sie einen kürzeren Namen.

Der Name des Speicherkontos ist bereits vergeben

Namen von Azure-Speicherkonten müssen global eindeutig sein. Die ARM-Vorlage generiert Namen auf Grundlage Ihres Clusternamens. Wenn es zu einem Konflikt kommt, versuchen Sie es mit einem anderen Clusternamen.

Verbindung mit der SQL-Datenbank kann nicht hergestellt werden

Stellen Sie sicher, dass die Firewallregeln von Azure SQL Database Verbindungen von den ausgehenden IP-Adressen des AKS-Clusters zulassen. Möglicherweise müssen Sie eine Regel für ein virtuelles Netzwerk hinzufügen oder Azure-Dienste zulassen.

Systemanforderungen - Vollständige Anforderungen an die Infrastruktur
Installation - Vollständige Installationsanleitung
FIPS-Konformität - FIPS-aktivierte Deployments
Performance-Leitfaden - Skalierung und Leistungsoptimierung

​Übersicht

​Voraussetzungen

​Infrastrukturkomponenten

​Schritt 1: Laden Sie das Image des Installationsprogramms herunter

​Schritt 2: Den Installer-Container ausführen

​Schritt 3: Bei Azure anmelden

​Schritt 4: Ressourcengruppe erstellen

​Schritt 5: AKS-Cluster erstellen

​Bereitstellung in der Vorschau anzeigen

​Cluster erstellen

​Schritt 6: Speicherkonten erstellen

​Bereitstellung in der Vorschau anzeigen

​Speicherkonten erstellen

​Schlüssel für das Speicherkonto abrufen

​Schritt 7: Azure SQL Server erstellen

​Bereitstellung in der Vorschau anzeigen

​SQL Server erstellen

​Schritt 8: Azure SQL Database erstellen

​Bereitstellung in der Vorschau anzeigen

​Datenbank erstellen

​Schritt 9: Knotenressourcengruppe abrufen

​Schritt 10: Öffentliche IP-Adresse konfigurieren

​Schritt 11: GPU-Treiber installieren (optional)

​Zusammenfassung der erstellten Ressourcen

​Nächste Schritte

​Fehlerbehebung

​Deployment schlägt mit einem Berechtigungsfehler fehl

​Clustername zu lang

​Der Name des Speicherkontos ist bereits vergeben

​Verbindung mit der SQL-Datenbank kann nicht hergestellt werden

​Verwandte Dokumentation

Übersicht

Voraussetzungen

Infrastrukturkomponenten

Schritt 1: Laden Sie das Image des Installationsprogramms herunter

Schritt 2: Den Installer-Container ausführen

Schritt 3: Bei Azure anmelden

Schritt 4: Ressourcengruppe erstellen

Schritt 5: AKS-Cluster erstellen

Bereitstellung in der Vorschau anzeigen

Cluster erstellen

Schritt 6: Speicherkonten erstellen

Bereitstellung in der Vorschau anzeigen

Speicherkonten erstellen

Schlüssel für das Speicherkonto abrufen

Schritt 7: Azure SQL Server erstellen

Bereitstellung in der Vorschau anzeigen

SQL Server erstellen

Schritt 8: Azure SQL Database erstellen

Bereitstellung in der Vorschau anzeigen

Datenbank erstellen

Schritt 9: Knotenressourcengruppe abrufen

Schritt 10: Öffentliche IP-Adresse konfigurieren

Schritt 11: GPU-Treiber installieren (optional)

Zusammenfassung der erstellten Ressourcen

Nächste Schritte

Fehlerbehebung

Deployment schlägt mit einem Berechtigungsfehler fehl

Clustername zu lang

Der Name des Speicherkontos ist bereits vergeben

Verbindung mit der SQL-Datenbank kann nicht hergestellt werden

Verwandte Dokumentation