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 nécessite que databaseProvider soit défini sur ‘SqlServer’ ; la fonctionnalité de rapports est propre à SQL Server et n’est pas disponible 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 et unique politique 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 au maximum peut être spécifié

Vantage.spec.secrets

secrets sélectionne et configure le fournisseur de secrets. Vous devez spécifier un et un seul fournisseur.

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 sur lequel repose un alias de secret.

Vantage.spec.secrets.kubernetes

kubernetes configure les Secrets natifs de Kubernetes comme source de 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 le 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 chart Helm Vantage donné.

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. S’il est omis, l’installation s’effectue dans le projet « default ».
Validation de namespace : self == oldSelf : namespace est immuable

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 entièrement ce bloc 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 le chemin du registre
Validation de destination : !self.host.contains('://') : host ne doit pas inclure de schéma (par exemple, 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 désigne 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 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 politiques en imposent une pour chaque conteneur. Seuls requests et limits sont pris en compte : le job ne déclarant aucun resourceClaims au niveau du pod, les claims sont rejetés. 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 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 compartiments 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.spec.techcore.workers

workers permet d’ajuster les déploiements des processus de traitement TechCore ainsi que leur mise à l’échelle automatique. Chaque champ ne prend effet que lorsque keda.enabled vaut true, à l’exception de replicaCount, qui définit également le nombre de réplicas du Deployment.

Vantage.spec.techcore.workers.defaults

defaults s’applique à chaque processus de traitement TechCore de chaque version déployée.

Vantage.spec.techcore.workers.defaults.resources

resources définit les ressources attribuées à un processus de traitement. Ces valeurs par processus de traitement servent de base au calcul des totaux du guide de dimensionnement ; les modifier modifie donc les besoins de l’installation.

Vantage.spec.techcore.workers.defaults.scaling

scaling configure le comportement de mise à l’échelle automatique, qui reste sans effet si keda.enabled n’est pas activé.

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

cron maintient les processus de traitement actifs pendant les heures ouvrées et leur permet de redescendre à zéro en dehors de ces heures. Nécessite scaleInactiveToZero et n’a aucun effet sur les processus de traitement qui ne servent que la file d’attente de priorité basse.

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

WorkerConfig définit les paramètres ajustables d’un processus de traitement TechCore. Les champs non définis conservent la valeur par défaut propre au chart du processus de traitement.

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

resources définit les ressources allouées à un processus de traitement. Ce sont les valeurs par processus de traitement à partir desquelles sont calculés les totaux du guide de dimensionnement : les modifier change donc les besoins de l’installation.

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

scaling configure le comportement de mise à l’échelle automatique, qui reste sans effet si keda.enabled n’est pas activé.

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

cron maintient les processus de traitement actifs pendant les heures ouvrées et leur permet de redescendre à zéro en dehors de ces heures. Nécessite scaleInactiveToZero et reste sans effet sur les processus de traitement qui desservent uniquement la file d’attente de priorité basse.

Vantage.status

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

Vantage.status.conditions[index]

Une condition contient les détails d’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é.