Connect un appareil externe Kubernetes cluster vers la console EKS de gestion Amazon

Pour enregistrer votre cluster auprès du AWS CLI

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

Pour enregistrer votre Kubernetes cluster avec la console.

1. Ouvrez la EKS console Amazon à l'adresse https://console.aws.amazon.com/eks/home#/clusters.

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

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

   • Nom : nom unique de votre cluster.

   • Fournisseur — Choisissez d'afficher la liste déroulante des Kubernetes fournisseurs de clusters. Si vous ne connaissez pas le fournisseur spécifique, sélectionnez Autre.

   • EKSRôle de connecteur : sélectionnez le rôle à utiliser pour connecter le cluster.

4. Sélectionnez Register cluster (Enregistrer le cluster).

5. 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 YAML manifeste, choisissez Télécharger YAML le fichier pour télécharger le fichier manifeste sur votre disque local.

   Important

   • C'est le seul moment où vous pouvez copier la commande helm install ou télécharger ce fichier. Ne naviguez pas hors de cette page, car le lien ne sera pas accessible et vous devrez annuler l'enregistrement du cluster et recommencer les étapes depuis le début.

   • 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 Kubernetes cluster, vous devez réenregistrer le cluster et obtenir un nouveau fichier manifeste.

   Passez à l'étape suivante pour appliquer le fichier manifeste à votre Kubernetes cluster.

Pour inscrire votre cluster avec eksctl

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

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

   kubectl apply -f eks-connector-binding.yaml
   

1. Si vous avez utilisé le AWS CLI à l'étape précédente, remplacez le ACTIVATION_CODE et ACTIVATION_ID dans la commande suivante par les activationCode valeursactivationId, et respectivement. aws-regionRemplacez-le par celui Région AWS que vous avez utilisé à 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.

2. Vérifiez le bon fonctionnement du eks-connector déploiement installé et attendez que le statut du cluster enregistré sur Amazon EKS soit le même. ACTIVE

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

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

2. Modifiez le YAML fichier Amazon EKS Connector pour remplacer toutes les références à %AWS_REGION%%EKS_ACTIVATION_ID%, %EKS_ACTIVATION_CODE% par le aws-regionactivationId, et activationCode issues de la sortie de l'étape précédente.

   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
   

   Important

   Assurez-vous que votre code d'activation est au format base64.

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

4. Une fois que le manifeste Amazon EKS Connector et les YAML fichiers de liaison de rôles ont été appliqués à votre Kubernetes cluster, vérifiez que le cluster est désormais connecté.

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

   La sortie doit inclure status=ACTIVE.

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