Instalación o actualización del kubectl - Amazon EKS

Instalación o actualización del kubectl

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.

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.28 trabaja con los clústeres Kubernetes, 1.27, 1.28 y 1.29.

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

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.0/2024-01-04/bin/darwin/amd64/kubectl

      • Kubernetes 1.28

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.5/2024-01-04/bin/darwin/amd64/kubectl

      • Kubernetes 1.27

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.9/2024-01-04/bin/darwin/amd64/kubectl

      • Kubernetes 1.26

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.12/2024-01-04/bin/darwin/amd64/kubectl

      • Kubernetes 1.25

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

      • Kubernetes 1.24

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

      • Kubernetes 1.23

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-01-04/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.29

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.0/2024-01-04/bin/darwin/amd64/kubectl.sha256

        • Kubernetes 1.28

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.5/2024-01-04/bin/darwin/amd64/kubectl.sha256

        • Kubernetes 1.27

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.9/2024-01-04/bin/darwin/amd64/kubectl.sha256

        • Kubernetes 1.26

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.12/2024-01-04/bin/darwin/amd64/kubectl.sha256

        • Kubernetes 1.25

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

        • Kubernetes 1.24

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

        • Kubernetes 1.23

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-01-04/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.29

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.0/2024-01-04/bin/linux/amd64/kubectl

      • Kubernetes 1.28

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.5/2024-01-04/bin/linux/amd64/kubectl

      • Kubernetes 1.27

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.9/2024-01-04/bin/linux/amd64/kubectl

      • Kubernetes 1.26

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.12/2024-01-04/bin/linux/amd64/kubectl

      • Kubernetes 1.25

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

      • Kubernetes 1.24

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

      • Kubernetes 1.23

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-01-04/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. El primer enlace de cada versión es para amd64 y el segundo enlace es para arm64.

        • Kubernetes 1.29

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.0/2024-01-04/bin/linux/amd64/kubectl.sha256

        • Kubernetes 1.28

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.5/2024-01-04/bin/linux/amd64/kubectl.sha256

        • Kubernetes 1.27

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.9/2024-01-04/bin/linux/amd64/kubectl.sha256

        • Kubernetes 1.26

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.12/2024-01-04/bin/linux/amd64/kubectl.sha256

        • Kubernetes 1.25

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

        • Kubernetes 1.24

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

        • Kubernetes 1.23

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-01-04/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.29

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.0/2024-01-04/bin/linux/arm64/kubectl

      • Kubernetes 1.28

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.5/2024-01-04/bin/linux/arm64/kubectl

      • Kubernetes 1.27

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.9/2024-01-04/bin/linux/arm64/kubectl

      • Kubernetes 1.26

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.12/2024-01-04/bin/linux/arm64/kubectl

      • Kubernetes 1.25

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

      • Kubernetes 1.24

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

      • Kubernetes 1.23

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-01-04/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. El primer enlace de cada versión es para amd64 y el segundo enlace es para arm64.

        • Kubernetes 1.29

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.0/2024-01-04/bin/linux/arm64/kubectl.sha256

        • Kubernetes 1.28

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.5/2024-01-04/bin/linux/arm64/kubectl.sha256

        • Kubernetes 1.27

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.9/2024-01-04/bin/linux/arm64/kubectl.sha256

        • Kubernetes 1.26

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.12/2024-01-04/bin/linux/arm64/kubectl.sha256

        • Kubernetes 1.25

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

        • Kubernetes 1.24

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

        • Kubernetes 1.23

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-01-04/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.29

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.0/2024-01-04/bin/windows/amd64/kubectl.exe

      • Kubernetes 1.28

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.5/2024-01-04/bin/windows/amd64/kubectl.exe

      • Kubernetes 1.27

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.9/2024-01-04/bin/windows/amd64/kubectl.exe

      • Kubernetes 1.26

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.12/2024-01-04/bin/windows/amd64/kubectl.exe

      • Kubernetes 1.25

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

      • Kubernetes 1.24

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

      • Kubernetes 1.23

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-01-04/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.29

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.0/2024-01-04/bin/windows/amd64/kubectl.exe.sha256

        • Kubernetes 1.28

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.5/2024-01-04/bin/windows/amd64/kubectl.exe.sha256

        • Kubernetes 1.27

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.9/2024-01-04/bin/windows/amd64/kubectl.exe.sha256

        • Kubernetes 1.26

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.12/2024-01-04/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-01-04/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-01-04/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-01-04/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

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