Connettere un cluster Kubernetes esterno alla Console di gestione Amazon EKS

La AWS CLI deve essere installata. Per installarla o aggiornarla, consultare la pagina Installing the AWS CLI.

Per la configurazione del plug-in, specificare il ruolo IAM dell'agente Amazon EKS Connector. Per ulteriori informazioni, consulta Ruoli IAM richiesti per Amazon EKS Connector.

aws eks register-cluster \
     --name my-first-registered-cluster \
     --connector-config roleArn=arn:aws:iam::111122223333:role/AmazonEKSConnectorAgentRole,provider="OTHER" \
     --region aws-region

Di seguito viene riportato un output di esempio:

{
    "cluster": {
        "name": "my-first-registered-cluster",
        "arn": "arn:aws:eks:region:111122223333:cluster/my-first-registered-cluster",
        "createdAt": 1627669203.531,
        "ConnectorConfig": {
            "activationId": "xxxxxxxxACTIVATION_IDxxxxxxxx",
            "activationCode": "xxxxxxxxACTIVATION_CODExxxxxxxx",
            "activationExpiry": 1627672543.0,
            "provider": "OTHER",
            "roleArn": "arn:aws:iam::111122223333:role/AmazonEKSConnectorAgentRole"
        },
        "status": "CREATING"
    }
}

I valori aws-region, activationId, e activationCode verranno utilizzati nel prossimo passaggio.

Aprire la Console Amazon EKS.

Scegli Add cluster (Aggiungi cluster) e seleziona Register (Registra) per visualizzare la pagina di configurazione.

Nella pagina Configura cluster compilare i campi riportati di seguito:

Selezionare Registra cluster.

Viene visualizzata la pagina Panoramica del cluster. Se desideri utilizzare il grafico Helm, copia il comando helm install e prosegui con il passaggio successivo. Se desideri utilizzare il manifesto YAML, scegli Scarica file YAML per scaricare il file manifesto sull'unità locale.

Il comando o il file manifesto può essere utilizzato una sola volta per il cluster registrato. Se si eliminano risorse dal cluster Kubernetes, è necessario registrare nuovamente il cluster e ottenere un nuovo file manifesto.

Deve essere installato eksctl versione 0.68 o successiva. Per installarlo o aggiornarlo, consulta la pagina Nozioni di base su Amazon EKS: eksctl.

Registra il cluster fornendo un nome, un provider e una regione.

eksctl register cluster --name my-cluster --provider my-provider --region region-code

Output di esempio:

2021-08-19 13:47:26 [ℹ]  creating IAM role "eksctl-20210819194112186040"
2021-08-19 13:47:26 [ℹ]  registered cluster "<name>" successfully
2021-08-19 13:47:26 [ℹ]  wrote file eks-connector.yaml to <current directory>
2021-08-19 13:47:26 [ℹ]  wrote file eks-connector-clusterrole.yaml to <current directory>
2021-08-19 13:47:26 [ℹ]  wrote file eks-connector-console-dashboard-full-access-group.yaml to <current directory>
2021-08-19 13:47:26 [!]  note: "eks-connector-clusterrole.yaml" and "eks-connector-console-dashboard-full-access-group.yaml" give full EKS Console access to IAM identity "<aws-arn>", edit if required; read https://eksctl.io/usage/eks-connector for more info
2021-08-19 13:47:26 [ℹ]  run `kubectl apply -f eks-connector.yaml,eks-connector-clusterrole.yaml,eks-connector-console-dashboard-full-access-group.yaml` before expiry> to connect the cluster

In questo modo vengono creati file sul computer locale. Questi file devono essere applicati al cluster esterno entro 3 giorni; in caso contrario, la registrazione scade.

In un terminale in grado di accedere al cluster, applica il file eks-connector-binding.yaml:

kubectl apply -f eks-connector-binding.yaml

Se nel passaggio precedente è stata utilizzata la AWS CLI, sostituire i valori di ACTIVATION_CODE e ACTIVATION_ID nel seguente comando rispettivamente con i valori activationId e activationCode. Sostituire aws-region con la Regione AWS utilizzata nella fase precedente. Dopodiché, esegui il comando seguente per installare l'agente eks-connector nel cluster in fase di registrazione:

$ helm install eks-connector \
  --namespace eks-connector \
  oci://public.ecr.aws/eks-connector/eks-connector-chart \
  --set eks.activationCode=ACTIVATION_CODE \
  --set eks.activationId=ACTIVATION_ID \
  --set eks.agentRegion=aws-region

Se nel passaggio precedente hai utilizzato la Console di gestione AWS, utilizza il comando copiato in tale passaggio inserendovi questi valori.

Verifica l'integrità dell'implementazione del eks-connector installato e attendi che lo stato del cluster registrato in Amazon EKS diventi ACTIVE.

Eseguire il download del file YAML di Amazon EKS Connector.

curl -O https://amazon-eks.s3.us-west-2.amazonaws.com/eks-connector/manifests/eks-connector/latest/eks-connector.yaml

Modifica il file YAML del connettore Amazon EKS per sostituire tutti i riferimenti di %AWS_REGION%, %EKS_ACTIVATION_ID% e %EKS_ACTIVATION_CODE% con i valori aws-region, activationId, e activationCode dell'output del passaggio precedente.

Il comando di esempio seguente può sostituire questi valori.

sed -i "s~%AWS_REGION%~$aws-region~g; s~%EKS_ACTIVATION_ID%~$EKS_ACTIVATION_ID~g; s~%EKS_ACTIVATION_CODE%~$(echo -n $EKS_ACTIVATION_CODE | base64)~g" eks-connector.yaml

In un terminale dotato di accesso al cluster, è possibile applicare il file manifesto aggiornato eseguendo il seguente comando:

kubectl apply -f eks-connector.yaml

Dopo aver applicato al cluster Kubernetes il manifesto e i file YAML dell'associazione dei ruoli di Amazon EKS Connector, verificare che il cluster sia connesso.

aws eks describe-cluster \
     --name "my-first-registered-cluster" \
     --region AWS_REGION

L'output deve includere status=ACTIVE.

(Facoltativo) Assegna tag al cluster. Per ulteriori informazioni, consulta Organizzazione delle risorse Amazon EKS con tag.