As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Instalar um chart do Helm em um cluster do Amazon EKS
<a name="using-helm-charts-eks"></a>

Os charts do Helm hospedados no Amazon ECR podem ser instalados nos clusters do Amazon EKS.

**Pré-requisitos**
+ Use a versão mais recente do cliente do Helm. Estas etapas foram escritas usando a versão `3.9.0` do Helm. Para obter mais informações, consulte [Instalação do Helm](https://helm.sh/docs/intro/install/).
+ Você tem pelo menos a versão `1.23.9` ou `2.6.3` da AWS CLI instalada em seu computador. Para obter mais informações, consulte [Instalar ou atualizar a versão mais recente da AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
+ Você enviou um chart do Helm para o seu repositório do Amazon ECR. Para obter mais informações, consulte [Para enviar um chart do Helm por push para um repositório privado do Amazon ECR](push-oci-artifact.md).
+ Você configurou `kubectl` para trabalhar com o Amazon EKS. Para obter mais informações, consulte [Criar um `kubeconfig` para o Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/create-kubeconfig.html) no **Manual do usuário do Amazon EKS**. Se os comados a seguir forem bem-sucedidos para o cluster, a configuração estará correta.

  ```
  kubectl get svc
  ```

**Para instalar um chart do Helm em um cluster do Amazon EKS**

1. Autentique o cliente do Helm para o registro do Amazon ECR no qual o chart do Helm está hospedado. Os tokens de autenticação devem ser obtidos para cada registro usado e são válidos por 12 horas. Para obter mais informações, consulte [Autenticação de registro privado no 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. Instale o chart. {{helm-test-chart}}Substitua pelo seu repositório e pela {{0.1.0}} tag do gráfico do Helm.

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

   A saída deve ser semelhante a esta:

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

1. Verifique a instalação do chart. 

   ```
   helm list -n default
   ```

   Resultado do exemplo:

   ```
   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. (Opcional) Consulte o chart do Helm instalado `ConfigMap`.

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

1. Ao concluir, você pode remover a versão do chart do seu cluster.

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