> ## 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.
# API-Referenz
> Feldreferenz für die Vantage Custom-Resource `vantage.abbyy.com/v1alpha1`, die selbstgehostete Vantage 3.0-Installationen steuert.
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](/de/vantage/self-hosted/v3.0/architecture). Eine Installationsanleitung finden Sie unter [Azure](/de/vantage/self-hosted/v3.0/providers/azure) oder [Self-Managed Kubernetes](/de/vantage/self-hosted/v3.0/providers/self-managed).
## API-Gruppe
| Gruppe | Version | Ressource |
| ------------------- | ---------- | --------- |
| `vantage.abbyy.com` | `v1alpha1` | `Vantage` |
## 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.
| Feld | Typ | Erforderlich | Beschreibung |
| ------------ | -------- | ------------ | ----------------------------------------------------------------------------------------------------- |
| `apiVersion` | `string` | Ja | vantage.abbyy.com/v1alpha1 |
| `kind` | `string` | Ja | Vantage |
| `metadata` | `object` | Ja | Informationen zu den Feldern von `metadata` finden Sie in der Kubernetes-API-Dokumentation. |
| `spec` | `object` | Ja | `spec` definiert den Sollzustand von Vantage. Siehe [`Vantage.spec`](#vantagespec). |
| `status` | `object` | Nein | `status` definiert den beobachteten Istzustand von Vantage. Siehe [`Vantage.status`](#vantagestatus). |
## Vantage.spec
spec definiert den gewünschten Zustand von Vantage.
| Feld | Typ | Erforderlich | Beschreibung |
| -------------------- | --------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `databaseProvider` | `string` | Nein | Von den Vantage-Services verwendete Datenbank-Engine. Zulässige Werte sind `SqlServer` und `PostgreSQL`; der Wert ist groß-/kleinschreibungssensitiv. Standard: `SqlServer`. |
| `dnsRecord` | `string` | Ja | dnsRecord ist der DNS-Eintrag für die Vantage-Installation. Format: `hostname`. |
| `mailFrom` | `string` | Ja | mailFrom ist die E-Mail-Adresse, die für ausgehende E-Mails als Absender verwendet wird. Format: `email`. |
| `platformAdminEmail` | `string` | Ja | platformAdminEmail ist die E-Mail-Adresse des Plattformadministrators. Format: `email`. |
| `secrets` | `object` | Ja | secrets wählt den Secrets-Provider aus und konfiguriert ihn. Es muss genau ein Provider angegeben werden. Siehe [`secrets`](#vantagespecsecrets). |
| `updatePolicy` | `object` | Ja | updatePolicy steuert, wie der Operator Vantage-Upgrades verarbeitet. Verwenden Sie `manual: {}`; automatische Updates werden derzeit noch nicht unterstützt. Siehe [`updatePolicy`](#vantagespecupdatepolicy). |
| `vantageVersion` | `string` | Ja | vantageVersion ist die zu installierende Version von Vantage. |
| `workloads` | `object` | Ja | workloads konfiguriert die ConfigMap mit Daten zu Charts und Images. Siehe [`workloads`](#vantagespecworkloads). |
| `idReadingEnabled` | `boolean` | Nein | idReadingEnabled aktiviert Funktionen zum Auslesen von IDs. Standard: `false`. |
| `keda` | `object` | Nein | keda konfiguriert KEDA-basiertes Autoscaling. Siehe [`keda`](#vantagespeckeda). |
| `ociMigration` | `object` | Nein | ociMigration konfiguriert das Kopieren von Artefakten aus einer Quell-Registry in eine Ziel-Registry vor der Installation. Lassen Sie den Eintrag vollständig weg oder setzen Sie enabled=false, um die Migration zu überspringen. Wenn aktiviert, ist destination erforderlich. Siehe [`ociMigration`](#vantagespecocimigration). |
| `reportingEnabled` | `boolean` | Nein | reportingEnabled aktiviert SQL-Server-Reportingfunktionen. Der Wert muss `false` bleiben, wenn `databaseProvider` auf `PostgreSQL` gesetzt ist. Standard: `false`. |
| `serviceAccountName` | `string` | Nein | serviceAccountName ist der Name des ServiceAccount, der für Vantage-Workloads verwendet werden soll. Lassen Sie den Eintrag weg, um den Standard-ServiceAccount zu verwenden. Standard: `default`. Image-Pulls für Vantage-Workloads werden hier konfiguriert: Fügen Sie Ihr Registry-Pull-Secret zu `imagePullSecrets` dieses ServiceAccounts hinzu. Siehe [Azure image pull access](/de/vantage/self-hosted/v3.0/providers/azure#image-pull-access) oder [self-managed registry access](/de/vantage/self-hosted/v3.0/providers/self-managed#configure-registry-access). |
| `smtp` | `object` | Nein | smtp konfiguriert den SMTP-Mailserver. Wenn nicht angegeben, wird SendGrid als Mail-Provider verwendet. Siehe [`smtp`](#vantagespecsmtp). |
| `storage` | `object` | Nein | storage konfiguriert erweiterte Speicheroptionen. Wenn nichts angegeben ist, wird standardmäßig Azure Blob verwendet (unter Verwendung der Aliase `storage*ConnectionString`). Siehe [`storage`](#vantagespecstorage). |
| `techcore` | `object` | Nein | techcore enthält die Konfiguration für die TechCore-Verarbeitungsengine. Siehe [`techcore`](#vantagespectechcore). |
**`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.
| Feld | Typ | Erforderlich | Beschreibung |
| --------- | --------- | ------------ | --------------------------------------------------------------------------------------- |
| `enabled` | `boolean` | Nein | Aktiviert KEDA-`ScaledObject`-Ressourcen für unterstützte Workloads. Standard: `false`. |
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](/de/vantage/self-hosted/v3.0/performance/autoscaling).
## Vantage.spec.smtp
smtp konfiguriert den SMTP-Mailserver. Optionale Alternative zu SendGrid; wird nur verwendet, wenn gesetzt.
| Feld | Typ | Erforderlich | Beschreibung |
| ---------- | --------- | ------------ | ---------------------------------------------------------------------- |
| `host` | `string` | Ja | host ist der Hostname des SMTP-Servers |
| `login` | `string` | Nein | Login für die SMTP-Authentifizierung |
| `password` | `string` | Nein | Kennwort für die SMTP-Authentifizierung |
| `port` | `integer` | Nein | port ist der Port des SMTP-Servers. Standard: `587` · Format: `int32`. |
| `useSSL` | `boolean` | Nein | useSSL aktiviert TLS für SMTP-Verbindungen. Standard: `false`. |
## Vantage.spec.workloads
workloads konfiguriert die ConfigMap, die Daten über Charts und Images enthält
| Feld | Typ | Erforderlich | Beschreibung |
| --------------------- | -------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| `configMap` | `string` | Ja | configMap ist der Name der ConfigMap, die die Workloads-Daten enthält |
| `metadataTemplateKey` | `string` | Ja | metadataTemplateKey ist der Schlüssel innerhalb der ConfigMap, der die Metadatenvorlage für die Installation der Charts enthält |
| `secretsKey` | `string` | Ja | secretsKey ist der Schlüssel innerhalb der ConfigMap, der die Metadaten zu den Secrets enthält |
| `workloadsKey` | `string` | Ja | workloadsKey ist der Schlüssel innerhalb der ConfigMap, der die Liste der 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](/de/vantage/self-hosted/v3.0/secrets-and-keyvault) für das konzeptionelle Modell und eine vollständige Übersicht aller Aliasse.
| Feld | Typ | Erforderlich | Beschreibung |
| ------------ | -------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `azure` | `object` | Nein | azure konfiguriert Secrets über Azure Key Vault und den Secrets Store CSI driver. Siehe [`azure`](#vantagespecsecretsazure). |
| `kubernetes` | `object` | Nein | kubernetes verwendet bereits vorhandene Kubernetes-`Secret`-Ressourcen im Installations-Namespace. Siehe [`kubernetes`](#vantagespecsecretskubernetes). |
## Vantage.spec.secrets.azure
azure konfiguriert Azure Key Vault (über den Secrets Store CSI Driver) als Quelle für Secrets.
| Feld | Typ | Erforderlich | Beschreibung |
| ------------------------ | ------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `keyVaultName` | `string` | Ja | keyVaultName ist der Azure Key Vault, in dem die Secrets gespeichert sind. |
| `tenantId` | `string` | Ja | tenantId ist der Azure AD-Tenant, dem der Key Vault gehört. |
| `clientId` | `string` | Nein | clientId ist die Client ID der benutzerseitig zugewiesenen verwalteten Identität in Azure AD, die Lesezugriff auf den Key Vault hat. Erforderlich, wenn `identityMode` auf `workloadIdentity` gesetzt ist (Standard). |
| `identityMode` | `enum` | Nein | identityMode legt fest, wie sich der CSI-Treiber gegenüber Azure authentifiziert. Standard: `workloadIdentity` · Enum: `workloadIdentity, podIdentity, vmManagedIdentity`. |
| `objects` | `map[string]object` | Nein | objects überschreibt optional die Zuordnung eines Secret-Alias zu einem bestimmten Key-Vault-Objekt. Wenn ein Alias in dieser Zuordnung nicht vorhanden ist, wird der Alias selbst als Name des Key-Vault-Objekts verwendet und das Objekt als Typ `secret` abgerufen. Siehe [`objects`](#vantagespecsecretsazureobjectsalias). |
| `userAssignedIdentityID` | `string` | Nein | userAssignedIdentityID ist die Client ID der benutzerseitig zugewiesenen verwalteten Identität, die verwendet wird, wenn `identityMode` auf `vmManagedIdentity` gesetzt ist. |
## Vantage.spec.secrets.azure.objects\[alias]
`AzureSecretObjectConfig` beschreibt ein einzelnes Key Vault-Objekt, das einem Secret-Alias zugeordnet ist.
| Feld | Typ | Erforderlich | Beschreibung |
| --------------- | -------- | ------------ | ----------------------------------------------------------------------------------------------------------------------- |
| `objectName` | `string` | Ja | objectName ist der Name des Objekts in Azure Key Vault. |
| `objectType` | `enum` | Nein | objectType ist der Typ des Key Vault-Objekts. Standard: `secret` · Enum: `secret, key, cert`. |
| `objectVersion` | `string` | Nein | objectVersion legt eine bestimmte Version des Key Vault-Objekts fest. Standardmäßig wird die neueste Version verwendet. |
## Vantage.spec.secrets.kubernetes
Kubernetes verwendet bereits vorhandene Kubernetes-`Secret`-Ressourcen im Installations-Namespace.
| Feld | Typ | Erforderlich | Beschreibung |
| --------- | ------------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `objects` | `map[string]object` | Nein | `objects` definiert die verwendeten Kubernetes-Secrets, indem Secret-Aliasse `Secret`-Namen zugeordnet werden. Wenn dies nicht definiert ist, werden die Standardnamen der Secrets verwendet. Siehe [`objects`](#vantagespecsecretskubernetesobjectsalias). |
## Vantage.spec.secrets.kubernetes.objects\[alias]
Jeder Eintrag weist einem Secret-Alias einen Kubernetes-`Secret`-Namen zu.
| Feld | Typ | Erforderlich | Beschreibung |
| ------------ | -------- | ------------ | ------------------------------------------------------------------------- |
| `secretName` | `string` | Ja | `secretName` ist der Kubernetes-`Secret`-Name im Installations-Namespace. |
## 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](/de/vantage/self-hosted/v3.0/secrets-and-keyvault#storage).
| Feld | Typ | Erforderlich | Beschreibung |
| -------- | -------- | ------------ | ------------------------------------------------------------------------------------------------------------ |
| `custom` | `object` | Nein | `custom` konfiguriert ein benutzerdefiniertes Speicher-Backend. Siehe [`custom`](#vantagespecstoragecustom). |
## 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.
| Feld | Typ | Erforderlich | Beschreibung |
| -------------- | --------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `size` | `int or string` | Ja | size definiert die Größe des PVC. Standard: `300Gi`. |
| `storageClass` | `string` | Ja | storageClass definiert die `StorageClass`, die für PVCs verwendet wird, um Volumes des benutzerdefinierten Speicher-Backends einzubinden. |
## Vantage.spec.updatePolicy
updatePolicy steuert, wie der Operator Vantage-Upgrades ausführt.
| Feld | Typ | Erforderlich | Beschreibung |
| -------- | -------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `auto` | `object` | Nein | `auto` aktiviert automatische Versions-Upgrades. Noch nicht implementiert. Siehe [`auto`](#vantagespecupdatepolicyauto). |
| `manual` | `object` | Nein | `manual` deaktiviert automatische Upgrades. Upgrades werden durch die Installation einer neuen Version des Operator-Helm-Charts ausgeführt. |
## Vantage.spec.updatePolicy.auto
auto aktiviert automatische Versions-Upgrades. Noch nicht implementiert.
| Feld | Typ | Erforderlich | Beschreibung |
| ------------ | -------- | ------------ | ------------------------------------------------------------------------------------------- |
| `releaseURL` | `string` | Ja | `releaseURL` ist die URL, von der das Vantage-Release-Bundle abgerufen wird. Format: `uri`. |
## 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.
| Feld | Typ | Erforderlich | Beschreibung |
| -------------------- | ----------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `concurrency` | `integer` | Ja | `concurrency` ist die Anzahl der Artefakte, die parallel kopiert werden. Standard: `5` · Minimum: `1`. |
| `destination` | `object` | Nein | `destination` ist das Ziel, an das Artefakte kopiert werden. Siehe [`destination`](#vantagespecocimigrationdestination). |
| `enabled` | `boolean` | Nein | `enabled` aktiviert die OCI-Migration. Standard: `true`. |
| `imagePullSecrets` | `[]object` | Nein | `imagePullSecrets` ist eine optionale Liste von Referenzen auf Secrets im selben Namespace, die zum Abrufen des Operator-Images verwendet werden, mit dem der OCI-Migrations-Job in diesem Namespace ausgeführt wird. Siehe [`imagePullSecrets`](#vantagespecocimigrationimagepullsecretsindex). |
| `labels` | `map[string]JSON` | Nein | `labels` sind die Labels, die auf den OCI-Migrations-Job und die Pod-Vorlage angewendet werden sollen. Nicht-string-Werte werden mit \[fmt.Sprint] in Strings umgewandelt |
| `serviceAccountName` | `string` | Nein | `serviceAccountName` ist der Name des ServiceAccounts, der zum Ausführen des OCI-Migrations-Jobs verwendet wird. Fügen Sie Ihr Registry-Pull-Secret zu den `imagePullSecrets` dieses ServiceAccounts hinzu, damit der Job Images abrufen kann. |
| `sources` | `[]object` | Nein | `sources` sind Zugangsdaten für den Zugriff auf Registries, aus denen Artefakte kopiert werden (die von ABBYY bereitgestellte Quell-Registry). Maximale Länge 20. Siehe [`sources`](#vantagespecocimigrationsourcesindex). |
**`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](/de/vantage/self-hosted/v3.0/providers/azure#image-pull-access) und [Connect ArgoCD to your OCI registry](/de/vantage/self-hosted/v3.0/providers/azure#connect-argocd-to-your-oci-registry).
## Vantage.spec.ociMigration.destination
destination gibt an, wohin Artefakte kopiert werden.
| Feld | Typ | Erforderlich | Beschreibung |
| ------------------ | -------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `host` | `string` | Ja | host ist der Registry-Hostname und der optionale Port (z. B. registry.example.com, registry.example.com:5000) |
| `credentialsRef` | `object` | Nein | credentialsRef verweist auf ein Secret mit Schlüsseln für Benutzername und Kennwort oder auf ein Secret vom Typ kubernetes.io/dockerconfigjson. Falls angegeben, hat es Vorrang vor username/password. Siehe [`credentialsRef`](#vantagespecocimigrationdestinationcredentialsref). |
| `password` | `string` | Nein | Kennwort für die Authentifizierung bei der Registry (Klartext, für Produktionsumgebungen credentialsRef verwenden) |
| `repository` | `string` | Nein | repository ist der Registry-Pfad/Namespace für Artefakte (z. B. `my-registry-namespace`, `vantage/images`). |
| `username` | `string` | Nein | Benutzername für die Authentifizierung bei der Registry (Klartext, für Produktionsumgebungen credentialsRef verwenden) |
| `workloadIdentity` | `object` | Nein | workloadIdentity definiert Einstellungen für die Verwendung der Workload-Identität (Kubernetes-Servicekonto) für den Zugriff auf die Registry. Siehe [`workloadIdentity`](#vantagespecocimigrationdestinationworkloadidentity). |
## 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.
| Feld | Typ | Erforderlich | Beschreibung |
| ------ | -------- | ------------ | ------------------------------- |
| `name` | `string` | Ja | `name` ist der Name des Secrets |
## Vantage.spec.ociMigration.destination.workloadIdentity
workloadIdentity definiert Einstellungen für die Verwendung der Identität der Workload (Kubernetes-Servicekonto),
um auf die Registry zuzugreifen.
| Feld | Typ | Erforderlich | Beschreibung |
| --------------- | -------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| `audience` | `string` | Nein | audience ist der Endpunkt, der für den Austausch des Servicekonto-Tokens gegen ein OAuth-Zugriffstoken verwendet werden soll. |
| `clientId` | `string` | Nein | clientId ist die Client-ID, die für den Austausch des Servicekonto-Tokens gegen ein OAuth-Zugriffstoken verwendet werden soll. |
| `tokenEndpoint` | `string` | Nein | tokenEndpoint ist der Endpunkt, der für den Austausch des Servicekonto-Tokens gegen ein OAuth-Zugriffstoken verwendet werden soll. |
## Vantage.spec.ociMigration.imagePullSecrets\[index]
LocalObjectReference enthält genügend Informationen, um das
referenzierte Objekt im selben Namespace zu finden.
| Feld | Typ | Erforderlich | Beschreibung |
| ------ | -------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name` | `string` | Nein | Name des referenzierten Objekts. Dieses Feld ist faktisch erforderlich, darf aber aus Gründen der Abwärtskompatibilität leer sein. Instanzen dieses Typs mit einem leeren Wert an dieser Stelle sind mit hoher Wahrscheinlichkeit fehlerhaft. Weitere Informationen: [https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names](https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names) |
## Vantage.spec.ociMigration.sources\[index]
ContainerRegistryConfig definiert die Verbindungseinstellungen für die Container Registry.
| Feld | Typ | Erforderlich | Beschreibung |
| ------------------ | -------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `host` | `string` | Ja | `host` ist der Hostname der Registry mit optionalem Port (z. B. registry.example.com, registry.example.com:5000) |
| `credentialsRef` | `object` | Nein | `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 es Vorrang vor `username`/`password`. Die Referenz auf ein Pull-Secret an dieser Stelle ist eine Alternative dazu, den Migrationsjob unter einem Servicekonto auszuführen, der dieses Secret enthält. Siehe [`credentialsRef`](#vantagespecocimigrationsourcesindexcredentialsref). |
| `password` | `string` | Nein | Kennwort für die Authentifizierung bei der Registry (Klartext; für Produktionsumgebungen `credentialsRef` verwenden) |
| `repository` | `string` | Nein | `repository` ist der Registry-Pfad/Namespace für Artefakte (z. B. `my-registry-namespace`, `vantage/images`). |
| `username` | `string` | Nein | Benutzername für die Authentifizierung bei der Registry (Klartext; für Produktionsumgebungen `credentialsRef` verwenden) |
| `workloadIdentity` | `object` | Nein | `workloadIdentity` definiert Einstellungen für die Verwendung der Identität des Workloads (Kubernetes-Servicekonto) für den Zugriff auf die Registry. Siehe [`workloadIdentity`](#vantagespecocimigrationsourcesindexworkloadidentity). |
## 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.
| Feld | Typ | Erforderlich | Beschreibung |
| ------ | -------- | ------------ | ------------------------------- |
| `name` | `string` | Ja | `name` ist der Name des Secrets |
## 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.
| Feld | Typ | Erforderlich | Beschreibung |
| --------------- | -------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------- |
| `audience` | `string` | Nein | audience ist der Endpunkt, der verwendet werden soll, um das Servicekonto-Token gegen ein OAuth-Zugriffstoken auszutauschen. |
| `clientId` | `string` | Nein | clientId ist die Client ID, die verwendet werden soll, um das Servicekonto-Token gegen ein OAuth-Zugriffstoken auszutauschen. |
| `tokenEndpoint` | `string` | Nein | tokenEndpoint ist der Endpunkt, der verwendet werden soll, um das Servicekonto-Token gegen ein OAuth-Zugriffstoken auszutauschen. |
## Vantage.spec.techcore
techcore enthält die Konfiguration für die TechCore-Verarbeitungs-Engine.
| Feld | Typ | Erforderlich | Beschreibung |
| --------------------- | --------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `version` | `integer` | Ja | version ist die bereitzustellende TechCore-Version (z. B. 4). Minimum: `1`. |
| `keepPreviousVersion` | `boolean` | Nein | keepPreviousVersion behält die vorherige Version bei einem Upgrade bei. Standard: `false`. |
| `nnTrainingWorkers` | `object` | Nein | nnTrainingWorkers konfiguriert Worker für das Training neuronaler Netze. Siehe [`nnTrainingWorkers`](#vantagespectechcorenntrainingworkers). |
| `previousVersion` | `integer` | Nein | previousVersion ist die Version, von der aus das Upgrade erfolgt. Erforderlich, wenn keepPreviousVersion auf true gesetzt ist. Minimum: `1`. |
## Vantage.spec.techcore.nnTrainingWorkers
nnTrainingWorkers konfiguriert Worker für das Training neuronaler Netze
| Feld | Typ | Erforderlich | Beschreibung |
| --------- | --------- | ------------ | -------------------------------------------------------------------------------- |
| `enabled` | `boolean` | Nein | `enabled` aktiviert Worker für das Training neuronaler Netze. Standard: `false`. |
| `gpu` | `boolean` | Nein | `gpu` aktiviert die GPU-Beschleunigung für Training-Worker. Standard: `false`. |
## Vantage.status
status definiert den beobachteten Zustand von Vantage
| Field | Type | Required | Description |
| ------------------------- | ---------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `availableVersions` | `[]string` | No | availableVersions ist die Liste der Versionen, die über die Release-URL verfügbar sind. |
| `conditions` | `[]object` | No | conditions repräsentiert den aktuellen Zustand der Vantage-Ressource. Jede Bedingung hat einen eindeutigen Typ und spiegelt den Status eines bestimmten Aspekts der Ressource wider. Zu den Standardtypen von Bedingungen gehören: - "Available": Die Ressource ist vollständig funktionsfähig - "Progressing": Die Ressource wird erstellt oder aktualisiert - "Degraded": Die Ressource konnte ihren Sollzustand nicht erreichen oder aufrechterhalten Der Status jeder Bedingung ist entweder True, False oder Unknown. Siehe [`conditions`](#vantagestatusconditionsindex). |
| `degradationReasons` | `[]object` | No | degradationReasons repräsentiert die Gründe für den beeinträchtigten Zustand der Installation. Siehe [`degradationReasons`](#vantagestatusdegradationreasonsindex). |
| `installedVantageVersion` | `string` | No | installedVantageVersion ist die aktuell ausgeführte Version. |
| `observedGeneration` | `integer` | No | observedGeneration ist die Generation der Spezifikation, die vom Controller „verarbeitet“ wurde. Format: `int64`. |
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](/de/vantage/self-hosted/v3.0/lifecycle#skill-installation-runs-separately).
## Vantage.status.conditions\[index]
Condition enthält Details zu einem Aspekt des aktuellen Zustands dieser API-Ressource.
| Feld | Typ | Erforderlich | Beschreibung |
| -------------------- | --------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `lastTransitionTime` | `string` | Ja | lastTransitionTime ist der letzte Zeitpunkt, zu dem der Status der Bedingung von einem Wert in einen anderen gewechselt ist. Dies sollte der Zeitpunkt sein, zu dem sich die zugrunde liegende Bedingung geändert hat. Falls dieser nicht bekannt ist, kann stattdessen der Zeitpunkt verwendet werden, zu dem sich das API-Feld geändert hat. Format: `date-time`. |
| `message` | `string` | Ja | message ist eine menschenlesbare Meldung, die Details zum Übergang angibt. Dies kann eine leere Zeichenfolge sein. |
| `reason` | `string` | Ja | reason enthält einen programmatischen Bezeichner, der den Grund für den letzten Übergang der Bedingung angibt. Erzeuger bestimmter Bedingung-Typen können erwartete Werte und Bedeutungen für dieses Feld definieren sowie festlegen, ob die Werte als garantierter Bestandteil der API gelten. Der Wert sollte eine CamelCase-Zeichenfolge sein. Dieses Feld darf nicht leer sein. |
| `status` | `enum` | Ja | status der Bedingung; einer von True, False oder Unknown. Enum: `True, False, Unknown`. |
| `type` | `string` | Ja | type der Bedingung in CamelCase oder im Format foo.example.com/CamelCase. |
| `observedGeneration` | `integer` | Nein | observedGeneration steht für `.metadata.generation`, auf deren Grundlage die Bedingung gesetzt wurde. Wenn beispielsweise `.metadata.generation` derzeit 12 ist, `.status.conditions[x].observedGeneration` jedoch 9, ist die Bedingung im Hinblick auf den aktuellen Zustand der Instanz veraltet. Format: `int64` · Minimum: `0`. |
## Vantage.status.degradationReasons\[index]
DegradationReason steht für einen Grund, warum eine einzelne Komponente der Installation beeinträchtigt ist.
| Feld | Typ | Erforderlich | Beschreibung |
| ----------- | -------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `component` | `string` | Ja | `component` ist der Teil der Installation, der beeinträchtigt ist. |
| `message` | `string` | Ja | `message` ist eine für Menschen lesbare Beschreibung der Beeinträchtigung der Komponente. |
| `reason` | `string` | Ja | `reason` enthält einen programmatischen Bezeichner, der den Grund für die Beeinträchtigung der Komponente angibt. Der Wert sollte eine CamelCase-Zeichenfolge sein. |