Passer au contenu principal

Versions des artefacts

Le programme d’installation de Vantage 3.0 auto-hébergé repose sur une seule ressource personnalisée Kubernetes : un objet Vantage du groupe d’API vantage.abbyy.com/v1alpha1. Les champs décrits ci-dessous constituent l’intégralité du contrat entre vous et l’operator. Pour une vue d’ensemble conceptuelle de la façon dont l’operator exploite cette ressource, voir Architecture. Pour la procédure d’installation, choisissez Azure ou Kubernetes autogéré.

Groupe d’API

Vantage

Vantage est le schéma de l’API vantages
Validation de spec : !self.reportingEnabled || !has(self.databaseProvider) || self.databaseProvider == 'SqlServer' : reportingEnabled exige que databaseProvider soit défini sur ‘SqlServer’ ; la fonctionnalité de déclaration est disponible uniquement avec SQL Server et ne peut pas être utilisée avec PostgreSQL

Vantage.spec

spec définit l’état souhaité de Vantage
Validation de secrets : has(self.kubernetes) != has(self.azure) : un seul et unique fournisseur doit être spécifié
Validation de updatePolicy : !has(self.auto) : les mises à jour automatiques ne sont pas encore prises en charge
Validation de updatePolicy : (has(self.auto) ? 1 : 0) + (has(self.manual) ? 1 : 0) == 1 : une seule stratégie de mise à jour doit être spécifiée
Validation de ociMigration : !has(self.enabled) || self.enabled == false || has(self.destination) : la destination est obligatoire lorsque ociMigration est activé
Validation de storage : !has(self.s3) : le stockage S3 n’est pas encore pris en charge
Validation de storage : (has(self.azure) ? 1 : 0) + (has(self.s3) ? 1 : 0) + (has(self.custom) ? 1 : 0) <= 1 : un seul fournisseur de stockage peut être spécifié au maximum

Vantage.spec.secrets

secrets sélectionne et configure le fournisseur de secrets. Un seul et unique fournisseur doit être spécifié.

Vantage.spec.secrets.azure

azure configure Azure Key Vault (via le pilote CSI Secrets Store) comme source des secrets.

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

AzureSecretObjectConfig décrit un objet Key Vault unique associé à un alias de secret.

Vantage.spec.secrets.kubernetes

kubernetes configure les Secrets Kubernetes natifs comme source des secrets.

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

Vantage.spec.updatePolicy

updatePolicy détermine la manière dont l’operator gère les mises à niveau de Vantage. Pas encore pris en charge. L’operator rejette toute ressource qui définit ces champs.

Vantage.spec.updatePolicy.auto

auto active les mises à niveau automatiques de version. Pas encore implémenté.

Vantage.spec.workloads

workloads configure la ConfigMap contenant les données relatives aux charts et aux images

Vantage.spec.workloads.pods

pods configure les métadonnées ajoutées aux pods des charges de travail.

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

ChartPodsConfig définit les métadonnées ajoutées aux pods des charges de travail d’un chart Helm Vantage donné.

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

deployment configure les pods du déploiement du chart.

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

migrator configure les pods de la tâche de l’outil de migration du chart.

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

statefulSet configure les pods du statefulset du chart.

Vantage.spec.workloads.serviceAccounts

serviceAccounts remplace spec.serviceAccountName pour certaines charges de travail.

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

ChartServiceAccountsConfig définit la configuration des comptes de service pour les charges de travail d’un même chart Helm Vantage.

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

deployment configure le compte de service utilisé par le déploiement du chart.

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

migrator configure le compte de service utilisé par la tâche de l’outil de migration du chart.

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

statefulSet configure le compte de service utilisé par le StatefulSet du chart.

Vantage.spec.argocd

argocd configure les ressources Argo CD que l’operator crée pour installer les charges de travail Vantage. Si ce champ est omis, l’installation s’effectue dans le projet « default ».

Vantage.spec.keda

