**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.

# Conecte um cluster Kubernetes a um console de gerenciamento do Amazon EKS com o Amazon EKS Connector
<a name="eks-connector"></a>

Você pode usar o Amazon EKS Connector para registrar e conectar à AWS qualquer cluster do Kubernetes compatível e visualizá-lo no console do Amazon EKS. Quando um cluster é conectado, você pode ver o status, a configuração e as workloads desse cluster no console do Amazon EKS. É possível usar esse recurso para visualizar clusters conectados no console do Amazon EKS, mas não é possível gerenciá-los. O Amazon EKS Connector também é um [projeto de código aberto no Github](https://github.com/aws/amazon-eks-connector). Para obter conteúdo técnico adicional, incluindo perguntas frequentes e solução de problemas, consulte [Solução de problemas do Amazon EKS Connector](troubleshooting-connector.md).

O Amazon EKS Connector pode conectar os seguintes tipos de clusters do Kubernetes ao Amazon EKS.
+ Clusters do Kubernetes on-premises
+ Clusters autogerenciados que estão em execução no Amazon EC2
+ Clusters gerenciados de outros provedores de nuvem

## Considerações sobre o Amazon EKS Connector
<a name="connect-cluster-reqts"></a>

Antes de usar o Amazon EKS Connector, entenda:
+ Você deve ter privilégios administrativos no cluster do Kubernetes para conectar o cluster ao Amazon EKS.
+ O cluster do Kubernetes deve ter nós de processamento do Linux 64 bits (x86) presentes antes de se conectar. Os nós de processamento do ARM não são compatíveis.
+ Você deve ter nós de processamento no cluster do Kubernetes que tenham acesso de saída a endpoints `ssm.` e `ssmmessages.` do Systems Manager. Para obter mais informações, consulte [os endpoints do Systems Manager](https://docs.aws.amazon.com/general/latest/gr/ssm.html) no * AWS General Reference*.
+ Por padrão, é possível conectar até dez clusters em uma região. Você pode solicitar um aumento pelo [console da cota de serviço](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html). Consulte [Solicitar um aumento de cota](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html) para obter mais informações.
+ Somente as APIs `RegisterCluster`, `ListClusters`, `DescribeCluster` e `DeregisterCluster` do Amazon EKS são compatível com clusters externos do Kubernetes.
+ É necessário ter as seguintes permissões para registrar um cluster:
  + eks:RegisterCluster
  + ssm:CreateActivation
  + ssm:DeleteActivation
  + iam:PassRole
+ É necessário ter as seguintes permissões para cancelar o registro de um cluster:
  + eks:DeregisterCluster
  + ssm:DeleteActivation
  + ssm:DeregisterManagedInstance

## Funções do IAM necessárias para o Amazon EKS Connector
<a name="connector-iam-permissions"></a>

O uso do Amazon EKS Connector requer estas duas funções do IAM:
+ O perfil vinculado ao serviço do [Amazon EKS Connector](using-service-linked-roles-eks-connector.md) é criado quando você registra o cluster.
+ Você deve criar o perfil do IAM de agente do Amazon EKS Connector. Para mais detalhes, consulte [Função do IAM do conector do Amazon EKS](connector-iam-role.md).

Para habilitar a permissão de visualização de cluster e workload para as [entidades principais do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html#iam-term-principal), é necessário aplicar `eks-connector` e as funções de cluster do Amazon EKS Connector ao cluster. Siga as etapas em [Conceder acesso para visualizar os recursos do cluster do Kubernetes em um console do Amazon EKS](connector-grant-access.md).