> ## 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.
# Valeurs des charts Helm
> Référence des valeurs exposées par les charts Helm vantage-operator et vantage-selfhosted.
Vantage 3.0 auto-hébergé est fourni sous la forme de deux charts Helm : `vantage-operator` (le contrôleur qui surveille la ressource personnalisée `Vantage`) et `vantage-selfhosted` (le chart qui crée la ressource `Vantage` et les manifests associés dans le namespace d’installation choisi). Cette page présente la référence des valeurs pour les deux.
Pour plus de détails sur les CRD au niveau des champs, consultez l’[référence de l’API](/fr/vantage/self-hosted/v3.0/api-reference). Pour connaître la procédure d’installation, choisissez [Azure](/fr/vantage/self-hosted/v3.0/providers/azure) ou [Kubernetes autogéré](/fr/vantage/self-hosted/v3.0/providers/self-managed).
Installez des versions correspondantes de `vantage-operator` et `vantage-selfhosted`. La procédure self-managed actuelle utilise la version `0.70.13` pour les deux charts.
## `vantage-operator`
Installé une seule fois par cluster, dans le namespace de votre choix. L’operator réconcilie automatiquement l’installation de Vantage définie par la ressource personnalisée `Vantage`.
**N’installez qu’une seule instance par cluster.** Le chart utilise des noms de resource à portée cluster non paramétrés (`manager-role` ClusterRole, `manager-rolebinding` ClusterRoleBinding, `controller-manager` ServiceAccount). Une deuxième installation dans le même cluster (même dans un namespace différent) entre en conflit avec ces resources. Voir [Known Limitations](/fr/vantage/self-hosted/v3.0/known-limitations#one-operator-instance-per-cluster).
### Sections de premier niveau
* **`nameOverride` / `fullnameOverride`**: remplacent partiellement ou entièrement le préfixe généré du nom de la ressource.
* **`manager`**: le Deployment de l’opérateur : `replicas`, `image`, `args` du conteneur (l’élection du leader est activée par défaut), `env` (nom du pod et namespace via la downward API), `imagePullSecrets`, contextes de sécurité du pod et du conteneur (non-root, sans élévation de privilèges, système de fichiers racine en lecture seule), `resources` et planification (`affinity`, `nodeSelector`, `tolerations`).
* **`rbacHelpers`**: ClusterRoles administrateur/editor/viewer facultatifs pour utiliser les CRD `vantage.abbyy.com`. Désactivés par défaut.
* **`crd`**: cycle de vie des CRD : installer les CRD avec le chart (`enable`) et les conserver lors de la désinstallation (`keep`).
* **`metrics`**: le point de terminaison `/metrics` protégé par RBAC.
* **`certManager`**: intégration de cert-manager pour les certificats du webhook et du point de terminaison des métriques. Désactivée par défaut.
* **`prometheus`**: un `ServiceMonitor` Prometheus pour le point de terminaison des métriques. Nécessite prometheus-operator dans le cluster. Désactivé par défaut.
### Valeurs notables
Les valeurs par défaut reflètent le `values.yaml` généré par le chart pour cette version. Le chart lui-même fait autorité ; voir [Consulter les valeurs disponibles](#inspecting-available-values).
| Valeur | Utilité |
| ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `manager.replicas` | Nombre de réplicas de l’operator. Valeur par défaut : `1`. |
| `manager.image.repository` / `tag` / `pullPolicy` | Image de conteneur de l’operator. `pullPolicy` a pour valeur par défaut `IfNotPresent`. |
| `manager.imagePullSecrets` | Secrets d’extraction pour l’image de l’operator lorsque votre registry exige une authentification, par exemple `--set "manager.imagePullSecrets[0].name=my-pull-secret"`. Valeur par défaut : `[]`. Non requis sur AKS lorsque `AcrPull` est accordé à l’identité du kubelet. Voir [Accès à l’extraction d’image](/fr/vantage/self-hosted/v3.0/providers/azure#image-pull-access). |
| `manager.args` | Arguments du conteneur. Valeur par défaut : `[--leader-elect]` (élection du leader activée). |
| `manager.resources` | Requêtes et limites de CPU/mémoire. Valeurs par défaut : requêtes `10m` CPU / `64Mi` mémoire, limites `500m` CPU / `128Mi` mémoire. |
| `manager.affinity` / `manager.nodeSelector` / `manager.tolerations` | Contrôles de planification Kubernetes standard pour le pod de l’operator. Vides par défaut. |
| `rbacHelpers.enable` | Installe des rôles pratiques d’administrateur/éditeur/lecteur pour les CRD `vantage.abbyy.com`. Valeur par défaut : `false`. |
| `crd.enable` | Installe les CRD avec le chart. Valeur par défaut : `true`. |
| `crd.keep` | Conserve les CRD (et les ressources `Vantage` qu’elles définissent) dans le cluster lorsque le chart est désinstallé. Valeur par défaut : `true`. |
| `metrics.enable` / `metrics.port` | Expose le point de terminaison `/metrics` protégé par RBAC. Valeurs par défaut : `true` / `8443`. |
| `certManager.enable` | Utilise cert-manager pour les certificats du webhook et du point de terminaison de métriques. Valeur par défaut : `false`. |
| `prometheus.enable` | Crée un `ServiceMonitor` Prometheus pour le point de terminaison de métriques. Nécessite prometheus-operator dans le cluster. Valeur par défaut : `false`. |
Le chart de l’operator n’accepte **aucune** configuration de l’application Vantage. La configuration de l’application se trouve entièrement dans la ressource personnalisée `Vantage`, créée par le chart `vantage-selfhosted`.
## `vantage-selfhosted`
Installé une seule fois par instance Vantage, dans le namespace de votre choix. Ce chart contient la ressource personnalisée `Vantage`, une ConfigMap contenant les données des charges de travail Vantage avec le RBAC associé, ainsi que les CRD et rôles liés à Vantage issus du dépôt d’infrastructure amont d’ABBYY.
La plupart des valeurs sont directement mises en correspondance avec les champs de la ressource personnalisée `Vantage`. Consultez la [référence de l’API](/fr/vantage/self-hosted/v3.0/api-reference) pour le contrat de ces champs.
### Blocs de premier niveau
* **`operator`** : référence à l’installation de l’operator (`namespace` et `controllerManagerServiceAccount`). Le chart utilise ces valeurs pour associer le ClusterRole de lecture des secrets de l’operator au namespace de la release Vantage.
* **`ingress`** : configuration de l’ingress Istio intégré. Définissez `enabled: false` si vous utilisez un autre contrôleur d’ingress.
* **`vantage`** : le contenu de `Vantage.spec` : `databaseProvider`, `dnsRecord`, `mailFrom`, `platformAdminEmail`, `secrets`, `vantageVersion`, `workloads`, `idReadingEnabled`, `keda`, `ociMigration`, `reportingEnabled`, `serviceAccountName`, `smtp`, `storage`, `techcore`.
* **`observability`** : configuration `ServiceMonitor` Prometheus générée par le chart. Il s’agit d’un bloc de premier niveau, et non d’un champ `Vantage.spec`.
### Valeurs obligatoires
| Valeur | Correspond à | Notes |
| ------------------------------------------------------------------------------------- | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `operator.namespace` | N/A | Namespace dans lequel vous avez installé `vantage-operator`. |
| `operator.controllerManagerServiceAccount` | N/A | `ServiceAccount` du contrôleur de l’operator à lier au `ClusterRole` de lecture des `Secret` dans le namespace de cette version de Vantage. Modifiez-le uniquement si l’installation de l’operator utilise un nom différent du nom par défaut. |
| `ingress.tls.secretName` | N/A | Obligatoire lorsque l’ingress Istio intégré est activé. Nom du `Secret` `kubernetes.io/tls` existant dans le namespace de l’ingress gateway externe Istio. N’est pas utilisé lorsque `ingress.enabled` est défini sur `false`. |
| `vantage.dnsRecord` | `Vantage.spec.dnsRecord` | Nom d’hôte DNS auquel Vantage est accessible. |
| `vantage.mailFrom` | `Vantage.spec.mailFrom` | Expéditeur des e-mails sortants. |
| `vantage.platformAdminEmail` | `Vantage.spec.platformAdminEmail` | Administrateur initial de la plateforme. |
| `vantage.secrets.azure` ou `vantage.secrets.kubernetes` | `Vantage.spec.secrets` | Un seul fournisseur de secrets est obligatoire. Voir [Secrets and Key Vault](/fr/vantage/self-hosted/v3.0/secrets-and-keyvault). |
| `vantage.workloads.configMap` / `metadataTemplateKey` / `secretsKey` / `workloadsKey` | `Vantage.spec.workloads` | Pointe vers la `ConfigMap` contenant les données de charge de travail. Le chart lui-même fournit et crée cette `ConfigMap`. |
### Valeurs facultatives
| Valeur | Objectif |
| ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `ingress.enabled` | Active l’ingress intégré au chart. Définissez `false` si vous utilisez Traefik ou un autre contrôleur d’ingress géré par le client. Valeur par défaut : `true`. |
| `vantage.databaseProvider` | Moteur de base de données des services Vantage. Valeurs acceptées : `SqlServer` (par défaut) ou `PostgreSQL` ; sensible à la casse. |
| `vantage.secrets.azure.identityMode` | Une des valeurs suivantes : `workloadIdentity` (par défaut), `podIdentity`, `vmManagedIdentity`. Voir [Secrets and Key Vault](/fr/vantage/self-hosted/v3.0/secrets-and-keyvault#azure-key-vault-provider). |
| `vantage.secrets.azure.userAssignedIdentityID` | ID client de l’UAMI à utiliser lorsque `identityMode` est `vmManagedIdentity`. |
| `vantage.secrets.azure.objects` | Mise en correspondance entre l’alias du secret et `{objectName, objectType, objectVersion}` pour les objets Key Vault dont le nom ne correspond pas à l’alias. |
| `vantage.secrets.kubernetes` | Utilise des ressources Kubernetes `Secret` existantes au lieu d’Azure Key Vault. La mise en correspondance facultative `objects` remplace les noms de secret par défaut. |
| `vantage.smtp.host` / `port` / `login` / `password` | SMTP sortant. Utilisé uniquement lorsqu’il est défini ; SendGrid est utilisé par défaut. Correspond à `Vantage.spec.smtp`. |
| `vantage.serviceAccountName` | `ServiceAccount` par défaut pour les charges de travail Vantage. Correspond à `Vantage.spec.serviceAccountName`. Valeur par défaut : `default`. Pour récupérer des images avec un pull secret, ajoutez le secret à `imagePullSecrets` de ce `ServiceAccount`. Voir [Azure image pull access](/fr/vantage/self-hosted/v3.0/providers/azure#image-pull-access) ou [self-managed registry access](/fr/vantage/self-hosted/v3.0/providers/self-managed#configure-registry-access). |
| `vantage.storage.custom.storageClass` / `size` | Utilise un backend adossé à une `StorageClass` Kubernetes au lieu d’Azure Blob. Correspond à `Vantage.spec.storage.custom`. |
| `vantage.idReadingEnabled` | Active ou désactive les fonctionnalités de lecture d’ID. Valeur par défaut : `false`. |
| `vantage.reportingEnabled` | Active ou désactive les fonctionnalités de reporting SQL Server. Valeur par défaut : `false`. Doit rester à `false` avec PostgreSQL. |
| `vantage.ociMigration.enabled` | Exécute le job de migration OCI. Valeur par défaut : `true`. |
| `vantage.ociMigration.serviceAccountName` | `ServiceAccount` sous lequel s’exécute le job de migration OCI. Correspond à `Vantage.spec.ociMigration.serviceAccountName`. Pour récupérer l’image du job avec un pull secret, ajoutez le secret à `imagePullSecrets` de ce `ServiceAccount`. |
| `vantage.ociMigration.sources[]` | Registres source depuis lesquels copier les artifacts. La source documentée est `sources[0].host=abbyy.jfrog.io` et `sources[0].repository=abbyy-docker`. Définissez `sources[].credentialsRef.name` sur un `Secret` contenant les identifiants du registre ; c’est l’alternative à un `ServiceAccount` de job de migration pour configurer le pull. |
| `vantage.ociMigration.destination.host` / `repository` | Registre de destination dans lequel les artifacts sont copiés. |
| `vantage.keda.enabled` | Indique si [KEDA](https://keda.sh/) est utilisé pour la scalabilité automatique des charges de travail Vantage. Les charts de charge de travail Vantage actuels nécessitent KEDA 2.17.x. Voir [Autoscaling with KEDA](/fr/vantage/self-hosted/v3.0/performance/autoscaling). |
| `observability.prometheus.namespace` | Namespace contenant Prometheus. Valeur par défaut : `observability`. Certains autoscalers Vantage nécessitent le `Service` `prometheus-operated` dans ce namespace. |
| `observability.prometheus.serviceMonitor.create` | Crée le `ServiceMonitor` qui scrape les points de terminaison Vantage `/metrics-text`. Valeur par défaut : `false`. |
| `observability.prometheus.serviceMonitor.selectorMatchLabels` | Labels requis pour que votre instance Prometheus sélectionne le `ServiceMonitor` Vantage. Valeur par défaut : `{}`. |
| `vantage.techcore.versions` | Version(s) du moteur TechCore. |
| `vantage.techcore.nnTrainingWorkers.enabled` / `gpu` | Workers d’entraînement de réseau neuronal. |
## Vérification des valeurs disponibles
Le chart `vantage-operator`, y compris son fichier `values.yaml`, est généré par le plugin Helm de Kubebuilder ; les modèles du chart `vantage-selfhosted`, eux, sont maintenus manuellement. Dans les deux cas, le chart publié fait foi quant à ce qu’accepte une version donnée. Les tableaux de cette page résument un instantané testé ; en cas de divergence entre cette page et le chart, fiez-vous au chart :
```bash theme={null}
# vantage-operator
helm show values $charts_uri/vantage-operator --version $operator_version
# vantage-selfhosted
helm show values $chart_uri/vantage-selfhosted --version $selfhosted_version
```
`$charts_uri`, `$chart_uri` et les variables de version suivent les conventions de [Install variables](/fr/vantage/self-hosted/v3.0/providers/azure#install-variables).
Pour inspecter les manifestes générés avant de les appliquer :
```bash theme={null}
helm template $release_name $chart_uri/vantage-selfhosted \
--version $selfhosted_version \
--namespace $install_namespace \
-f my-values.yaml
```
## Operator vs configuration de Vantage
La configuration se répartit selon une ligne claire :
| Concern | Lives on | Rationale |
| ----------------------------------------------------------------------------------------------------- | -------------------------------------------------- | -------------------------------------------------------------------------- |
| Runtime de l’Operator (réplicas, image, pull secrets, planification, cycle de vie des CRD, métriques) | Valeurs Helm `vantage-operator` | Paramètres opérationnels réservés à l’administrateur du cluster. |
| Application Vantage (secrets, SMTP, charges de travail, stockage, techcore) | Valeurs Helm `vantage-selfhosted` → `Vantage.spec` | La CRD est le contrat de l’API ; le chart n’est qu’un moyen de l’exprimer. |
## Déploiement des workers TechCore
Le chart `vantage-selfhosted` applique une ressource personnalisée `Vantage` ; l’operator déploie ensuite un sous-ensemble des charts de workers TechCore selon `spec.techcore.*`. La sélection s’effectue dans l’operator, mais la matrice ci-dessous fait foi ; utilisez-la pour prévoir quels workers s’exécuteront pour une configuration donnée.
### Convention de nommage
Les charts des workers sont nommés `vtc-{version}-worker-{name}`, où `{version}` provient de `spec.techcore.version` et `{previousVersion}` de `spec.techcore.previousVersion`. Les numéros de version sont de simples préfixes de nom ; ils n’ont aucune signification sémantique pour l’operator. Le jeu des workers disponibles provient de la ConfigMap des charges de travail qu’ABBYY publie avec chaque version.
### Deux phases de déploiement
| Pass | Quand elle s’exécute | Charts concernés |
| ------------------ | ------------------------------------------------- | ------------------------------- |
| Version actuelle | Toujours | `vtc-{version}-worker*` |
| Version précédente | Lorsque `spec.techcore.keepPreviousVersion: true` | `vtc-{previousVersion}-worker*` |
Définir `keepPreviousVersion: true` permet de laisser les workers de la version précédente de TechCore s’exécuter en parallèle des nouveaux, ce qui est utile pour les mises à niveau progressives de TechCore. La CRD exige que `previousVersion` soit défini lorsque cet indicateur est défini sur true.
### Matrice d’inclusion : version actuelle
| Modèle de chart | Inclus si |
| ---------------------------- | ------------------------------------------------------------------- |
| `worker-id-reading` | Jamais (exclu dans toutes les configurations) |
| `nn-extraction-training` | `nnTrainingWorkers.enabled: true` et `nnTrainingWorkers.gpu: false` |
| `nn-extraction-training-gpu` | `nnTrainingWorkers.enabled: true` et `nnTrainingWorkers.gpu: true` |
| `nn-nlp-model-train` | `nnTrainingWorkers.enabled: true` et `nnTrainingWorkers.gpu: false` |
| `nn-nlp-model-train-gpu` | `nnTrainingWorkers.enabled: true` et `nnTrainingWorkers.gpu: true` |
| Tous les autres workers | Toujours |
### Matrice d’inclusion : version précédente
S’exécute uniquement lorsque `spec.techcore.keepPreviousVersion: true`.
| Motif de chart | Inclus lorsque |
| -------------------------------------- | ------------------------------------------------------------------- |
| `worker-id-reading` | Jamais |
| `nn-extraction-training*` (CPU et GPU) | Jamais (l’entraînement NN ne s’exécute que sur la version actuelle) |
| `nn-nlp-model-train*` (CPU et GPU) | Jamais (l’entraînement NN ne s’exécute que sur la version actuelle) |
| Tous les autres workers | Toujours |
La lecture d’ID relève de la plateforme, et non de TechCore. L’indicateur qui la contrôle est `spec.idReadingEnabled`, qui se trouve en dehors de `spec.techcore`. Consultez la référence [`Vantage.spec`](/fr/vantage/self-hosted/v3.0/api-reference#vantagespec).
La matrice détermine uniquement l’inclusion parmi les workers présents dans la ConfigMap des charges de travail pour la version sélectionnée. Les charts absents des charges de travail de cette version ne sont tout simplement pas disponibles pour le déploiement. Par exemple, `worker-ocr-join` n’est actuellement livré que dans l’ensemble de charges de travail de `vtc-2`, donc même avec `keepPreviousVersion: true` et `previousVersion: 2`, il est déployé uniquement sous la forme `vtc-2-worker-ocr-join`.
## Étapes suivantes
Référence détaillée champ par champ de la ressource personnalisée `Vantage`.
Procédure d’installation utilisant ces charts.
Installation avec ingress, maillage, secrets, stockage et services de données gérés par le client.