**Ajudar a melhorar esta página** 

Para contribuir com este guia de usuário, escolha o link **Editar esta página no GitHub**, disponível no painel direito de cada página.

# Criar o complemento CoreDNS do Amazon EKS
<a name="coredns-add-on-create"></a>

Crie o complemento CoreDNS do Amazon EKS. É necessário ter um cluster antes de criar o complemento. Para ter mais informações, consulte [Criar um cluster do Amazon EKS](create-cluster.md).

1. Veja qual versão do complemento está atualmente instalada no cluster.

   ```
   kubectl describe deployment coredns --namespace kube-system | grep coredns: | cut -d : -f 3
   ```

   Veja um exemplo de saída abaixo.

   ```
   v1.10.1-eksbuild.13
   ```

1. Veja qual tipo de complemento está atualmente instalado no cluster. Dependendo da ferramenta com a qual você criou o cluster, talvez você não tenha o tipo de complemento do Amazon EKS instalado em seu cluster atualmente. Substitua *my-cluster* pelo nome do cluster.

   ```
   aws eks describe-addon --cluster-name my-cluster --addon-name coredns --query addon.addonVersion --output text
   ```

   Se um número de versão for retornado, você tem o tipo de complemento do Amazon EKS instalado no cluster, e não precisa completar as etapas restantes deste procedimento. Se um erro for retornado, você não tem o tipo de complemento do Amazon EKS instalado no cluster. Conclua as etapas restantes desse procedimento para instalá-lo.

1. Salve a configuração do complemento instalado atualmente.

   ```
   kubectl get deployment coredns -n kube-system -o yaml > aws-k8s-coredns-old.yaml
   ```

1. Crie o complemento usando a AWS CLI. Se você quiser usar o Console de gerenciamento da AWS ou `eksctl` para criar o complemento, consulte [Criar um complemento do Amazon EKS](creating-an-add-on.md) e especifique `coredns` como o nome do complemento. Copie o conteúdo a seguir no seu dispositivo. Faça as seguintes modificações no comando, conforme necessário, e execute o comando modificado.
   + Substitua *my-cluster* pelo nome do cluster.
   + Substitua *v1.11.3-eksbuild.1* pela versão mais recente listada na [tabela das versões mais recentes](managing-coredns.md#coredns-versions) da versão do seu cluster.

     ```
     aws eks create-addon --cluster-name my-cluster --addon-name coredns --addon-version v1.11.3-eksbuild.1
     ```

     Se você aplicou configurações personalizadas ao seu complemento atual que entrem em conflito com as configurações padrão do complemento Amazon EKS, a criação poderá falhar. Se a criação falhar, você receberá um erro que poderá ajudar a resolver o problema. Como alternativa, você pode adicionar `--resolve-conflicts OVERWRITE` ao comando anterior. Isso permite que o complemento substitua todas as configurações personalizadas existentes. Depois de criar o complemento, você pode atualizá-lo com suas configurações personalizadas.

1. Verifique se a versão mais recente do complemento para a versão do Kubernetes do cluster foi adicionada ao cluster. Substitua *my-cluster* pelo nome do cluster.

   ```
   aws eks describe-addon --cluster-name my-cluster --addon-name coredns --query addon.addonVersion --output text
   ```

   Pode levar alguns segundos para que a criação do complemento seja concluída.

   Veja um exemplo de saída abaixo.

   ```
   v1.11.3-eksbuild.1
   ```

1. Se você fez configurações personalizadas no complemento original, antes de criar o complemento Amazon EKS, use a configuração que você salvou em uma etapa anterior para atualizar o complemento Amazon EKS com as configurações personalizadas. Para obter instruções sobre como atualizar o complemento, consulte [Atualizar o complemento CoreDNS do Amazon EKS](coredns-add-on-update.md).