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

# 追加ワークロードメタデータ

> vantage-selfhosted Helm チャートを通じて、個々の Vantage ワークロードにチャート単位の高度なオーバーライドを適用します。

追加ワークロードメタデータを使用すると、個々の Vantage ワークロードチャートに独自の Helm 値のオーバーライドを渡せます。単一のサービスにレプリカ数を固定する場合など、`Vantage` カスタムリソースでは公開されていない調整が特定の デプロイメント に必要な場合にご利用ください。

<Warning>
  これは最終手段として用意された高度な機能です。オーバーライドは個々の Vantage コンポーネント チャートの内部値を対象としており、これらの値は Vantage のバージョン間で予告なく変更される可能性があります。アップグレードのたびにオーバーライドを見直し、要件を満たせるものであれば、サポート対象の `Vantage.spec` の fields や [KEDA オートスケーリング](/ja/vantage/self-hosted/v3.0/performance/autoscaling) を優先して使用してください。
</Warning>

<h2 id="how-it-works">
  仕組み
</h2>

`vantage-selfhosted` チャートには、どのチャートをどのようにインストールするかをオペレーターに指示する ワークロード ConfigMap が同梱されています。デフォルトでは、このチャートが ConfigMap に `additional-metadata.yml` キーを追加し、その内容を `workloadsConfigMap.additionalMetadata` チャート値から生成します。オペレーターは、各コンポーネントチャートをインストールする前に、この内容をレンダリング済みの ワークロード メタデータとディープマージします。

キー名は `vantage.workloads.additionalMetadataKey` (`Vantage.spec.workloads.additionalMetadataKey`) で制御します。名前を変更する特別な理由がない限り、デフォルトのままにしてください。field の仕様については、[Helm チャートリファレンス](/ja/vantage/self-hosted/v3.0/helm-chart#vantage-selfhosted)および [API リファレンス](/ja/vantage/self-hosted/v3.0/api-reference#vantagespecworkloads)を参照してください。

オーバーライドのスキーマは、同じ ConfigMap 内の `workloads-metadata.yml.gotmpl` キーに格納されている ワークロード メタデータテンプレートに従います。この ConfigMap の名前は `<vantage.workloads.configMap>-<chart version>` の形式になります (例: `vantage-workloads-3.0.0`) 。インストール済みのバージョンで利用できるチャートと値のパスは、このキーを確認してください。

<h2 id="example-fix-the-replica-count-for-one-service">
  例: 特定のサービスのレプリカ数を固定する
</h2>

`mail-helm` チャートのデプロイメントのレプリカ数を上書きするには、`vantage-selfhosted` チャートのインストールまたはアップグレード時に次の値を渡します。

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

`charts` の下にチャートをさらに追加し、それぞれに独自の `values` ブロックを指定します。

<h2 id="caveats">
  注意事項
</h2>

* **テンプレートの値が優先されます。** `additionalMetadata` はレンダリング済みの `workloads-metadata.yml.gotmpl` の内容とディープマージされ、競合した場合はテンプレート側が優先されます。テンプレートが設定していない値を追加・変更することはできますが、テンプレートが設定している値を上書きすることはできません。
* **`order` は無視されます。** `additionalMetadata` に `order` キーを定義しても、チャートのインストール順序には影響しません。
* **インストール時の検証は行われません。** スキーマが不正な `additionalMetadata` の値であっても、チャートのインストール時には拒否されません。エラーは `Vantage` リソースの `status` にのみ現れます。変更を適用した後は、リソースの conditions を確認してください。詳細は[ライフサイクル](/ja/vantage/self-hosted/v3.0/lifecycle)を参照してください。
* **変更には再処理が必要です。** `Vantage` リソース自体を変更せずに `additionalMetadata` だけを編集しても、オペレーターによる変更の適用はトリガーされません。[ライフサイクル](/ja/vantage/self-hosted/v3.0/lifecycle#forcing-a-retry)の説明に従い、`Vantage` リソースに `vantage.abbyy.com/reprocess` アノテーションを付与して同期を強制してください。

<h2 id="whats-next">
  次のステップ
</h2>

<CardGroup cols={2}>
  <Card title="Helm チャートリファレンス" icon="dharmachakra" href="/ja/vantage/self-hosted/v3.0/helm-chart">
    `workloadsConfigMap.additionalMetadata` を含む、`vantage-selfhosted` のすべての値。
  </Card>

  <Card title="KEDA によるオートスケーリング" icon="arrows-up-down" href="/ja/vantage/self-hosted/v3.0/performance/autoscaling">
    需要に応じて Vantage のワークロードをスケールさせる、サポート対象の方法。
  </Card>
</CardGroup>