Zum Hauptinhalt springen
Das selbstgehostete Vantage 3.0-Installationsprogramm wird durch eine einzelne Kubernetes-Custom-Resource gesteuert: ein Vantage-Objekt in der API-Gruppe vantage.abbyy.com/v1alpha1. Die unten aufgeführten Felder definieren die vollständige Schnittstelle zwischen Ihnen und dem Operator. Einen konzeptionellen Überblick darüber, wie der Operator diese Ressource verwendet, finden Sie unter Architecture. Eine Installationsanleitung finden Sie unter Azure oder Self-Managed Kubernetes.

API-Gruppe

Vantage

Die Vantage-Ressource der obersten Ebene. Das vantage-selfhosted-Chart enthält eine Vantage-CR-Instanz, die in dem Namespace erstellt wird, in dem Sie dieses Chart installiert haben.

Vantage.spec

spec definiert den gewünschten Zustand von Vantage.
secrets-Validierung: has(self.kubernetes) != has(self.azure): Es muss genau ein Provider angegeben werden.
updatePolicy-Validierung: !has(self.auto): Automatische Updates werden derzeit noch nicht unterstützt.
updatePolicy-Validierung: (has(self.auto) ? 1 : 0) + (has(self.manual) ? 1 : 0) == 1: Es muss genau eine Update-Richtlinie angegeben werden.
ociMigration-Validierung: !has(self.enabled) || self.enabled == false || has(self.destination): destination ist erforderlich, wenn ociMigration aktiviert ist.
Datenbank- und Reporting-Validierung: PostgreSQL wird mit dem exakten Wert PostgreSQL ausgewählt. Reporting ist nur für SQL Server verfügbar; die Ressource wird abgelehnt, wenn databaseProvider auf PostgreSQL gesetzt ist und reportingEnabled den Wert true hat.
techcore-Validierung: !self.keepPreviousVersion || has(self.previousVersion): previousVersion ist erforderlich, wenn keepPreviousVersion auf true gesetzt ist.

Vantage.spec.keda

KEDA konfiguriert KEDA-basiertes Autoscaling für unterstützte Vantage-Workloads. Installieren Sie KEDA und den erforderlichen Prometheus-Service, bevor Sie es aktivieren. Die aktuellen Vantage-Workload-Charts erfordern KEDA 2.17.x. Einige ScaledObject-Ressourcen fragen http://prometheus-operated.observability.svc.cluster.local:9090 ab; siehe Autoscaling mit KEDA.

Vantage.spec.smtp

smtp konfiguriert den SMTP-Mailserver. Optionale Alternative zu SendGrid; wird nur verwendet, wenn gesetzt.

Vantage.spec.workloads

workloads konfiguriert die ConfigMap, die Daten über Charts und Images enthält

Vantage.spec.secrets

secrets konfiguriert den Provider für Secrets, der Anwendungsgeheimnisse (Datenbank-Connection-Strings, API keys, Zertifikate) für Vantage-Workloads bereitstellt. Es muss genau ein Provider angegeben werden. Siehe Secrets and Key Vault für das konzeptionelle Modell und eine vollständige Übersicht aller Aliasse.

Vantage.spec.secrets.azure

azure konfiguriert Azure Key Vault (über den Secrets Store CSI Driver) als Quelle für Secrets.

Vantage.spec.secrets.azure.objects[alias]

AzureSecretObjectConfig beschreibt ein einzelnes Key Vault-Objekt, das einem Secret-Alias zugeordnet ist.

Vantage.spec.secrets.kubernetes

Kubernetes verwendet bereits vorhandene Kubernetes-Secret-Ressourcen im Installations-Namespace.

Vantage.spec.secrets.kubernetes.objects[alias]

Jeder Eintrag weist einem Secret-Alias einen Kubernetes-Secret-Namen zu.

Vantage.spec.storage

storage konfiguriert Advanced-Speicheroptionen. Wenn es nicht angegeben ist, verwendet Vantage das Standard-Azure-Blob-Backend und liest die Connection Strings aus den Secret-Aliassen storage*ConnectionString. Siehe Secrets and Key Vault.

Vantage.spec.storage.custom

