Conexión de un clúster externo de Kubernetes a la consola de administración de Amazon EKS

Para registrar el clúster con la AWS CLI

• Para la configuración de Connector, especifique su rol de IAM de agente de Amazon EKS Connector. Para obtener más información, consulte Roles de IAM necesarios para 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
  

  Un ejemplo de salida sería el siguiente.

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

  Utilizará los valores de aws-region, activationId y activationCode en un paso posterior.

Para registrar el clúster de Kubernetes en la consola.

1. Abra la consola de Amazon EKS en https://console.aws.amazon.com/eks/home#/clusters.

2. Elija Add cluster (Agregar clúster) y seleccione Register (Registrar) para abrir la página de configuración.

3. En la sección Configure cluster (Configurar clúster), rellene los siguientes campos:

   • Nombre: un nombre único para el clúster.

   • Provider (Proveedor): elija esta opción para mostrar la lista desplegable de proveedores de clústeres de Kubernetes. Si no conoce al proveedor específico, seleccione Otro.

   • EKS Connector role (Rol de EKS Connector): seleccione el rol que se va a utilizar para conectar el clúster.

4. Seleccione Register cluster (Registrar el clúster).

5. Se abre la página de información general del clúster. Si quiere usar el gráfico de Helm, copie el comando helm install y continúe con el siguiente paso. Si desea usar el manifiesto de YAML, elija Descargar archivo YAML para descargar el archivo de manifiesto en la unidad local.

   importante

   • Esta es su única oportunidad para copiar el comando helm install o descargar este archivo. No navegue fuera de esta página, ya que no se podrá acceder al enlace y deberá anular el registro del clúster e iniciar los pasos desde el principio.

   • El comando o el archivo de manifiesto solo se puede utilizar una vez para el clúster registrado. Si elimina recursos del clúster de Kubernetes, debe volver a registrar el clúster y obtener un nuevo archivo de manifiesto.

   Continúe en el paso siguiente para aplicar el archivo de manifiesto al clúster de Kubernetes.

Para registrar el clúster con eksctl

1. Registre el clúster al proporcionar un nombre, un proveedor y una región.

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

   Ejemplo de salida:

   
   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
                               

   De este modo, se crean archivos en el equipo local. Estos archivos deben aplicarse al clúster externo en un plazo de 3 días o el registro vence.

2. En una terminal que pueda acceder al clúster, aplique el archivo eks-connector-binding.yaml:

   kubectl apply -f eks-connector-binding.yaml
   

1. Si utilizó la AWS CLI en el paso anterior, sustituya el ACTIVATION_CODE y ACTIVATION_ID en el siguiente comando por los valores de activationId y activationCode, respectivamente. Sustituya el aws-region por el Región de AWS que utilizó en el paso anterior. Ejecute el siguiente comando para instalar el agente de eks-connector en el clúster del registro:

   $ 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 ha utilizado la AWS Management Console en el paso anterior, utilice el comando que copió del paso anterior y que contiene estos valores rellenados.

2. Compruebe el buen estado de la implementación de eks-connector instalado y espere a que el estado del clúster registrado en Amazon EKS sea ACTIVE.

1. Descargue el archivo YAML de Amazon EKS Connector.

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

2. Edite el archivo YAML de Amazon EKS Connector para reemplazar todas las referencias de %AWS_REGION%, %EKS_ACTIVATION_ID% y %EKS_ACTIVATION_CODE% por aws-region, activationId y activationCode de la salida del paso anterior.

   El siguiente comando de ejemplo puede sustituir estos valores.

   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
   

   importante

   Asegúrese de que el código de activación esté en el formato base64.

3. En una terminal que pueda acceder al clúster, puede aplicar el archivo de manifiesto actualizado al ejecutar el siguiente comando:

   kubectl apply -f eks-connector.yaml
   

4. Una vez que los archivos YAML de manifiesto y de enlace de roles de Amazon EKS Connector se hayan aplicado al clúster de Kubernetes, confirme que el clúster esté conectado.

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

   El resultado debe incluir status=ACTIVE.

5. (Opcional) Agregue etiquetas a su clúster. Para obtener más información, consulte Organización de los recursos de Amazon EKS con etiquetas.