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

# Übersicht

> Architekturübersicht zu ABBYY Vantage 3.0 selbstgehostet: eine von Kubernetes-Operatoren gesteuerte und deklarativ konfigurierte Bereitstellung der Vantage-Plattform.

ABBYY Vantage 3.0 selbstgehostet ist eine beim Kunden gehostete Bereitstellung der Vantage-Plattform, die auf einem Kubernetes-Operator basiert. Sie deklarieren eine einzelne `Vantage`-Custom-Resource, die die gewünschte Installation beschreibt, und der Operator übernimmt die Installation von Vantage Core: das Abrufen der für Vantage Core erforderlichen Abhängigkeiten, die Validierung der Konfiguration, das Kopieren von Artefakten in Ihre Registry und das Synchronisieren der Helm-Releases mit ArgoCD.

<div id="why-a-new-installer">
  ## Warum ein neues Installationsprogramm
</div>

Für Vantage 2.7 selbstgehostet war die von ABBYY exakt spezifizierte Infrastruktur erforderlich, die mit von ABBYY bereitgestellten Ansible-Playbooks und Azure-CLI-Skripten in einem Docker-Container erstellt und konfiguriert wurde. Dieses Modell wird in 3.0 nicht unterstützt: Sie stellen Ihre eigene Infrastruktur bereit, und der Umstieg von 2.7 ist eine Neuinstallation plus Datenmigration, kein In-Place-Upgrade. Das Installationsprogramm für 3.0 setzt auf moderne Kubernetes-Muster: einen Operator, eine deklarative Custom-Resource und ArgoCD für die Orchestrierung.

Das Ergebnis sind anfangs weniger Komponenten und im Lauf der Zeit einfachere Upgrades. Kunden verwalten den Operator und die Custom-Resource; der Operator reconciliiert von dort aus die Vantage Core-Releases.

<Note>
  **Vantage 3.0 verwendet ein anderes Bereitstellungsmodell als 2.7 und frühere Versionen.** Frühere Releases erforderten die von ABBYY exakt spezifizierte Infrastruktur, die mit von ABBYY bereitgestellten Ansible- und Azure-CLI-Skripten erstellt und konfiguriert wurde. Dieses Modell wird in 3.0 nicht unterstützt:

  * Sie stellen Ihre eigene Infrastruktur bereit: den Kubernetes-Cluster, die Datenbanken, die Speicherkonten und den Key Vault. ABBYY stellt für 3.0 keine Bereitstellungsskripte, Vorlagen oder andere Infrastrukturautomatisierung bereit.
  * Das Installationsprogramm stellt nur Vantage Core bereit. Drittanbietersoftware, auf die Vantage angewiesen ist, wie ArgoCD, Ihr Service Mesh und Ihr Ingress-Controller, Ihre Secrets-Integration und Ihr Überwachungs-Stack, wird von Ihnen installiert und gewartet, in der Regel über Helm.
  * Die dokumentierten Konfigurationen sind von ABBYY getestete Szenarien. Sie können Ihre Installation anhand der dokumentierten Beispiele anpassen; die Validierung einer solchen Anpassung liegt in Ihrer Verantwortung.
</Note>

<div id="architecture-at-a-glance">
  ## Architektur auf einen Blick
</div>

| Komponente                    | Rolle                                                                                                                                                                        |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Vantage operator**          | Kubernetes-Operator, der über Helm bereitgestellt wird. Überwacht die `Vantage` Custom-Resource und reconciliiert den Installationszustand.                                  |
| **`Vantage` Custom-Resource** | Deklarative Spezifikation für die Installation (`vantage.abbyy.com/v1alpha1`). DNS, Secrets, SMTP, Workloads.                                                                |
| **ArgoCD**                    | Wendet die Helm-Releases der einzelnen Komponenten an, aus denen Vantage besteht, und reconciliiert sie.                                                                     |
| **OCI-Migrations-Job**        | Kopiert Vantage-Artefakte vor der Installation aus der von ABBYY bereitgestellten Quell-Registry in Ihre Ziel-Registry.                                                      |
| **Skill installer job**       | Installiert Vantage-Skills über einen separaten Kubernetes-Job. Wird nicht von ArgoCD verfolgt.                                                                              |
| **Secrets provider**          | Stellt Anwendungswerte über Azure Key Vault und den Secrets Store CSI driver oder über native Kubernetes-Secrets bereit.                                                     |
| **Service mesh**              | Stellt mTLS für den Anwendungsverkehr von Vantage bereit. Die unterstützten Bereitstellungsanleitungen verwenden Istio auf AKS und Linkerd auf selbstverwaltetem Kubernetes. |
| **Ingress controller**        | Beendet öffentliches HTTPS und implementiert das Vantage-Vertragsmodell für Pfad-Routing und Umschreibungen.                                                                 |

