Amazon S3 に Helm v3 チャートリポジトリを設定する

Helm v3 クライアントをインストールします。

Helm クライアントをローカルシステムにダウンロードしてインストールするには、sudo curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash コマンドを実行します。

インストールを検証します。

helm version --short コマンドを実行して Helm クライアントを検証します。

Helm チャート用の S3 バケットを作成します。　

独自の S3 バケットを作成します。バケットに stable/myapp という名前のフォルダを作成します。このパターンの例では、s3://my-helm-charts/stable/myapp をターゲットチャートリポジトリとして使用しています。

Amazon S3 用の helm-s3 プラグインをインストールします。

クライアントマシンに helm-s3 プラグインをインストールするには、helm plugin install https://github.com/hypnoglow/helm-s3.git コマンドを実行します。

Amazon S3 Helm リポジトリを初期化します。　

ターゲットフォルダを Helm レポジトリとして初期化するには、helm s3 init s3://my-helm-charts/stable/myapp コマンドを使用します。 

このコマンドは、index.yaml ターゲット内にファイルを作成し、保存されているすべてのチャート情報を追跡します。

新しく作成した Helm リポジトリを検証します。　

index.yaml ファイルが正常に作成されたことを確認するには、aws s3 ls s3://my-helm-charts/stable/myapp/ コマンドを実行します。

Amazon S3 リポジトリをクライアントマシンの Helm に追加します。

ターゲットリポジトリのエイリアスを Helm クライアントマシンに追加するには、helm repo add stable-myapp s3://my-helm-charts/stable/myapp/ コマンドを使用します。

Helm チャートのクローンを作成します。

CodeCommit リポジトリにローカル Helm チャートが存在しない場合は、次のコマンドを実行して GitHub リポジトリからそれらをクローンします。 git clone <url_of_your_helm_source_code>.git

Helm チャートをパッケージ化します。

作成またはクローンしたチャートをパッケージ化するには、helm package ./my-app コマンドを使用します。 

例として、このパターンでは my-app チャートを使用しています。このコマンドは、my-app チャートフォルダのすべてのコンテンツを、Chart.yaml ファイルに記載されているバージョン番号で名前が付けられたアーカイブファイルにパッケージ化します。

ローカルパッケージを Amazon S3 Helm リポジトリに保存します。　

ローカルパッケージを Amazon S3 の Helm レポジトリにアップロードするには、helm s3 push ./my-app-0.1.0.tgz stable-myapp コマンドを実行します。

コマンドでは、my-app はグラフのフォルダ名、0.1.0 は Chart.yaml に記載されているチャートのバージョン、stable-myapp はターゲットリポジトリのエイリアスです。

Helm チャートを検索します。

チャートがローカルと Amazon S3 Helm リポジトリの両方に表示されることを確認するには、helm search repo stable-myapp コマンドを実行します。

チャートを変更してパッケージ化します。　

values.yaml で、replicaCount の値を 1 に設定し、次にチャートをパッケージ化し、今度は Chart.yaml のバージョンを 0.1.1 に変更します。バージョン管理は、CI/CD パイプラインで GitVersion や Jenkins のビルド番号などのツールを使用して自動化することで実現するのが理想的です。バージョン番号の自動化は、このパターンの範囲外です。helm package ./my-app/ コマンドを実行して、このパッケージをインストールします。

新しいバージョンを Amazon S3 の Helm リポジトリにプッシュします。　

新しいパッケージのバージョン 0.1.1 を Amazon S3 の my-helm-charts Helm リポジトリにプッシュするには、次のコマンドを実行します。 helm s3 push ./my-app-0.1.1.tgz stable-myapp

Helm チャートを検証します。

チャートがローカルと Amazon S3 Helm リポジトリの両方に表示されることを確認するには、以下のコマンドを実行します。

helm repo update

helm search repo stable-myapp

my-app チャートのすべてのバージョンを検索します。　

使用可能なすべてのバージョンのチャートを表示するには、--versions フラグを使用して helm search repo my-app --versions コマンドを実行します。 

フラグがない場合、Helm はデフォルトでアップロードされた最新バージョンのチャートを表示します。

Amazon S3 Helm リポジトリからチャートをインストールします。

自動インストールはこのパターンの対象外ですが、手動でインストールできます。前のタスクの検索結果には、my-app チャートの複数のバージョンが表示されます。Amazon S3 Helm リポジトリから新しいバージョン (0.1.1) をインストールするには、helm upgrade --install my-app-release stable-myapp/my-app --version 0.1.1 --namespace dev コマンドを使用します

特定のリビジョンの詳細を確認します。

自動ロールバックはこのパターンの対象外ですが、手動でロールバックできます。動作中のバージョンに切り替えたり、ロールバックしたりする前や、リビジョンをインストールする前に追加の検証を行う場合は、helm get values --revision=2 my-app-release コマンドを使用して各リビジョンに渡された値を確認してください。

以前のバージョンにロールバックします。

自動ロールバックはこのパターンの対象外です。以前のリビジョンに手動でロールバックするには、helm rollback my-app-release 1 コマンドを使用します。 

この例では、リビジョン番号 1 にロールバックしています。