依存関係

このセクションでは、Chart.yamlに宣言された依存関係のベストプラクティスについて解説します。

バージョン

可能であれば、正確なバージョンを固定するよりバージョンの範囲を使用してください。デフォルトでは、パッチレベルのバージョンマッチを使用することが推奨されています:

version: ~1.2.3

これはバージョン1.2.3とそのバッチバージョンにマッチします。つまり、 ~1.2.3は>= 1.2.3, < 1.3.0と同等になります。

完全なバージョンマッチのシンタックスについては、 semver documentation を参照してください。

上記のバージョンの制約は、プレリリースバージョンにはマッチしません。例えば、version: ~1.2.3はversion: ~1.2.4にマッチしますが、version: ~1.2.3-1 にはマッチしません。以下はパッチレベルのマッチングだけでなく、プレリリースにも対応します:

version: ~1.2.3-0

可能であれば、https://のリポジトリURLを使用し、その後、http://のURLを使用してください。

リポジトリが、そのインデックスファイルに追加されている場合、リポジトリの名前がURLの別名として使われます。alias:もしくは@の後に、リポジトリ名を付けて利用してください。

ファイルのURL（file://...）は固定されたデプロイパイプラインによって組み立てられたチャートのための"特殊なケース"と考えられます。

downloader pluginsを使用する場合、 URLのスキームはプラグインに固有になります。注意としては、チャートの利用者はその依存関係をビルドもしくは更新するために、スキームをサポートするプラグインをインストールする必要があります。

repositoryフィールドが空白の場合、Helmは依存関係の管理操作を行うことができません。その場合、Helmはその依存関係がnameで指定した名前と同じ名前の、 chartsフォルダーのサブディレクトリにあると推測します。

任意の 依存関係には、コンディションもしくはタグを追加するべきです。

コンディションの好ましい書き方:

condition: somechart.enabled

ここではsomechartが依存関係のあるチャートの名前です。

複数のサブチャート（依存関係）が共に任意もしくは取り替え可能な機能を提供する場合、これらのチャートは同じタグを共有するべきです。

例えば、nginxとmemcachedの両方がチャート内で、メインアプリケーション用にパフォーマンスの最適化を提供している場合、そして、その機能を使用する際、その両方が必要になる場合、このようなタグのセクションを含めるべきでしょう:

tags:
  - webaccelerator

これにより、利用者はその機能のオンとオフを一つのタグで切り替えることができます。