Zum Hauptinhalt springen

Artefaktversionen

Das Installationsprogramm von Vantage 3.0 selbst gehostet wird über eine einzige Kubernetes-Custom-Resource gesteuert: ein Vantage-Objekt in der API-Gruppe vantage.abbyy.com/v1alpha1. Die unten aufgeführten Felder bilden den vollständigen Vertrag zwischen Ihnen und dem Bediener. Einen konzeptionellen Überblick darüber, wie der Bediener diese Ressource verarbeitet, finden Sie unter Architektur. Eine Installationsanleitung finden Sie unter Azure oder Selbstverwaltetes Kubernetes.

API-Gruppe

Vantage

Vantage ist das Schema für die vantages-API
spec-Validierung: !self.reportingEnabled || !has(self.databaseProvider) || self.databaseProvider == 'SqlServer': reportingEnabled erfordert databaseProvider ‘SqlServer’; Reporting ist nur mit SQL Server verfügbar und kann nicht mit PostgreSQL verwendet werden

Vantage.spec

spec definiert den gewünschten Zustand von Vantage
Validierung von secrets: has(self.kubernetes) != has(self.azure): Es muss genau ein Provider angegeben werden
updatePolicy-Validierung: !has(self.auto): Automatische Updates werden noch nicht unterstützt
updatePolicy-Validierung: (has(self.auto) ? 1 : 0) + (has(self.manual) ? 1 : 0) == 1: Es muss genau eine Aktualisierungsrichtlinie angegeben werden
ociMigration-Validierung: !has(self.enabled) || self.enabled == false || has(self.destination): Wenn ociMigration aktiviert ist, muss ein Ziel (destination) angegeben werden
storage-Validierung: !has(self.s3): S3-Speicher wird noch nicht unterstützt
storage-Validierung: (has(self.azure) ? 1 : 0) + (has(self.s3) ? 1 : 0) + (has(self.custom) ? 1 : 0) <= 1: Es darf höchstens ein Speicher-Provider angegeben werden

Vantage.spec.secrets

secrets wählt den Provider für Secrets aus und konfiguriert ihn. Es muss genau ein Provider angegeben werden.

Vantage.spec.secrets.azure

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

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

AzureSecretObjectConfig beschreibt ein einzelnes Key-Vault-Objekt, das einem Secret-Alias zugrunde liegt.

Vantage.spec.secrets.kubernetes

kubernetes konfiguriert Kubernetes-native Secrets als Quelle für Secrets.

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

Vantage.spec.updatePolicy

updatePolicy legt fest, wie der Bediener Vantage-Upgrades handhabt. Noch nicht unterstützt. Der Bediener lehnt jede Ressource ab, in der diese Felder gesetzt sind.

Vantage.spec.updatePolicy.auto

auto aktiviert automatische Versions-Upgrades. Noch nicht implementiert.

Vantage.spec.workloads

workloads konfiguriert die ConfigMap, die Daten zu charts und Images enthält

Vantage.spec.workloads.pods

pods konfiguriert Metadaten, die den pods der Workloads hinzugefügt werden.

Vantage.spec.workloads.pods.charts[key]

ChartPodsConfig definiert Metadaten, die den pods der Workloads innerhalb eines einzelnen Vantage-Helm-Charts hinzugefügt werden.

Vantage.spec.workloads.pods.charts[key].deployment

deployment konfiguriert die pods der Bereitstellung des charts.

Vantage.spec.workloads.pods.charts[key].migrator

migrator konfiguriert die pods des Migrator-Jobs des charts.

Vantage.spec.workloads.pods.charts[key].statefulSet

statefulSet konfiguriert die pods des StatefulSets im chart.

Vantage.spec.workloads.serviceAccounts

serviceAccounts überschreibt spec.serviceAccountName für bestimmte Workloads.

Vantage.spec.workloads.serviceAccounts.charts[key]

ChartServiceAccountsConfig definiert die Konfiguration der Dienstkonten für Workloads innerhalb eines einzelnen Vantage-Helm-Charts.

Vantage.spec.workloads.serviceAccounts.charts[key].deployment

deployment konfiguriert das Dienstkonto, das von der Bereitstellung des charts verwendet wird.

Vantage.spec.workloads.serviceAccounts.charts[key].migrator

migrator konfiguriert das Dienstkonto, das vom Migrator-Job des charts verwendet wird.

Vantage.spec.workloads.serviceAccounts.charts[key].statefulSet

statefulSet konfiguriert das Dienstkonto, das vom StatefulSet des charts verwendet wird.

Vantage.spec.argocd

argocd konfiguriert die Argo-CD-Ressourcen, die der Bediener erstellt, um Vantage-Workloads zu installieren. Wenn Sie es weglassen, erfolgt die Installation im Projekt „default“.
Validierung von namespace: self == oldSelf: namespace ist unveränderlich

Vantage.spec.keda

keda konfiguriert die KEDA-Einstellungen. Ohne Angabe ist die KEDA-Unterstützung deaktiviert.

Vantage.spec.ociMigration

