Skip to main content
デフォルトSkillは、Vantage Skill Catalog に含まれる組み込みの読み取り専用Skillです。Vantage の各リリースには約 100 個のデフォルトSkillが含まれており、その多くには複数のバージョンがあります。すべてのバージョンをインストールすると、1 時間以上かかることもあります。インストールするSkillとバージョンは、vantage-selfhosted チャートの defaultSkills の値で制御します。
インストール済みのデフォルトSkillは削除できません。values からSkillやバージョンを削除しても、インストール済みのものはそのまま残ります。そのため、インストールするSkillは初回インストールの前に決めておいてください。以降の変更で行えるのは、Skillの追加のみです。

モードを選択する

defaultSkills.mode を次のいずれかに設定します。 デフォルトSkillをもとに作成したSkillは、そのデフォルトSkillがインストールされていないと動作しなくなります。そのため、デフォルトは all になっています。minimal または custom は、作成したSkillがどのデフォルトSkillに依存しているかを把握している場合にのみ使用してください。
vantage.minimalInstall が制御するのはワークロードのサイジングのみで、インストールされるSkillのセットには影響しません。リリース 2026.10.16 より前は、minimalInstall: true を指定すると、インストールされるSkillも各Skillの最新バージョンのみに限定されていました。最小構成のインストールを使用している場合は、Skillのセットを縮小したまま維持するために、アップグレード前に defaultSkills.mode: minimal を設定してください。minimalInstall が true で、かつ defaultSkills.mode が all の場合、インストール時またはアップグレード時にチャートから警告が出力されます。

スキル ID を確認する

custom モードでは、Skill を ID で識別します。現在のリリースについては、このページ末尾のカタログを参照してください。 Skill、ID、バージョンはリリースごとに異なる場合があります。各 vantage-selfhosted チャートには、対応するリリースのカタログが files/default-skills.yml として含まれています。別のバージョンのチャートをインストールする場合は、そのチャートに含まれるカタログを参照してください。カタログを出力するには、チャートをプルしてファイルを展開します。
各エントリには、SkillのID、名前、および利用可能なバージョンが含まれています:
$chart_uri と $selfhosted_version は、インストール変数の規則に従って指定します。

任意のSkillを選択してインストールする

インストールするSkillを defaultSkills.skills に列挙します。各Skillはカタログに記載されているIDで指定します。
  • versions はオプションです。省略すると、カタログ内の最新バージョンがインストールされます。all を指定するとカタログ内のすべてのバージョンがインストールされ、リストを指定するとそのリストに含まれるバージョン番号のみがインストールされます。
  • カタログに存在しない ID またはバージョンを指定すると、チャートのレンダリングが失敗します。このため、誤った値はインストール時またはアップグレード時に検出されます。
  • skills リストを空にすると、デフォルトSkillは 1 つもインストールされません。
  • Process skill は他の Skill を参照します。Process skill を含める場合は、その Process skill が参照するすべての Skill も含めてください。

インストール後に Skill を追加する

1

values を更新してチャートをアップグレードする

defaultSkills.skills に Skill を追加するか defaultSkills.mode を変更し、vantage-selfhosted リリースに対して helm upgrade を実行します。
2

同期をトリガーする

values を変更しただけでは同期はトリガーされません。Vantage リソースにアノテーションを付けて、再処理させます。
オペレーターが OCI 移行を再実行してワークロードを再生成し、デフォルトSkill のインストールを更新します。インストールされるのは未インストールのバージョンのみで、移行先レジストリにすでに存在するアーティファクトが再コピーされることはありません。
3

Skill がインストールされたことを確認する

更新がクラスターに反映されるまで、数分かかる場合があります。まず、新しい Skill が DefaultSkillInstallation リソースに含まれていることを確認します。
リソースの Installed 状態は、以前の選択内容に基づく True のままになっている可能性があります。そのため、kubectl wait --for=condition=Installed では、インストール完了前に待機が終了してしまうことがあります。代わりに、Installed 状態の observedGeneration がリソースの metadata.generation と一致するまで待機してください。

既知の制限事項

  • Skill を選択しても OCI 移行の時間は短縮されません。 OCI 移行では、すべてのモードについて、すべてのデフォルトSkill のバージョンの画像がコピーされます。選択する Skill を減らすとインストール時間は短縮されますが、移行時間やレジストリの使用容量は変わりません。
  • 選択内容はチャートの値にのみ保持されます。 Vantage リソースには選択内容が含まれないため、リソースを直接編集して Skill のセットを変更することはできません。
  • Installed: True は最後に実行したインストールの状態を示します。 選択内容が再度変更されるまで、データベースから削除された Skill や、復元されたデータベースの状態は反映されません。また、失敗したインストールは自動では再試行されません。再試行するには、選択内容を変更するか、Skill インストーラーのオペレーターを再起動してください。
  • ワークロードの追加メタデータが優先されます。 workloadsConfigMap.additionalMetadata のエントリで charts.skill-installer-def-installation.values.defaultSkills を設定すると、defaultSkills で指定した選択内容は上書きされます。詳細については、次を参照してください:ワークロードの追加メタデータ。

カタログ

次のテーブルは、現在のリリースに含まれるデフォルトSkillの一覧です。defaultSkills.skills で指定する ID とバージョンもあわせて記載しています。Versions 列には、all でインストールされるすべてのバージョンが記載されています。versions を指定しない custom エントリでは、一覧の最後のバージョンがインストールされます。minimal モードでは、各 Skill の最後のバージョンに加えて、チャートの files/default-skills.minimal.yml に記載されている追加バージョンがインストールされます。別のバージョンのチャートをインストールする場合は、スキル ID の確認の説明に従って、そのチャートのカタログを参照してください。 vantage-selfhosted チャート 0.91.1 (リリース 2026.10.16) のカタログです。

次のステップ

Helm チャートリファレンス

vantage-selfhosted のすべての値と、お使いのチャートバージョンでそれらを確認する方法について説明します。

ライフサイクル

オペレーターが Vantage リソースをリコンサイルする仕組みと、再試行を強制的に実行する方法について説明します。