> ## 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.

# Métadonnées des charges de travail supplémentaires

> Appliquez des surcharges avancées par chart à des charges de travail Vantage individuelles via le chart Helm vantage-selfhosted.

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.

<Warning>
  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](/fr/vantage/self-hosted/v3.0/performance/autoscaling) dès lors qu'ils répondent à votre besoin.
</Warning>

<h2 id="how-it-works">
  Fonctionnement
</h2>

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](/fr/vantage/self-hosted/v3.0/helm-chart#vantage-selfhosted) et l'[API reference](/fr/vantage/self-hosted/v3.0/api-reference#vantagespecworkloads) 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.

<h2 id="example-fix-the-replica-count-for-one-service">
  Exemple : fixer le nombre de réplicas pour un service
</h2>

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` :

```yaml theme={null}
workloadsConfigMap:
  additionalMetadata:
    charts:
      mail-helm:
        values:
          replicaCount: 2
```

Ajoutez d'autres charts sous `charts`, chacun avec son propre bloc `values`.

<h2 id="caveats">
  Restrictions
</h2>

* **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](/fr/vantage/self-hosted/v3.0/lifecycle).
* **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](/fr/vantage/self-hosted/v3.0/lifecycle#forcing-a-retry).

<h2 id="whats-next">
  Étapes suivantes
</h2>

<CardGroup cols={2}>
  <Card title="Référence du Helm chart" icon="dharmachakra" href="/fr/vantage/self-hosted/v3.0/helm-chart">
    Toutes les valeurs de `vantage-selfhosted`, y compris `workloadsConfigMap.additionalMetadata`.
  </Card>

  <Card title="Mise à l’échelle automatique avec KEDA" icon="arrows-up-down" href="/fr/vantage/self-hosted/v3.0/performance/autoscaling">
    La méthode prise en charge pour adapter les charges de travail Vantage à la demande.
  </Card>
</CardGroup>