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

# Metadaten für zusätzliche Workloads

> Erweiterte Überschreibungen pro Chart auf einzelne Vantage-Workloads über das Helm-Chart vantage-selfhosted anwenden.

Mit den Metadaten für zusätzliche Workloads können Sie eigene Überschreibungen von Helm-Werten an einzelne Vantage-Workload-Charts übergeben. Nutzen Sie diese Möglichkeit, wenn ein bestimmtes Deployment eine Anpassung erfordert, die die Custom-Resource `Vantage` nicht bereitstellt – etwa eine feste Anzahl von Replicas für einen einzelnen Service.

<Warning>
  Dies ist eine fortgeschrittene Funktion, die nur als letztes Mittel dienen sollte. Überschreibungen wirken auf die internen Werte einzelner Charts von Vantage-Komponenten, die sich zwischen Vantage-Versionen ohne Vorankündigung ändern können. Prüfen Sie Ihre Überschreibungen bei jedem Upgrade und bevorzugen Sie die unterstützten Felder unter `Vantage.spec` sowie die [automatische Skalierung mit KEDA](/de/vantage/self-hosted/v3.0/performance/autoscaling), soweit diese Ihren Bedarf abdecken.
</Warning>

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

Das Chart `vantage-selfhosted` enthält eine Workloads-ConfigMap, die dem Operator mitteilt, welche Charts wie installiert werden sollen. Standardmäßig fügt das Chart dieser ConfigMap den Schlüssel `additional-metadata.yml` hinzu und befüllt ihn aus dem Chart-Wert `workloadsConfigMap.additionalMetadata`. Der Operator führt diesen Inhalt per Deep Merge mit den gerenderten Workloads-Metadaten zusammen, bevor er das jeweilige Komponenten-Chart installiert.

Der Name des Schlüssels wird über `vantage.workloads.additionalMetadataKey` (`Vantage.spec.workloads.additionalMetadataKey`) gesteuert. Belassen Sie ihn beim Standardwert, sofern Sie keinen Grund haben, ihn umzubenennen. Den Feldvertrag finden Sie in der [Helm-Chart-Referenz](/de/vantage/self-hosted/v3.0/helm-chart#vantage-selfhosted) und in der [API-Referenz](/de/vantage/self-hosted/v3.0/api-reference#vantagespecworkloads).

Das Schema für Überschreibungen richtet sich nach der Vorlage für Workloads-Metadaten, die in derselben ConfigMap unter dem Schlüssel `workloads-metadata.yml.gotmpl` hinterlegt ist. Das Chart benennt diese ConfigMap nach dem Muster `<vantage.workloads.configMap>-<chart version>`, zum Beispiel `vantage-workloads-3.0.0`. Prüfen Sie diesen Schlüssel, um zu sehen, welche Charts und Wertepfade in Ihrer installierten Version verfügbar sind.

<h2 id="example-fix-the-replica-count-for-one-service">
  Beispiel: Anzahl der Replicas für einen Service festlegen
</h2>

Um die Anzahl der Deployment-Replicas für den Chart `mail-helm` zu überschreiben, übergeben Sie beim Installieren oder Aktualisieren des Charts `vantage-selfhosted` die folgenden Werte:

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

Fügen Sie weitere Charts unter `charts` hinzu, jeweils mit einem eigenen `values`-Block.

<h2 id="caveats">
  Einschränkungen
</h2>

* **Werte aus der Vorlage haben Vorrang.** Ihre `additionalMetadata` werden per Deep Merge mit dem gerenderten Inhalt von `workloads-metadata.yml.gotmpl` zusammengeführt, wobei die Vorlage bei Konflikten Vorrang hat. Sie können Werte hinzufügen oder ändern, die die Vorlage nicht setzt; Werte, die sie setzt, lassen sich jedoch nicht überschreiben.
* **`order` wird ignoriert.** Ein in `additionalMetadata` definierter `order`-Schlüssel hat keine Auswirkung auf die Installationsreihenfolge der charts.
* **Keine Validierung zur Installationszeit.** Ein `additionalMetadata`-Wert mit einem ungültigen schema wird bei der Installation des chart nicht abgelehnt. Der Fehler wird ausschließlich im `status` der `Vantage`-Ressource sichtbar. Prüfen Sie die conditions der Ressource, nachdem Sie Änderungen angewendet haben; siehe [Lifecycle](/de/vantage/self-hosted/v3.0/lifecycle).
* **Änderungen erfordern eine erneute Verarbeitung.** Wenn Sie `additionalMetadata` bearbeiten, ohne zugleich die `Vantage`-Ressource zu ändern, wendet der Operator die Änderung nicht an. Versehen Sie die `Vantage`-Ressource mit der Annotation `vantage.abbyy.com/reprocess`, um eine Synchronisierung zu erzwingen, wie unter [Lifecycle](/de/vantage/self-hosted/v3.0/lifecycle#forcing-a-retry) beschrieben.

<h2 id="whats-next">
  Wie geht es weiter
</h2>

<CardGroup cols={2}>
  <Card title="Helm-Chart-Referenz" icon="dharmachakra" href="/de/vantage/self-hosted/v3.0/helm-chart">
    Alle Werte von `vantage-selfhosted`, einschließlich `workloadsConfigMap.additionalMetadata`.
  </Card>

  <Card title="Automatische Skalierung mit KEDA" icon="arrows-up-down" href="/de/vantage/self-hosted/v3.0/performance/autoscaling">
    Der unterstützte Weg, Vantage-Workloads bedarfsgerecht zu skalieren.
  </Card>
</CardGroup>