Skip to main content
追加ワークロードメタデータを使用すると、個々の Vantage ワークロードチャートに独自の Helm 値のオーバーライドを渡せます。単一のサービスにレプリカ数を固定する場合など、Vantage カスタムリソースでは公開されていない調整が特定の デプロイメント に必要な場合にご利用ください。
これは最終手段として用意された高度な機能です。オーバーライドは個々の Vantage コンポーネント チャートの内部値を対象としており、これらの値は Vantage のバージョン間で予告なく変更される可能性があります。アップグレードのたびにオーバーライドを見直し、要件を満たせるものであれば、サポート対象の Vantage.spec の fields や KEDA オートスケーリング を優先して使用してください。

仕組み

vantage-selfhosted チャートには、どのチャートをどのようにインストールするかをオペレーターに指示する ワークロード ConfigMap が同梱されています。デフォルトでは、このチャートが ConfigMap に additional-metadata.yml キーを追加し、その内容を workloadsConfigMap.additionalMetadata チャート値から生成します。オペレーターは、各コンポーネントチャートをインストールする前に、この内容をレンダリング済みの ワークロード メタデータとディープマージします。 キー名は vantage.workloads.additionalMetadataKey (Vantage.spec.workloads.additionalMetadataKey) で制御します。名前を変更する特別な理由がない限り、デフォルトのままにしてください。field の仕様については、Helm チャートリファレンスおよび API リファレンスを参照してください。 オーバーライドのスキーマは、同じ ConfigMap 内の workloads-metadata.yml.gotmpl キーに格納されている ワークロード メタデータテンプレートに従います。この ConfigMap の名前は <vantage.workloads.configMap>-<chart version> の形式になります (例: vantage-workloads-3.0.0) 。インストール済みのバージョンで利用できるチャートと値のパスは、このキーを確認してください。

例: 特定のサービスのレプリカ数を固定する

mail-helm チャートのデプロイメントのレプリカ数を上書きするには、vantage-selfhosted チャートのインストールまたはアップグレード時に次の値を渡します。
charts の下にチャートをさらに追加し、それぞれに独自の values ブロックを指定します。

注意事項

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

次のステップ

Helm チャートリファレンス

workloadsConfigMap.additionalMetadata を含む、vantage-selfhosted のすべての値。

KEDA によるオートスケーリング

需要に応じて Vantage のワークロードをスケールさせる、サポート対象の方法。