Configuración de kubectl y eksctl - Amazon EKS
Instalación o actualización de kubectlInstalar eksctlSiguientes pasos

Ayude a mejorar esta página

¿Quiere contribuir a esta guía del usuario? Desplácese hasta el final de esta página y seleccione Editar esta página en GitHub. Sus contribuciones ayudarán a que nuestra guía del usuario sea mejor para todos.

Configuración de kubectl y eksctl

Kubectl es una herramienta de línea de comandos que se utiliza para comunicarse con el servidor de API de Kubernetes. El dato binario kubectl está disponible en muchos administradores de paquetes de sistemas operativos. Utilizar un administrador de paquetes para la instalación es normalmente más sencillo que el proceso manual de descarga e instalación. El comando eksctl le permite crear y modificar clústeres de Amazon EKS.

Los temas de esta página le ayudan a instalar y configurar estas herramientas:

Instalación o actualización de kubectl

Este tema le ayuda a descargar e instalar, o actualizar, el kubectl binario en su dispositivo. El dato binario es idéntico a las versiones de comunidad ascendente. El dato binario no es exclusivo de Amazon EKS o de AWS.

nota

Debe utilizar una versión de kubectl con una diferencia de versión de menos de un número que el plano del control del clúster de Amazon EKS. Por ejemplo, un cliente de kubectl 1.29 trabaja con los clústeres Kubernetes, 1.28, 1.29 y 1.30.