ABBYY liefert den Vantage operator, den OCI-Migrations-Job und den Skill installer job. ArgoCD, das Service mesh, der Ingress controller, die Secrets-Integration und der Überwachungs-Stack sind Voraussetzungen von Drittanbietern, die Sie vor der Installation von Vantage installieren und verwalten müssen.

Wenn der Operator eine `Vantage`-Ressource reconciliiert, durchläuft der Prozess fünf Phasen:

1. **Preflight**: validiert die Konfiguration. Während der Preflight-Prüfungen wird die Secrets-Konfiguration validiert.
2. **Secrets**: bereitet den konfigurierten Secrets-Provider vor. Mit Azure Key Vault stellt der Operator `SecretProviderClass`-Ressourcen bereit, und der CSI-Treiber liefert Werte beim Start des Pods. Mit dem Kubernetes-Provider validiert der Operator die nativen Secrets, die Sie zuvor im Installations-Namespace erstellt haben.
3. **OCI Migration**: führt den OCI-Migrations-Job aus, um Artefakte in Ihre Ziel-Registry zu kopieren.
4. **Installation**: generiert ArgoCD-Anwendungsmanifeste für jede Komponente und wendet sie an.
5. **Sync**: überwacht den ArgoCD-Anwendungsstatus und meldet ihn an die `Vantage` Custom-Resource zurück.

Die Skill-Installation läuft als separater Kubernetes-Job, den ArgoCD nicht verfolgt; Vantage kann bereits verwendet werden, während der Job abgeschlossen wird. Siehe [Lifecycle](/de/vantage/self-hosted/v3.0/lifecycle#skill-installation-runs-separately).

<div id="what-changes-from-vantage-27">
  ## Was sich gegenüber Vantage 2.7 ändert
</div>

| Aspekt                      | 2.7 selbstgehostet                                                                                    | 3.0 selbstgehostet                                                                                                          |
| --------------------------- | ----------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| Installationsprogramm       | Ansible-Playbooks in einem Docker-Container                                                           | Kubernetes-Operator + ArgoCD                                                                                                |
| Infrastrukturbereitstellung | Von ABBYY bereitgestellte Ansible- und Azure-CLI-Skripte für eine von ABBYY vorgegebene Infrastruktur | Von Ihnen bereitgestellt; keine von ABBYY bereitgestellte Automatisierung                                                   |
| Konfiguration               | Datei `env_specific.yaml`                                                                             | Deklarative `Vantage`-Custom-Resource                                                                                       |
| Bereitstellungsziele        | Azure oder On-Premises-VMs                                                                            | AKS oder selbstverwaltetes Kubernetes                                                                                       |
| Service-Mesh                | Nicht Teil der Installation                                                                           | Istio auf AKS oder Linkerd auf selbstverwaltetem Kubernetes, mit mTLS für den Anwendungsverkehr                             |
| Secrets                     | YAML-Dateien / Umgebungsvariablen                                                                     | Cloud-Key-Vault über den Secrets Store CSI driver oder bereits vorhandene Kubernetes-`Secret`-Ressourcen                    |
| Updates                     | Die von ABBYY bereitgestellten Installationsskripte und Ansible-Playbooks erneut ausführen            | Passende Versionen des Operators und der Vantage-Charts aktualisieren; der Operator reconciliiert die Vantage Core Releases |

<div id="where-to-go-next">
  ## Nächste Schritte
</div>

<CardGroup cols={2}>
  <Card title="Voraussetzungen" icon="list-check" href="/de/vantage/self-hosted/v3.0/prerequisites">
    Cluster, Services, Secrets und Zertifikate, die vor der Installation vorhanden sein müssen.
  </Card>

  <Card title="Architektur" icon="diagram-project" href="/de/vantage/self-hosted/v3.0/architecture">
    Wie der Operator die `Vantage`-Custom-Resource nutzt.
  </Card>

  <Card title="Installation auf Azure" icon="cloud" href="/de/vantage/self-hosted/v3.0/providers/azure">
    Schritt-für-Schritt-Installation auf AKS mit Azure Key Vault.
  </Card>

  <Card title="Kubernetes in Eigenverwaltung" icon="server" href="/de/vantage/self-hosted/v3.0/providers/self-managed">
    Installation mit kundenseitig verwaltetem Ingress, Mesh, Secrets, Speicher und Datendiensten.
  </Card>

  <Card title="API-Referenz" icon="code" href="/de/vantage/self-hosted/v3.0/api-reference">
    Feldbezogene Referenz für die `Vantage`-Custom-Resource.
  </Card>
</CardGroup>