keda configure les paramètres de KEDA. S’il n’est pas spécifié, la prise en charge de KEDA est désactivée.

Vantage.spec.ociMigration

ociMigration configure la copie des artefacts d’un registre source vers une destination avant l’installation. Omettez-le entièrement ou définissez enabled=false pour ignorer la migration. Lorsque la migration est activée, destination est obligatoire.
Validation de destination : !self.host.contains('/') : host ne doit pas contenir de chemin — utilisez le champ repository pour indiquer le chemin du registre
Validation de destination : !self.host.contains('://') : host ne doit pas inclure de schéma (par ex. https://)
Validation de resources : !has(self.claims) || size(self.claims) == 0 : resources.claims n’est pas pris en charge par le job de migration OCI

Vantage.spec.ociMigration.destination

destination indique l’emplacement vers lequel les artefacts sont copiés.

Vantage.spec.ociMigration.destination.credentialsRef

credentialsRef fait référence à un Secret contenant des clés de nom d’utilisateur et de mot de passe, ou à un Secret de type kubernetes.io/dockerconfigjson. S’il est spécifié, ce champ est prioritaire sur username/password.

Vantage.spec.ociMigration.destination.workloadIdentity

workloadIdentity définit les paramètres permettant d’utiliser l’identité de la charge de travail (compte de service Kubernetes) pour accéder au registre.

Vantage.spec.ociMigration.imagePullSecrets[index]

LocalObjectReference contient suffisamment d’informations pour vous permettre de localiser l’objet référencé au sein du même espace de noms.

Vantage.spec.ociMigration.resources

resources correspond aux ressources de calcul du conteneur du job de migration OCI. Par défaut, le CPU n’est pas limité afin que la copie puisse absorber des pics de charge ; définissez une limite de CPU sur les clusters dont les stratégies imposent une limite pour chaque conteneur. Seuls les champs requests et limits sont pris en compte : le job ne déclare aucun resourceClaims au niveau du pod, les revendications sont donc rejetées. Pas encore pris en charge. L’operator rejette toute ressource qui définit ces champs.

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

ResourceClaim référence une entrée de PodSpec.ResourceClaims.

Vantage.spec.ociMigration.sources[index]

ContainerRegistryConfig définit les paramètres de connexion au registre de conteneurs.

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

credentialsRef fait référence à un Secret contenant des clés de nom d’utilisateur et de mot de passe, ou à un Secret de type kubernetes.io/dockerconfigjson. S’il est spécifié, il est prioritaire sur username/password.

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

workloadIdentity définit les paramètres permettant d’utiliser l’identité de la charge de travail (compte de service Kubernetes) pour accéder au registre.

Vantage.spec.smtp

smtp configure le serveur de messagerie SMTP. S’il n’est pas spécifié, Sendgrid est utilisé comme fournisseur de messagerie.

Vantage.spec.storage

storage configure les options de stockage avancées. Pas encore pris en charge. L’operator rejette toute ressource qui définit ces champs.

Vantage.spec.storage.custom

custom configure un backend de stockage personnalisé.

Vantage.spec.storage.s3

s3 configure le backend de stockage S3.

Vantage.spec.storage.s3.buckets

buckets configure les noms des buckets de stockage.

Vantage.spec.storage.s3.scopedClientCredentials

scopedClientCredentials configure le service de stockage pour qu’il fournisse aux clients des identifiants de courte durée définis dans la portée d’un seul stockage (STS AssumeRole) au lieu de sa propre connexion sans clé.

Vantage.spec.techcore

techcore contient la configuration du moteur de traitement TechCore

Vantage.spec.techcore.nnTrainingWorkers

nnTrainingWorkers configure les processus de travail d’entraînement des réseaux de neurones

Vantage.status

status définit l’état observé de Vantage

Vantage.status.conditions[index]

Une condition contient des détails sur un aspect de l’état actuel de cette ressource d’API.

Vantage.status.degradationReasons[index]

DegradationReason représente le motif pour lequel un composant donné de l’installation est dégradé.