ociMigration konfiguriert das Kopieren von Artefakten aus einer Quell-Registry in ein Ziel vor der Installation. Lassen Sie den Abschnitt vollständig weg oder setzen Sie enabled=false, um die Migration zu überspringen. Wenn die Migration aktiviert ist, ist destination erforderlich.
destination-Validierung: !self.host.contains('/'): host darf keinen Pfad enthalten – verwenden Sie für den Registry-Pfad das Feld repository
destination-Validierung: !self.host.contains('://'): host darf kein Schema enthalten (z. B. https://)
resources-Validierung: !has(self.claims) || size(self.claims) == 0: resources.claims wird vom OCI-Migrations-Job nicht unterstützt

Vantage.spec.ociMigration.destination

destination ist das Ziel, in das die 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, sofern angegeben, Vorrang vor username/password.

Vantage.spec.ociMigration.destination.workloadIdentity

workloadIdentity definiert Einstellungen, mit denen über die Identität der Workload (Kubernetes-Dienstkonto) auf die Registry zugegriffen wird.

Vantage.spec.ociMigration.imagePullSecrets[index]

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

Vantage.spec.ociMigration.resources

resources sind die Rechenressourcen des Containers des OCI-Migrations-Jobs. Standardmäßig bleibt die CPU unbegrenzt, damit der Kopiervorgang bei Bedarf mehr Leistung abrufen kann. Legen Sie auf Clustern, deren Richtlinien für jeden Container ein CPU-Limit vorschreiben, ein solches Limit fest. Nur requests und limits werden berücksichtigt: Der Job deklariert keine resourceClaims auf pod-Ebene, daher werden claims abgelehnt. Noch nicht unterstützt. Der Bediener lehnt jede Ressource ab, in der diese Felder festgelegt sind.

Vantage.spec.ociMigration.resources.claims[index]

ResourceClaim verweist auf einen Eintrag in PodSpec.ResourceClaims.

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. Falls angegeben, hat dieses Feld Vorrang vor username/password.

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

workloadIdentity definiert die Einstellungen, mit denen die Identität der Workload (Kubernetes-Dienstkonto) für den Zugriff auf die Registry verwendet wird.

Vantage.spec.smtp

smtp konfiguriert den SMTP-Mailserver. Ist nichts angegeben, wird Sendgrid als Mail-Provider verwendet.

Vantage.spec.storage

storage konfiguriert Advanced-Speicheroptionen. Noch nicht unterstützt. Der Bediener lehnt jede Ressource ab, in der diese Felder gesetzt sind.

Vantage.spec.storage.custom

custom konfiguriert ein benutzerdefiniertes Speicher-Backend.

Vantage.spec.storage.s3

s3 konfiguriert das S3-Speicher-Backend.

Vantage.spec.storage.s3.buckets

buckets konfiguriert die Namen der Speicher-Buckets.

Vantage.spec.storage.s3.scopedClientCredentials

scopedClientCredentials konfiguriert den Speicher-Service so, dass er Clients statt seiner eigenen schlüssellosen Verbindung kurzlebige Anmeldedaten im Gültigkeitsbereich eines einzelnen Speichers (STS AssumeRole) bereitstellt.

Vantage.spec.techcore

techcore enthält die Konfiguration für die TechCore-Verarbeitungsengine

Vantage.spec.techcore.nnTrainingWorkers

nnTrainingWorkers konfiguriert die Trainings-Worker für neuronale Netze.

Vantage.spec.techcore.workers

workers konfiguriert die Bereitstellungen der TechCore-Worker und deren automatische Skalierung. Alle Felder werden nur wirksam, wenn keda.enabled auf true gesetzt ist. Einzige Ausnahme ist replicaCount, das zusätzlich die Replikate des Deployments festlegt.

Vantage.spec.techcore.workers.defaults

defaults gilt für jeden TechCore-Worker jeder bereitgestellten Version.

Vantage.spec.techcore.workers.defaults.resources

resources legt fest, welche Ressourcen einem einzelnen Worker zugewiesen werden. Aus diesen Werten pro Worker setzen sich die Summen im Leitfaden zur Dimensionierung zusammen. Wenn Sie sie ändern, ändert sich daher auch der Ressourcenbedarf der Installation.

Vantage.spec.techcore.workers.defaults.scaling

scaling konfiguriert das Verhalten der automatischen Skalierung, das ohne keda.enabled keine Auswirkung hat.

Vantage.spec.techcore.workers.defaults.scaling.cron

cron hält Worker während der Arbeitszeiten aktiv und lässt sie außerhalb dieser Zeiten auf null skalieren. Setzt scaleInactiveToZero voraus und hat keine Auswirkung auf Worker, die ausschließlich die Warteschlange mit niedriger Priorität bedienen.

Vantage.spec.techcore.workers.overrides[key]

WorkerConfig definiert die anpassbaren Einstellungen eines TechCore-Workers. Bei nicht gesetzten Feldern bleibt der Standardwert des jeweiligen Worker-charts erhalten.

Vantage.spec.techcore.workers.overrides[key].resources

resources legt fest, welche Ressourcen einem einzelnen Worker zugewiesen werden. Aus diesen Werten pro Worker setzen sich die Summen im Dimensionierungsleitfaden zusammen. Wenn Sie sie ändern, ändert sich also auch der Ressourcenbedarf der Installation.

Vantage.spec.techcore.workers.overrides[key].scaling

scaling konfiguriert das Verhalten der automatischen Skalierung, das ohne keda.enabled keine Auswirkung hat.

Vantage.spec.techcore.workers.overrides[key].scaling.cron

cron hält Worker während der Arbeitszeiten aktiv und erlaubt, sie außerhalb dieser Zeiten auf null herunterzuskalieren. Setzt scaleInactiveToZero voraus und hat keine Auswirkung auf Worker, die ausschließlich die Warteschlange mit niedriger Priorität bedienen.

Vantage.status

status definiert den beobachteten Zustand von Vantage

Vantage.status.conditions[index]

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

Vantage.status.degradationReasons[index]

DegradationReason gibt den Grund an, warum eine einzelne Komponente der Installation beeinträchtigt ist.