**このページの改善にご協力ください** 

このユーザーガイドに貢献するには、すべてのページの右側のペインにある「**GitHub でこのページを編集する**」リンクを選択してください。

# Helm を使用して Amazon EKS にアプリケーションをデプロイする
<a name="helm"></a>

Kubernetes 用の Helm パッケージマネージャーを使用すると、Kubernetes クラスターにアプリケーションをインストールし、管理できます。詳細については[Helm のドキュメント](https://docs.helm.sh/)を参照してください。このトピックはHelm バイナリをインストールして実行する際に役立ちます。これにより、ローカルシステムで Helm CLI を使用してチャートをインストールおよび管理することができます。

**重要**  
Amazon EKS クラスターに Helm チャートをインストールするにはあらかじめ Amazon EKS で動作するように `kubectl` を設定しておく必要があります。この設定をまだ行っていない場合は続行する前に「[kubeconfig ファイルを作成して kubectl を EKS クラスターに接続する](create-kubeconfig.md)」を参照してください。次のコマンドがクラスターに対して成功した場合は正しく設定されています。  

```
kubectl get svc
```

1. クライアントオペレーティングシステムに適したコマンドを実行してください。
   + macOS で [Homebrew](https://brew.sh/) を使用している場合は次のコマンドを使用してバイナリをインストールします。

     ```
     brew install helm
     ```
   + その他のインストールオプションについては、Helm ドキュメントの「[Helm のインストール](https://helm.sh/docs/intro/install/)」を参照してください。
**注記**  
最初に `openssl` をインストールする必要があるというメッセージを受け取った場合、次のコマンドを使用してインストールできます。

```
sudo yum install openssl
```

1. `PATH` で新しいバイナリを取得するため、現在のターミナルウィンドウを閉じて新しいターミナルウィンドウを開きます。

1. インストールした Helm のバージョンを確認してください。

   ```
   helm version --template='{{ .Version }}{{ "\n" }}'
   ```

   出力例は次のとおりです。

   ```
   v3.17.2
   ```

1. インストールされているバージョンがクラスターのバージョンと互換性があることを確認してください。詳細については、「[Supported Version Skew](https://helm.sh/docs/topics/version_skew/#supported-version-skew)」を確認してください。例えば、`3.17.x` で稼働している場合、サポート対象の Kubernetes バージョンは `1.29.x` ～ `1.32.x` の範囲外であってはなりません。

1. この時点で、任意の Helm コマンド (`helm install chart-name ` など 実行して、クラスター内の Helm チャートをインストール、変更、削除、またはクエリすることができます。Helm を初めて使用する場合で、インストールするチャートがないときは次の操作を実行できます：
   + サンプルチャートをインストールして試します。Helm の「[クイックスタートガイド](https://helm.sh/docs/intro/quickstart/)」の「[サンプルチャートをインストールする](https://helm.sh/docs/intro/quickstart#install-an-example-chart)」を参照してください。
   + サンプルチャートを作成し、Amazon ECR にプッシュします。詳細については「*Amazon Elastic Container Registry ユーザーガイド*」の「[Pushing a Helm chart (Helm チャートをプッシュする)](https://docs.aws.amazon.com/AmazonECR/latest/userguide/push-oci-artifact.html)」を参照してください。
   + [eks-charts](https://github.com/aws/eks-charts#eks-charts) GitHub リポジトリか [ArtifactHub](https://artifacthub.io/packages/search?page=1&repo=aws) から Amazon EKS チャートをインストールします。