helm search repo で Chart を探す

リポジトリを追加したら、helm search repoでキャッシュ済みのインデックスを検索し、入力したキーワードに一致するチャートを見つけられます。

repoという単語が重要です。これは、ローカルに追加したリポジトリだけを検索します。別のサブコマンドである search hub は、公開インターネットを検索します。

結果には、チャートのNAME、CHART VERSION、同梱アプリケーションの APP VERSION、短い説明が、該当するチャートごとに1行で表示されます。

チャートバージョンはパッケージングを管理するもので、アプリバージョンは nginx 自体のような、内部に含まれるソフトウェアのバージョンです。両者は別々のタイムラインで更新されます。

キーワードはチャート名と説明に対して照合されます。databaseで検索すると、名前が完全一致しなくても PostgreSQL、MySQL などが見つかることがあります。

デフォルトでは、チャートごとに最新バージョンだけが表示されます。--versionsを追加すると、利用可能なすべてのバージョンを一覧表示でき、古いバージョンを固定したい場合に便利です。

キーワードの前にリポジトリ名を付けると、検索範囲を限定できます。bitnami/を付けると、そのリポジトリのチャートだけが結果に表示されます。

出力が空の場合は、通常、キーワードが一致していないか、そのチャートを含むリポジトリが追加されていないことを意味します。helm repo updateを実行してから、もう一度検索してみましょう。

NAME 列の値は、そのまま install に渡せます。bitnami/nginxを helm install にコピーすれば、そのチャートをデプロイできます。

検索では大文字と小文字が区別されないため、Nginx と nginx で同じチャートが見つかります。より正確なパターンを指定するための--regexpフラグにも対応しています。

必ず最初に検索して、正確なチャート名と存在するバージョンを確認しましょう。これにより、インストール時の入力ミスやチャートが見つからないことによるエラーを防げます。

すでに追加したリポジトリにチャートが存在することを確認したいとします。どのコマンドが適していますか。

helm search repoは、追加済みのリポジトリからキーワードでチャートを検索し、名前とバージョンを表示します。インストール前に--versionsを使えば、すべてのバージョンを一覧表示できます。🔍