Anexar o cluster de EKS

Visão geral

Para anexar um cluster, conecte-o ao Google Cloud registrando-o no gerenciamento de frota do Google Cloud e instalando o software de clusters anexado ao GKE.

É possível anexar um cluster usando a gcloud CLI ou o Terraform. Para aprender como criar e anexar um cluster do EKS usando o Terraform, confira Repositório de amostras do GitHub para clusters anexados ao GKE

Para anexar um cluster do EKS usando a gcloud, execute o etapas a seguir.

Pré-requisitos

Verifique se o cluster atende aos requisitos de cluster.

Ao anexar o cluster, você precisa especificar:

uma região administrativa do Google Cloud compatível;
uma versão da plataforma.

A região administrativa é uma região do Google Cloud para administrar o cluster anexado. É possível escolher qualquer região compatível, mas a prática recomendada é escolher a região geograficamente mais próxima do cluster. Nenhum dado de usuário é armazenado na região administrativa.

A versão da plataforma é a versão dos clusters anexados ao GKE a serem instalados no cluster. É possível listar todas as versões compatíveis executando o seguinte comando:

gcloud container attached get-server-config  \
  --location=GOOGLE_CLOUD_REGION

Substitua GOOGLE_CLOUD_REGION pelo nome do local do Google Cloud em que o cluster será administrado.

Numeração da versão da plataforma

Esses documentos se referem à versão dos clusters anexados ao GKE como a versão da plataforma, para diferenciá-la da versão do Kubernetes. Os clusters anexados ao GKE usam a mesma convenção de numeração de versões que o GKE. Por exemplo, 1.21.5-gke.1. Ao anexar ou atualizar seu cluster, escolha uma versão de plataforma em que a versão secundária seja igual ou um nível abaixo da versão do Kubernetes do cluster. Por exemplo, é possível anexar um cluster que executa o Kubernetes v1.22.* com a plataforma de clusters anexados do GKE 1.21.* ou 1.22.*.

Isso permite fazer upgrade do cluster para a próxima versão secundária antes de fazer upgrade dos clusters anexados ao GKE.

Anexar um cluster EKS

Para anexar o cluster do EKS ao Google Cloud Gerenciamento de frota, siga estas etapas:

Verifique se o arquivo kubeconfig tem uma entrada para o cluster que você quer anexar:
```
aws eks update-kubeconfig --region AWS_REGION \
  --name CLUSTER_NAME
```
Recupere o URL do emissor do OIDC com o seguinte comando:
```
aws eks describe-cluster \
  --region AWS_REGION \
  --name CLUSTER_NAME \
  --query "cluster.identity.oidc.issuer" \
  --output text
```
A saída desse comando é o URL do emissor do OIDC. Salve esse valor para uso posterior.
Execute este comando para extrair o contexto kubeconfig do cluster e armazená-lo na variável de ambiente KUBECONFIG_CONTEXT:
```
KUBECONFIG_CONTEXT=$(kubectl config current-context)
```

Use o comando gcloud container attached clusters register para registrar o cluster:

gcloud container attached clusters register CLUSTER_NAME \
  --location=GOOGLE_CLOUD_REGION \
  --fleet-project=PROJECT_NUMBER \
  --platform-version=PLATFORM_VERSION \
  --distribution=eks \
  --issuer-url=ISSUER_URL \
  --context=KUBECONFIG_CONTEXT \
  --kubeconfig=KUBECONFIG_PATH

Substitua:

AWS_REGION: a região da AWS em que o cluster EKS está localizado
CLUSTER_NAME: o nome do cluster
GOOGLE_CLOUD_REGION: a região do Google Cloud em que o cluster será administrado
PLATFORM_VERSION: a versão dos clusters anexados ao GKE a serem usados para o cluster
PROJECT_NUMBER: o projeto host da frota em que o cluster será registrado
ISSUER_URL: o URL do emissor recuperado anteriormente
KUBECONFIG_CONTEXT: contexto no kubeconfig para acessar o cluster EKS, conforme extraído anteriormente
KUBECONFIG_PATH: caminho para o kubeconfig

Observação: se a anexação do cluster falhar, o sistema reverterá automaticamente todos alterações feitas nos recursos do Google Cloud relacionados ao cluster, como pool de Identidade da carga de trabalho. Isso significa que a conexão entre o cluster e Os clusters anexados ao GKE não são estabelecidos, mas seu EKS não é afetado. Tente anexar o cluster novamente após corrigindo o problema que causou a falha.

Autorizar o Cloud Logging / Cloud Monitoring

Para que os clusters anexados ao GKE criem e façam upload de registros e métricas do sistema para o Google Cloud, ele precisa ser autorizado.

Para autorizar a Identidade da carga de trabalho do Kubernetes gke-system/gke-telemetry-agent a gravar registros no Google Cloud Logging e métricas no Google Cloud Monitoring, execute este comando:

gcloud projects add-iam-policy-binding GOOGLE_PROJECT_ID \
  --member="serviceAccount:GOOGLE_PROJECT_ID.svc.id.goog[gke-system/gke-telemetry-agent]" \
  --role=roles/gkemulticloud.telemetryWriter

Substitua GOOGLE_PROJECT_ID pelo ID do projeto do Google Cloud do cluster.

Essa vinculação do IAM concede acesso a todos os clusters no projeto do Google Cloud para fazer upload de registros e métricas. Você só precisa executá-lo após criar o primeiro cluster para o projeto.

A adição dessa vinculação do IAM falhará a menos que pelo menos um cluster tenha sido criado no projeto do Google Cloud. Isso ocorre porque o pool de Identidade de carga de trabalho ao qual se refere (GOOGLE_PROJECT_ID.svc.id.goog) não é provisionado até a criação do cluster.