Chart Repository をホストする

アーカイブと index.yaml が用意できたら、リポジトリのホスティングとは、それらのファイルを HTTP 経由でアクセス可能にすることです。Helm はそれらをダウンロードできれば動作します。

Helm リポジトリにはサーバー側のロジックはありません。.tgz ファイルと index.yaml を返す通常の 静的ファイルサーバー であれば、どれでも有効なリポジトリになります。

チームでは、チャートを S3 や Google Cloud Storage のようなバケットに置くことがよくあります。公開読み取りアクセスを設定すれば、そのバケットを実用的なチャートリポジトリとして使えます。

無料でよく使われる選択肢は GitHub Pages です。.tgz ファイルと index.yaml をブランチにコミットして Pages を有効にすれば、ホスティングされたリポジトリが完成します。

配信するアドレスは、index.yaml に埋め込んだ --url と一致していなければなりません。一致しないと、ダウンロードが 404 エラーで失敗します。

利用者は helm repo add を使ってリポジトリを登録し、配信 URL を指すローカル用の短い名前を付けます。

追加した後、利用者は helm repo update を実行してインデックスを取得し、その後 helm search repo を実行して公開されているチャートを見つけます。

インストールには repo/chart という省略形式を使います。Helm はキャッシュされたインデックスを読み取り、ホストから適切な .tgz をダウンロードしてデプロイします。

手動でコミットする代わりに API 経由でアップロードしたい場合は、ChartMuseum が使えます。これはチャートを保存し、インデックスを自動的に再構築するオープンソースのサーバーです。

チャートは必ず HTTPS 経由でホストします。転送中の改ざんを防げます。また、リポジトリの追加時に安全な URL を要求する構成も多くあります。

インデックスにまだ記載されている公開済みの .tgz を削除してはいけません。既存のインストールやロールバックは、その特定のアーカイブをダウンロードできる状態に依存しています。

チームメンバーが helm repo add を実行しましたが、インストールすると .tgz の取得が 404 になります。考えられる原因は何ですか？

Helm リポジトリは、index.yaml に記載された配信 URL と一致する URL で HTTPS 経由により配信される、単なる 静的ファイル だと学びました。利用者はそこから追加、更新、インストールを行います。🌐