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

# Erstellen der Azure-Infrastruktur

> Erstellen Sie Schritt für Schritt die für ABBYY Vantage selbstgehostet auf AKS erforderliche Azure-Infrastruktur mithilfe des Installer-Containers, der Azure CLI und von ARM-Vorlagen.

<Warning>
  **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](/de/vantage/self-hosted/v3.0/introduction) und [Migration von Vantage 2.7](/de/vantage/self-hosted/v3.0/migration-from-2.7).
</Warning>

<Note>
  Diese Seite gilt nur für **Azure AKS**-Bereitstellungen. Informationen zu Bereitstellungen auf virtuellen Maschinen finden Sie im Leitfaden [Installation](/de/vantage/self-hosted/v2.7/installation).
</Note>

<div id="overview">
  ## Übersicht
</div>

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.

<div id="prerequisites">
  ## Voraussetzungen
</div>

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](/de/vantage/self-hosted/v2.7/system-requirements#redis-cluster-azure-aks-only))

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

<div id="infrastructure-components">
  ## Infrastrukturkomponenten
</div>

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
```

<div id="step-1-download-the-installer-image">
  ## Schritt 1: Laden Sie das Image des Installationsprogramms herunter
</div>

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

```bash theme={null}
# 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
```

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

<div id="step-2-run-the-installer-container">
  ## Schritt 2: Den Installer-Container ausführen
</div>

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

```bash theme={null}
docker run -it registry.yourdomain.tld/vantage/vantage-azure:2.7.1
```

<div id="step-3-authenticate-to-azure">
  ## Schritt 3: Bei Azure anmelden
</div>

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

```bash theme={null}
# Bei Azure anmelden (öffnet Browser zur Authentifizierung)
az login

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

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

<div id="step-4-create-resource-group">
  ## Schritt 4: Ressourcengruppe erstellen
</div>

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

```bash theme={null}
az group create --location <location> --resource-group <resource_group_name>
```

**Beispiel:**

```bash theme={null}
az group create --location eastus --resource-group vantage-prod-rg
```

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

<div id="step-5-create-aks-cluster">
  ## Schritt 5: AKS-Cluster erstellen
</div>

<div id="preview-the-deployment">
  ### Bereitstellung in der Vorschau anzeigen
</div>

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

```bash theme={null}
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>
```

<Warning>
  Clusternamen dürfen nicht länger als **15 Zeichen** sein.
</Warning>

<div id="create-the-cluster">
  ### Cluster erstellen
</div>

```bash theme={null}
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
```

<Note>
  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](/de/vantage/self-hosted/v2.7/performance-guide) an.
</Note>

Für FIPS-konforme Deployments setzen Sie `enableFIPS=true`. Weitere Konfigurationshinweise finden Sie unter [FIPS Compliance](/de/vantage/self-hosted/v2.7/fips-compliance).

<div id="step-6-create-storage-accounts">
  ## Schritt 6: Speicherkonten erstellen
</div>

<div id="preview-the-deployment">
  ### Bereitstellung in der Vorschau anzeigen
</div>

```bash theme={null}
az deployment group what-if --name storage \
  --resource-group <resource_group_name> \
  --template-file files/infrastructure/azure/arms/StorageAccounts.Template.json
```

<div id="create-storage-accounts">
  ### Speicherkonten erstellen
</div>

```bash theme={null}
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
```

<div id="retrieve-storage-account-keys">
  ### Schlüssel für das Speicherkonto abrufen
</div>

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

```bash theme={null}
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`.

<div id="step-7-create-azure-sql-server">
  ## Schritt 7: Azure SQL Server erstellen
</div>

<div id="preview-the-deployment">
  ### Bereitstellung in der Vorschau anzeigen
</div>

```bash theme={null}
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>
```

<div id="create-sql-server">
  ### SQL Server erstellen
</div>

```bash theme={null}
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>
```

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

<div id="step-8-create-azure-sql-database">
  ## Schritt 8: Azure SQL Database erstellen
</div>

<div id="preview-the-deployment">
  ### Bereitstellung in der Vorschau anzeigen
</div>

```bash theme={null}
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>
```

<div id="create-database">
  ### Datenbank erstellen
</div>

```bash theme={null}
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>
```

<div id="step-9-get-node-resource-group">
  ## Schritt 9: Knotenressourcengruppe abrufen
</div>

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

```bash theme={null}
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.

<div id="step-10-configure-public-ip-address">
  ## Schritt 10: Öffentliche IP-Adresse konfigurieren
</div>

1. **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.

2. **Notieren Sie die IP-Adresse** für die `env_specific.yml`-Konfiguration:

   ```yaml theme={null}
   loadbalancer:
     external_ip: <your_public_ip_address>
   ```

3. **Erstellen Sie einen DNS-A-Eintrag**, der Ihre Domain auf diese IP-Adresse verweist.

<div id="step-11-install-gpu-driver-optional">
  ## Schritt 11: GPU-Treiber installieren (optional)
</div>

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

```bash theme={null}
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](/de/vantage/self-hosted/v2.7/system-requirements).

<div id="summary-of-created-resources">
  ## Zusammenfassung der erstellten Ressourcen
</div>

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                      |

<div id="next-steps">
  ## Nächste Schritte
</div>

Nach dem Erstellen der Infrastruktur:

1. **env\_specific.yml konfigurieren** - Tragen Sie die Werte aus diesem Leitfaden ein. Das vollständige Konfigurationsformat finden Sie unter [Installation](/de/vantage/self-hosted/v2.7/installation).

2. **Container-Images herunterladen** - Synchronisieren Sie die Vantage-Images mit Ihrer Container Registry.

3. **Installation ausführen** - Schließen Sie die Installation mithilfe der Playbooks ab.

Fahren Sie mit [Installation](/de/vantage/self-hosted/v2.7/installation) fort, um den vollständigen Installationsprozess abzuschließen.

<div id="troubleshooting">
  ## Fehlerbehebung
</div>

<div id="deployment-fails-with-permission-error">
  ### Deployment schlägt mit einem Berechtigungsfehler fehl
</div>

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

<div id="cluster-name-too-long">
  ### Clustername zu lang
</div>

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

<div id="storage-account-name-already-exists">
  ### Der Name des Speicherkontos ist bereits vergeben
</div>

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.

<div id="cannot-connect-to-sql-database">
  ### Verbindung mit der SQL-Datenbank kann nicht hergestellt werden
</div>

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.

<div id="related-documentation">
  ## Verwandte Dokumentation
</div>

* [Systemanforderungen](/de/vantage/self-hosted/v2.7/system-requirements) - Vollständige Anforderungen an die Infrastruktur
* [Installation](/de/vantage/self-hosted/v2.7/installation) - Vollständige Installationsanleitung
* [FIPS-Konformität](/de/vantage/self-hosted/v2.7/fips-compliance) - FIPS-aktivierte Deployments
* [Performance-Leitfaden](/de/vantage/self-hosted/v2.7/performance-guide) - Skalierung und Leistungsoptimierung