custom konfiguriert ein benutzerdefiniertes Speicher-Backend (PVC-basiert über eine Kubernetes-StorageClass).
Die referenzierte Kubernetes-StorageClass muss im Cluster bereits konfiguriert sein, bevor Sie Vantage mit einem benutzerdefinierten Speicher-Backend installieren.

Vantage.spec.updatePolicy

updatePolicy steuert, wie der Operator Vantage-Upgrades ausführt.

Vantage.spec.updatePolicy.auto

auto aktiviert automatische Versions-Upgrades. Noch nicht implementiert.

Vantage.spec.ociMigration

ociMigration konfiguriert das Kopieren von Artefakten aus einer Quell-Registry an ein Ziel vor der Installation. Lassen Sie ihn vollständig weg oder setzen Sie enabled=false, um die Migration zu überspringen. Wenn aktiviert, ist destination erforderlich.
destination-Validierung: !self.host.contains(’/’): host darf keinen Pfad enthalten; verwenden Sie das Feld repository für den Registry-Pfad
destination-Validierung: !self.host.contains(’://’): host darf kein Schema enthalten (z. B. https://)
Image-Pull-Zugriff für den Migrations-Job: Führen Sie den Job mit einem ServiceAccount aus, dem Ihr Registry-Pull-Secret zugeordnet ist (serviceAccountName), oder verweisen Sie im Source-Eintrag auf das Secret (sources[].credentialsRef.name). In Azure ist das Gewähren von AcrPull für die von AKS verwaltete Identität die einfachere Alternative zu Pull-Secrets. Der Zugriff von ArgoCD auf Ihre Registry wird separat als ArgoCD-Repository-Verbindung konfiguriert. Siehe Image pull access und Connect ArgoCD to your OCI registry.

Vantage.spec.ociMigration.destination

destination gibt an, wohin Artefakte kopiert werden.

Vantage.spec.ociMigration.destination.credentialsRef

credentialsRef verweist auf ein Secret, das Schlüssel für Benutzername und Kennwort enthält, oder auf ein Secret vom Typ kubernetes.io/dockerconfigjson. Hat Vorrang vor username/password, wenn angegeben.

Vantage.spec.ociMigration.destination.workloadIdentity

workloadIdentity definiert Einstellungen für die Verwendung der Identität der Workload (Kubernetes-Servicekonto), um auf die Registry zuzugreifen.

Vantage.spec.ociMigration.imagePullSecrets[index]

LocalObjectReference enthält genügend Informationen, um das referenzierte Objekt im selben Namespace zu finden.

Vantage.spec.ociMigration.sources[index]

ContainerRegistryConfig definiert die Verbindungseinstellungen für die Container Registry.

Vantage.spec.ociMigration.sources[index].credentialsRef

credentialsRef verweist auf ein Secret, das Schlüssel für Benutzername und Kennwort enthält, oder auf ein Secret vom Typ kubernetes.io/dockerconfigjson. Hat, wenn angegeben, Vorrang vor Benutzername/Kennwort.

Vantage.spec.ociMigration.sources[index].workloadIdentity

workloadIdentity definiert Einstellungen für die Verwendung der Identität der Workload (Kubernetes Servicekonto), um auf die Registry zuzugreifen.

Vantage.spec.techcore

techcore enthält die Konfiguration für die TechCore-Verarbeitungs-Engine.

Vantage.spec.techcore.nnTrainingWorkers

nnTrainingWorkers konfiguriert Worker für das Training neuronaler Netze

Vantage.status

status definiert den beobachteten Zustand von Vantage
Die Skill-Installation wird als separater Kubernetes-Job ausgeführt. Dieser wird nicht in status.conditions[] berücksichtigt und nicht über ArgoCD angezeigt. Vantage kann während der Ausführung des Jobs verwendet werden. Die Befehle zur Überwachung finden Sie unter Lifecycle.

Vantage.status.conditions[index]

Condition enthält Details zu einem Aspekt des aktuellen Zustands dieser API-Ressource.

Vantage.status.degradationReasons[index]

DegradationReason steht für einen Grund, warum eine einzelne Komponente der Installation beeinträchtigt ist.