Connectez un cluster Kubernetes externe à la console de gestion Amazon EKS

AWS La CLI doit être installée. Pour l'installer ou le mettre à niveau, reportez-vous à la section Installation de la AWS CLI.

Pour la configuration du connecteur, spécifiez votre rôle IAM d'agent Amazon EKS Connector. Pour de plus amples informations, veuillez consulter Rôles IAM requis pour 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

L'exemple qui suit illustre un résultat.

{
    "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"
    }
}

Vous utilisez les valeurs aws-region, activationId et activationCode à l'étape suivante.

Ouvrez la console Amazon EKS.

Sélectionnez Add cluster (Ajouter un cluster), puis Register (Enregistrer) pour afficher la page de configuration.

Sur la page Configurer le cluster, renseignez les champs suivants :

Sélectionnez Register cluster (Enregistrer le cluster).

La page Présentation du cluster s'affiche. Si vous souhaitez utiliser les Charts de Helm, copiez la commande helm install et passez à l'étape suivante. Si vous souhaitez utiliser le manifeste YAML, sélectionnez Télécharger le fichier YAML pour télécharger le fichier manifeste sur votre lecteur local.

La commande ou le fichier manifeste ne peut être utilisé(e) qu'une seule fois pour le cluster enregistré. Si vous supprimez des ressources du cluster Kubernetes, vous devez réenregistrer le cluster et obtenir un nouveau fichier manifeste.

eksctl version 0.68 ou une version ultérieure doit être installée. Pour l'installer ou la mettre à niveau, veuillez consulter la rubrique Commencez avec Amazon EKS — eksctl.

Enregistrez le cluster en fournissant un nom, un fournisseur et une région.

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

Exemple de sortie :

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

Cela crée des fichiers sur votre ordinateur local. Ces fichiers doivent être appliqués au cluster externe dans un délai de 3 jours, sinon l'enregistrement expire.

Dans un terminal pouvant accéder au cluster, appliquez le fichier eks-connector-binding.yaml :

kubectl apply -f eks-connector-binding.yaml

Si vous avez utilisé la AWS CLI à l'étape précédente, remplacez les valeurs ACTIVATION_CODE et ACTIVATION_ID dans la commande suivante par les activationCode valeursactivationId, et respectivement. Remplacez le aws-region par la AWS région que vous avez utilisée à l'étape précédente. Ensuite, exécutez la commande pour installer l'agent eks-connector dans le cluster d'enregistrement :

$ 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

Si vous avez utilisé le AWS Management Console à l'étape précédente, utilisez la commande que vous avez copiée à l'étape précédente et qui contient ces valeurs.

Vérifiez l'état de santé du déploiement du eks-connector installé et attendez que le statut du cluster enregistré dans Amazon EKS soit ACTIVE.

Téléchargez le fichier YAML Amazon EKS Connector.

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

Modifiez le fichier YAML Amazon EKS Connector pour remplacer toutes les références de %AWS_REGION%, %EKS_ACTIVATION_ID%, %EKS_ACTIVATION_CODE% par la aws-region, l'activationId et le activationCode à partir de la sortie de l'étape antérieure.

L'exemple de commande suivant peut remplacer ces valeurs.

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

Dans un terminal pouvant accéder au cluster, vous pouvez appliquer le fichier manifeste mis à jour en exécutant la commande suivante :

kubectl apply -f eks-connector.yaml

Après l'application du manifeste Amazon EKS Connector et des fichiers YAML de liaison de rôle à votre cluster Kubernetes, vérifiez que le cluster est maintenant connecté.

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

La sortie doit inclure status=ACTIVE.

(Facultatif) Attribuez des balises à votre cluster. Pour de plus amples informations, veuillez consulter Organisez les ressources Amazon EKS à l'aide de balises.