helm package で Release Archive を作成する

チャートのディレクトリはノートパソコン上では問題ありませんが、共有するにはバージョン付きの単一ファイルが必要です。それを生成するのが helm package です。

helm package にチャートのディレクトリを指定すると、すべての内容が配布可能な1つの圧縮アーカイブにまとめられます。

結果として、チャート名とそのバージョンを名前に含む gzip 圧縮された tarball が生成されます。この単一の .tgz ファイルが、Helm がインストールし、リポジトリが配信する単位です。

ファイル名に含まれる番号は appVersion ではなく、Chart.yaml の version フィールドです。Helm はこの値を読み取り、アーカイブの名前付けと並べ替えに使用します。

2つのアーカイブが同じバージョンを持つことがないようにします。パッケージ化する前に毎回 Chart.yaml の version を上げ、利用者がリリースを比較できるようにセマンティックバージョニングに従います。

デフォルトでは .tgz は現在のディレクトリに生成されます。--destination を使うと、パッケージ化したチャートを専用のフォルダーに出力できます。

アーカイブを作成する前に、helm package はチャートを読み込んで検証します。壊れた Chart.yaml や不足しているフィールドがあるとパッケージ化が停止するため、エラーを早期に発見できます。

チャートにサブチャートがある場合は、最初に helm dependency update を実行して、サブチャートを charts/ に取り込み、アーカイブに含めます。

appVersion には、配布するアプリのイメージタグを設定します。これにより、パッケージ化したチャートが実際にデプロイするソフトウェアを記録できます。

アーカイブをテストするためにリポジトリは必要ありません。helm install は、リポジトリからのインストールと同じように、ローカルの .tgz パスを直接受け付けます。

.helmignore ファイルを使うと、.git やエディターのバックアップなどの不要なファイルをパッケージから除外できるため、公開するアーカイブをクリーンで小さく保てます。

チャートで helm package を実行しました。出力ファイル名のバージョンを決めるものは何ですか？

helm package を使ってチャートのディレクトリをバージョン付きの .tgz に変換し、そのたびに Chart.yaml のバージョンを上げました。このアーカイブは共有できる状態です。📦