本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 Amazon EKS 叢集上安裝 Helm Chart
<a name="using-helm-charts-eks"></a>

Amazon ECR 中託管的 Helm Chart 可以安裝在 Amazon EKS 叢集上。

**先決條件**
+ 安裝 Helm 用戶端的最新版本。這些步驟是使用 Helm 版本 `3.9.0` 進行編寫。如需詳細資訊，請參閱[安裝 Helm](https://helm.sh/docs/intro/install/)。
+ 您至少已將 AWS CLI 的版本 `1.23.9` 或 `2.6.3` 安裝在自己的電腦上。如需詳細資訊，請參閱[安裝或更新最新版本的 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)。
+ 您已經將 Helm Chart 推送到您的 Amazon ECR 儲存庫。如需詳細資訊，請參閱[將 Helm Chart 推送至 Amazon ECR 私有儲存庫](push-oci-artifact.md)。
+ 您已設定 `kubectl` 與 Amazon EKS 合作。如需詳細資訊，請參閱《Amazon EKS 使用者指南》****中的[為 Amazon EKS 建立 `kubeconfig`](https://docs.aws.amazon.com/eks/latest/userguide/create-kubeconfig.html)。若下列命令在您的叢集上成功執行，就表示您的設定正確。

  ```
  kubectl get svc
  ```

**在 Amazon EKS 叢集上安裝 Helm Chart**

1. 對您的 Helm 用戶端驗證您的 Helm Chart 託管的 Amazon ECR 登錄檔。所用的每個登錄檔皆必須取得身分驗證字符，字符有效期間為 12 個小時。如需詳細資訊，請參閱[Amazon ECR 中的私有登錄檔身分驗證](registry_auth.md)。

   ```
   aws ecr get-login-password \
        --region {{us-west-2}} | helm registry login \
        --username AWS \
        --password-stdin {{aws_account_id}}.dkr.ecr.{{region}}.amazonaws.com
   ```

1. 安裝圖表。將 {{helm-test-chart}} 取代為您的儲存庫，將 {{0.1.0}} 取代為 Helm Chart 的標籤。

   ```
   helm install ecr-chart-demo oci://{{aws_account_id}}.dkr.ecr.{{region}}.amazonaws.com/{{helm-test-chart}} --version {{0.1.0}}
   ```

   輸出看起來會與此類似：

   ```
   NAME: ecr-chart-demo
   LAST DEPLOYED: Tue May 31 17:38:56 2022
   NAMESPACE: default
   STATUS: deployed
   REVISION: 1
   TEST SUITE: None
   ```

1. 驗證圖表安裝。

   ```
   helm list -n default
   ```

   輸出範例：

   ```
   NAME            NAMESPACE       REVISION        UPDATED                                 STATUS          CHART                   APP VERSION
   ecr-chart-demo  default         1               2022-06-01 15:56:40.128669157 +0000 UTC deployed        helm-test-chart-0.1.0   1.16.0
   ```

1. (選擇性) 請參閱已安裝的 Helm Chart `ConfigMap`。

   ```
   kubectl describe configmap {{helm-test-chart-configmap}}
   ```

1. 完成後，您可以從叢集中移除圖表版本。

   ```
   helm uninstall {{ecr-chart-demo}}
   ```