Skip to main content
Les métadonnées des charges de travail supplémentaires vous permettent de transmettre vos propres surcharges de valeurs Helm aux charts de charges de travail Vantage individuels. Utilisez-les lorsqu’un déploiement spécifique nécessite un réglage que la custom resource Vantage n’expose pas, par exemple un nombre fixe de réplicas pour un seul service.
Il s’agit d’une fonctionnalité avancée, à n’utiliser qu’en dernier recours. Les surcharges ciblent les valeurs internes des charts des composants Vantage, qui peuvent changer d’une version de Vantage à l’autre sans préavis. Vérifiez vos surcharges à chaque mise à niveau et privilégiez les champs Vantage.spec pris en charge ainsi que la mise à l’échelle automatique KEDA dès lors qu’ils répondent à votre besoin.

​
Fonctionnement

Le chart vantage-selfhosted inclut une ConfigMap workloads qui indique à l’opérateur quels charts installer et de quelle manière. Par défaut, le chart ajoute une clé additional-metadata.yml à cette ConfigMap et la renseigne à partir de la valeur de chart workloadsConfigMap.additionalMetadata. L’opérateur fusionne en profondeur ce contenu avec les métadonnées de charges de travail générées, avant d’installer le chart de chaque composant. Le nom de la clé est défini par vantage.workloads.additionalMetadataKey (Vantage.spec.workloads.additionalMetadataKey). Conservez la valeur par défaut, sauf si vous avez un motif de la renommer. Consultez la référence du Helm chart et l’API reference pour connaître le contrat du champ. Le schéma des surcharges suit le modèle de métadonnées de charges de travail stocké sous la clé workloads-metadata.yml.gotmpl dans cette même ConfigMap. Le chart nomme cette ConfigMap <vantage.workloads.configMap>-<chart version>, par exemple vantage-workloads-3.0.0. Examinez cette clé pour connaître les charts et les chemins de valeurs disponibles dans votre version installée.

​
Exemple : fixer le nombre de réplicas pour un service

Pour remplacer le nombre de réplicas du deployment du chart mail-helm, transmettez les valeurs suivantes lors de l’installation ou de la mise à niveau du chart vantage-selfhosted :
Ajoutez d’autres charts sous charts, chacun avec son propre bloc values.

​
Restrictions

  • Les valeurs du modèle prévalent. Votre additionalMetadata est fusionné en profondeur avec le contenu rendu de workloads-metadata.yml.gotmpl, et le modèle l’emporte en cas de conflit. Vous pouvez ajouter ou modifier les valeurs que le modèle ne définit pas, mais vous ne pouvez pas remplacer celles qu’il définit.
  • order est ignoré. Définir une clé order dans additionalMetadata n’a aucun effet sur l’ordre d’installation des charts.
  • Aucune validation à l’installation. Une valeur additionalMetadata dont le schéma est invalide n’est pas rejetée lors de l’installation du chart. L’échec n’apparaît que dans le status de la ressource Vantage. Vérifiez les conditions de la ressource après avoir appliqué vos modifications ; voir Cycle de vie.
  • Les modifications nécessitent un retraitement. Modifier additionalMetadata sans modifier également la ressource Vantage ne déclenche pas l’application du changement par l’opérateur. Annotez la ressource Vantage avec vantage.abbyy.com/reprocess pour forcer une synchronisation, comme décrit dans Cycle de vie.

​
Étapes suivantes

Référence du Helm chart

Toutes les valeurs de vantage-selfhosted, y compris workloadsConfigMap.additionalMetadata.

Mise à l’échelle automatique avec KEDA

La méthode prise en charge pour adapter les charges de travail Vantage à la demande.