Instalar o actualizar kubectl

  1. Determine si ya tiene kubectl instalado en su dispositivo.

    kubectl version --client

    Si tiene kubectl instalado en la ruta de su dispositivo, el resultado de ejemplo incluye información similar a la siguiente. Si desea actualizar la versión que tiene instalada actualmente con una versión posterior, complete el siguiente paso y asegúrese de instalar la nueva versión en la misma ubicación en la que se encuentra la versión actual.

    Client Version: v1.30.X-eks-1234567

    Si no recibe un resultado, entonces no tiene kubectl instalado o no está instalado en una ubicación que esté en la ruta de acceso del dispositivo.

  2. Instalar o actualizar kubectl en los sistemas operativos macOS, Linux y Windows.

    macOS
    Para instalar o actualizar kubectl en macOS

    1. Descargue el dato binario de la versión de Kubernetes de su clúster de Amazon S3.

      • Kubernetes 1.30

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.2/2024-07-12/bin/darwin/amd64/kubectl

      • Kubernetes 1.29

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.6/2024-07-12/bin/darwin/amd64/kubectl

      • Kubernetes 1.28

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.11/2024-07-12/bin/darwin/amd64/kubectl

      • Kubernetes 1.27

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.15/2024-07-12/bin/darwin/amd64/kubectl

      • Kubernetes 1.26

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-07-12/bin/darwin/amd64/kubectl

      • Kubernetes 1.25

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-07-12/bin/darwin/amd64/kubectl

      • Kubernetes 1.24

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-07-12/bin/darwin/amd64/kubectl

      • Kubernetes 1.23

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-07-12/bin/darwin/amd64/kubectl

      • Kubernetes 1.22

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-07-12/bin/darwin/amd64/kubectl

      • Kubernetes 1.21

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-07-12/bin/darwin/amd64/kubectl

    2. (Opcional) Compruebe el dato binario descargado con la suma de comprobación de SHA-256 de su dato binario.

      1. Descargue la suma de comprobación de SHA-256 de la versión de Kubernetes de su clúster.

        • Kubernetes 1.30

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.2/2024-07-12/bin/darwin/amd64/kubectl.sha256

        • Kubernetes 1.29

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.6/2024-07-12/bin/darwin/amd64/kubectl.sha256

        • Kubernetes 1.28

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.11/2024-07-12/bin/darwin/amd64/kubectl.sha256

        • Kubernetes 1.27

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.15/2024-07-12/bin/darwin/amd64/kubectl.sha256

        • Kubernetes 1.26

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-07-12/bin/darwin/amd64/kubectl.sha256

        • Kubernetes 1.25

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-07-12/bin/darwin/amd64/kubectl.sha256

        • Kubernetes 1.24

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-07-12/bin/darwin/amd64/kubectl.sha256

        • Kubernetes 1.23

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-07-12/bin/darwin/amd64/kubectl.sha256

        • Kubernetes 1.22

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-07-12/bin/darwin/amd64/kubectl.sha256

        • Kubernetes 1.21

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-07-12/bin/darwin/amd64/kubectl.sha256

      2. Verifique la suma de comprobación de SHA-256 del dato binario descargado.

        openssl sha1 -sha256 kubectl

      3. Asegúrese de que la suma de comprobación generada en la salida coincida con la suma de comprobación del archivo de kubectl.sha256 descargado.

    3. Aplique permisos de ejecución al binario.

      chmod +x ./kubectl

    4. Copie el binario en una carpeta en PATH. Si ya ha instalado una versión de kubectl, recomendamos que cree un $HOME/bin/kubectl y se asegure de que $HOME/bin venga en primer lugar en su $PATH.

      mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH

    5. (Opcional) Agregue la ruta $HOME/bin a su archivo de inicialización del shell para que se configure cuando abra un shell.

      echo 'export PATH=$HOME/bin:$PATH' >> ~/.bash_profile
    Linux (amd64)
    Para instalar o actualizar kubectl en Linux (amd64)

    1. Descargue el dato binario de kubectl para la versión de Kubernetes del clúster de Amazon S3.

      • Kubernetes 1.30

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.2/2024-07-12/bin/linux/amd64/kubectl

      • Kubernetes 1.29

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.6/2024-07-12/bin/linux/amd64/kubectl

      • Kubernetes 1.28

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.11/2024-07-12/bin/linux/amd64/kubectl

      • Kubernetes 1.27

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.15/2024-07-12/bin/linux/amd64/kubectl

      • Kubernetes 1.26

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-07-12/bin/linux/amd64/kubectl

      • Kubernetes 1.25

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-07-12/bin/linux/amd64/kubectl

      • Kubernetes 1.24

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-07-12/bin/linux/amd64/kubectl

      • Kubernetes 1.23

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-07-12/bin/linux/amd64/kubectl

      • Kubernetes 1.22

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-07-12/bin/linux/amd64/kubectl

      • Kubernetes 1.21

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-07-12/bin/linux/amd64/kubectl

    2. (Opcional) Compruebe el dato binario descargado con la suma de comprobación de SHA-256 de su dato binario.

      1. Descargue la suma de comprobación de SHA-256 para la versión de Kubernetes del clúster desde Amazon S3 mediante el comando de la plataforma de hardware de su dispositivo.

        • Kubernetes 1.30

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.2/2024-07-12/bin/linux/amd64/kubectl.sha256

        • Kubernetes 1.29

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.6/2024-07-12/bin/linux/amd64/kubectl.sha256

        • Kubernetes 1.28

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.11/2024-07-12/bin/linux/amd64/kubectl.sha256

        • Kubernetes 1.27

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.15/2024-07-12/bin/linux/amd64/kubectl.sha256

        • Kubernetes 1.26

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-07-12/bin/linux/amd64/kubectl.sha256

        • Kubernetes 1.25

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-07-12/bin/linux/amd64/kubectl.sha256

        • Kubernetes 1.24

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-07-12/bin/linux/amd64/kubectl.sha256

        • Kubernetes 1.23

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-07-12/bin/linux/amd64/kubectl.sha256

        • Kubernetes 1.22

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-07-12/bin/linux/amd64/kubectl.sha256

        • Kubernetes 1.21

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-07-12/bin/linux/amd64/kubectl.sha256

      2. Controle la suma de comprobación de SHA-256 del archivo binario descargado con uno de los siguientes comandos.

        • sha256sum -c kubectl.sha256

          Al usar este comando, asegúrese de ver el resultado siguiente:

          kubectl: OK
        • openssl sha1 -sha256 kubectl

          Cuando use este comando, asegúrese de que la suma de comprobación generada en la salida coincida con la suma de comprobación del archivo de kubectl.sha256 descargado.

    3. Aplique permisos de ejecución al binario.

      chmod +x ./kubectl

    4. Copie el binario en una carpeta en PATH. Si ya ha instalado una versión de kubectl, recomendamos que cree un $HOME/bin/kubectl y se asegure de que $HOME/bin venga en primer lugar en su $PATH.

      mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH

    5. (Opcional) Agregue la ruta $HOME/bin a su archivo de inicialización del shell para que se configure cuando abra un shell.

      nota

      En este paso, se presupone que usa el shell Bash; si utiliza otro shell, cambie el comando para utilizar su archivo de inicialización del shell específico.

      echo 'export PATH=$HOME/bin:$PATH' >> ~/.bashrc
    Linux (arm64)
    Para instalar o actualizar kubectl en Linux (arm64)

    1. Descargue el dato binario de kubectl para la versión de Kubernetes del clúster de Amazon S3.

      • Kubernetes 1.30

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.2/2024-07-12/bin/linux/arm64/kubectl

      • Kubernetes 1.29

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.6/2024-07-12/bin/linux/arm64/kubectl

      • Kubernetes 1.28

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.11/2024-07-12/bin/linux/arm64/kubectl

      • Kubernetes 1.27

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.15/2024-07-12/bin/linux/arm64/kubectl

      • Kubernetes 1.26

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-07-12/bin/linux/arm64/kubectl

      • Kubernetes 1.25

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-07-12/bin/linux/arm64/kubectl

      • Kubernetes 1.24

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-07-12/bin/linux/arm64/kubectl

      • Kubernetes 1.23

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-07-12/bin/linux/arm64/kubectl

      • Kubernetes 1.22

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-07-12/bin/linux/arm64/kubectl

      • Kubernetes 1.21

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-07-12/bin/linux/arm64/kubectl

    2. (Opcional) Compruebe el dato binario descargado con la suma de comprobación de SHA-256 de su dato binario.

      1. Descargue la suma de comprobación de SHA-256 para la versión de Kubernetes del clúster desde Amazon S3 mediante el comando de la plataforma de hardware de su dispositivo.

        • Kubernetes 1.30

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.2/2024-07-12/bin/linux/arm64/kubectl.sha256

        • Kubernetes 1.29

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.6/2024-07-12/bin/linux/arm64/kubectl.sha256

        • Kubernetes 1.28

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.11/2024-07-12/bin/linux/arm64/kubectl.sha256

        • Kubernetes 1.27

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.15/2024-07-12/bin/linux/arm64/kubectl.sha256

        • Kubernetes 1.26

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-07-12/bin/linux/arm64/kubectl.sha256

        • Kubernetes 1.25

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-07-12/bin/linux/arm64/kubectl.sha256

        • Kubernetes 1.24

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-07-12/bin/linux/arm64/kubectl.sha256

        • Kubernetes 1.23

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-07-12/bin/linux/arm64/kubectl.sha256

        • Kubernetes 1.22

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-07-12/bin/linux/arm64/kubectl.sha256

        • Kubernetes 1.21

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-07-12/bin/linux/arm64/kubectl.sha256

      2. Controle la suma de comprobación de SHA-256 del archivo binario descargado con uno de los siguientes comandos.

        • sha256sum -c kubectl.sha256

          Al usar este comando, asegúrese de ver el resultado siguiente:

          kubectl: OK
        • openssl sha1 -sha256 kubectl

          Cuando use este comando, asegúrese de que la suma de comprobación generada en la salida coincida con la suma de comprobación del archivo de kubectl.sha256 descargado.

    3. Aplique permisos de ejecución al binario.

      chmod +x ./kubectl

    4. Copie el binario en una carpeta en PATH. Si ya ha instalado una versión de kubectl, recomendamos que cree un $HOME/bin/kubectl y se asegure de que $HOME/bin venga en primer lugar en su $PATH.

      mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH

    5. (Opcional) Agregue la ruta $HOME/bin a su archivo de inicialización del shell para que se configure cuando abra un shell.

      nota

      En este paso, se presupone que usa el shell Bash; si utiliza otro shell, cambie el comando para utilizar su archivo de inicialización del shell específico.

      echo 'export PATH=$HOME/bin:$PATH' >> ~/.bashrc
    Windows
    Para instalar o actualizar kubectl en Windows

    1. Abra un terminal PowerShell.

    2. Descargue el dato binario de kubectl para la versión de Kubernetes del clúster de Amazon S3.

      • Kubernetes 1.30

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.2/2024-07-12/bin/windows/amd64/kubectl.exe

      • Kubernetes 1.29

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.6/2024-07-12/bin/windows/amd64/kubectl.exe

      • Kubernetes 1.28

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.11/2024-07-12/bin/windows/amd64/kubectl.exe

      • Kubernetes 1.27

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.15/2024-07-12/bin/windows/amd64/kubectl.exe

      • Kubernetes 1.26

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-07-12/bin/windows/amd64/kubectl.exe

      • Kubernetes 1.25

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-07-12/bin/windows/amd64/kubectl.exe

      • Kubernetes 1.24

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-07-12/bin/windows/amd64/kubectl.exe

      • Kubernetes 1.23

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-07-12/bin/windows/amd64/kubectl.exe

      • Kubernetes 1.22

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-07-12/bin/windows/amd64/kubectl.exe

      • Kubernetes 1.21

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-07-12/bin/windows/amd64/kubectl.exe

    3. (Opcional) Compruebe el dato binario descargado con la suma de comprobación de SHA-256 de su dato binario.

      1. Descargue la suma de comprobación de SHA-256 de la versión de Kubernetes del clúster para Windows.

        • Kubernetes 1.30

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.2/2024-07-12/bin/windows/amd64/kubectl.exe.sha256

        • Kubernetes 1.29

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.6/2024-07-12/bin/windows/amd64/kubectl.exe.sha256

        • Kubernetes 1.28

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.11/2024-07-12/bin/windows/amd64/kubectl.exe.sha256

        • Kubernetes 1.27

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.15/2024-07-12/bin/windows/amd64/kubectl.exe.sha256

        • Kubernetes 1.26

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-07-12/bin/windows/amd64/kubectl.exe.sha256

        • Kubernetes 1.25

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-07-12/bin/windows/amd64/kubectl.exe.sha256

        • Kubernetes 1.24

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-07-12/bin/windows/amd64/kubectl.exe.sha256

        • Kubernetes 1.23

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-07-12/bin/windows/amd64/kubectl.exe.sha256

        • Kubernetes 1.22

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-07-12/bin/windows/amd64/kubectl.exe.sha256

        • Kubernetes 1.21

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-07-12/bin/windows/amd64/kubectl.exe.sha256

      2. Verifique la suma de comprobación de SHA-256 del dato binario descargado.

        Get-FileHash kubectl.exe

      3. Asegúrese de que la suma de comprobación generada en la salida coincida con la suma de comprobación del archivo de kubectl.sha256 descargado. La salida de PowerShell debe ser una cadena de caracteres equivalente en mayúsculas.

    4. Copie el binario en una carpeta en PATH. Si tiene un directorio existente en su PATH que utiliza para utilidades de línea de comandos, copie el binario en ese directorio. De lo contrario, lleve a cabo los pasos que figuran a continuación.

      1. Cree un nuevo directorio para los binarios de línea de comandos, como C:\bin.

      2. Copie el binario kubectl.exe en el nuevo directorio.

      3. Edite la variable de entorno PATH del usuario o sistema para agregar el nuevo directorio a su PATH.

      4. Cierre el terminal de PowerShell y abra uno nuevo para obtener la nueva variable PATH.

  3. Una vez que instale kubectl, puede comprobar la versión.

    kubectl version --client

  4. Al instalar por primera vez kubectl, aún no está configurado para comunicarse con ningún servidor. Trataremos esta configuración según sea necesario en otros procedimientos. Si alguna vez necesita actualizar la configuración para comunicarse con un clúster en particular, puede ejecutar el siguiente comando. Reemplace region-code por la Región de AWS en la que se encuentra el clúster. Reemplace my-cluster por el nombre del clúster.

    aws eks update-kubeconfig --region region-code --name my-cluster

  5. Considere configurar el autocompletado, que le permite usar la tecla de tabulación para completar los subcomandos de kubectl después de escribir las primeras letras. Consulte Autocompletar con Kubectl en la documentación de Kubernetes para obtener más información.

Instalar eksctl

La CLI de eksctl se usa para trabajar con clústeres de EKS. Automatiza muchas tareas individuales. Consulte Instalación en la documentación de eksctl para obtener instrucciones sobre cómo instalar eksctl.

Al usar eksctl, la entidad principal de seguridad de IAM que está utilizando debe contar con permisos para trabajar con los roles de IAM de Amazon EKS y los roles vinculados al servicio, AWS CloudFormation, además de una VPC y recursos relacionados. Para obtener más información, consulte Acciones, recursos y claves de condición de Amazon Elastic Container Service for Kubernetes y Uso de roles vinculados a servicios en la guía del usuario de IAM. Debe completar todos los pasos de esta guía como el mismo usuario. Ejecute el siguiente comando para comprobar el usuario actual:

aws sts get-caller-identity

Siguientes pasos