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.22 trabaja con los clústeres Kubernetes, 1.21, 1.22 y 1.23.

Instalar o actualizar kubectl

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

    kubectl version | grep Client | cut -d : -f 5

    Si tiene kubectl instalado en la ruta de su dispositivo, el resultado de ejemplo es el 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.

    "v1.22.6-eks-7d68063", GitCommit

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

        curl -o kubectl https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.7/2022-06-29/bin/darwin/amd64/kubectl
      • Kubernetes 1.22

        curl -o kubectl https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.6/2022-03-09/bin/darwin/amd64/kubectl
      • Kubernetes 1.21

        curl -o kubectl https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.2/2021-07-05/bin/darwin/amd64/kubectl
      • Kubernetes 1.20

        curl -o kubectl https://s3.us-west-2.amazonaws.com/amazon-eks/1.20.4/2021-04-12/bin/darwin/amd64/kubectl
      • Kubernetes 1.19

        curl -o kubectl https://s3.us-west-2.amazonaws.com/amazon-eks/1.19.6/2021-01-05/bin/darwin/amd64/kubectl
      • Kubernetes 1.18

        curl -o kubectl https://s3.us-west-2.amazonaws.com/amazon-eks/1.18.9/2020-11-02/bin/darwin/amd64/kubectl
    2. (Opcional) Compruebe el dato binario descargado con la suma SHA-256 de su dato binario.

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

        • Kubernetes 1.23

          curl -o kubectl.sha256 https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.7/2022-06-29/bin/darwin/amd64/kubectl.sha256
        • Kubernetes 1.22

          curl -o kubectl.sha256 https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.6/2022-03-09/bin/darwin/amd64/kubectl.sha256
        • Kubernetes 1.21

          curl -o kubectl.sha256 https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.2/2021-07-05/bin/darwin/amd64/kubectl.sha256
        • Kubernetes 1.20

          curl -o kubectl.sha256 https://s3.us-west-2.amazonaws.com/amazon-eks/1.20.4/2021-04-12/bin/darwin/amd64/kubectl.sha256
        • Kubernetes 1.19

          curl -o kubectl.sha256 https://s3.us-west-2.amazonaws.com/amazon-eks/1.19.6/2021-01-05/bin/darwin/amd64/kubectl.sha256
        • Kubernetes 1.18

          curl -o kubectl.sha256 https://s3.us-west-2.amazonaws.com/amazon-eks/1.18.9/2020-11-02/bin/darwin/amd64/kubectl.sha256
      2. Verifique la suma SHA-256 del dato binario descargado.

        openssl sha1 -sha256 kubectl
      3. Compare la suma SHA-256 generada en la salida del comando con el archivo SHA-256 descargado. Los dos deben coincidir.

    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=$PATH:$HOME/bin' >> ~/.bash_profile
    6. Una vez instalado kubectl, puede comprobar la versión con el comando siguiente:

      kubectl version --short --client
    Linux

    Para instalar o actualizar kubectl en Linux

    1. Descargue el dato binario de kubectl para la versión de Kubernetes del clúster desde Amazon S3 usando 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.23

        curl -o kubectl https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.7/2022-06-29/bin/linux/amd64/kubectl
        curl -o kubectl https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.7/2022-06-29/bin/linux/arm64/kubectl
      • Kubernetes 1.22

        curl -o kubectl https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.6/2022-03-09/bin/linux/amd64/kubectl
        curl -o kubectl https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.6/2022-03-09/bin/linux/arm64/kubectl
      • Kubernetes 1.21

        curl -o kubectl https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.2/2021-07-05/bin/linux/amd64/kubectl
        curl -o kubectl https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.2/2021-07-05/bin/linux/arm64/kubectl
      • Kubernetes 1.20

        curl -o kubectl https://s3.us-west-2.amazonaws.com/amazon-eks/1.20.4/2021-04-12/bin/linux/amd64/kubectl
        curl -o kubectl https://s3.us-west-2.amazonaws.com/amazon-eks/1.20.4/2021-04-12/bin/linux/arm64/kubectl
      • Kubernetes 1.19

        curl -o kubectl https://s3.us-west-2.amazonaws.com/amazon-eks/1.19.6/2021-01-05/bin/linux/amd64/kubectl
        curl -o kubectl https://s3.us-west-2.amazonaws.com/amazon-eks/1.19.6/2021-01-05/bin/linux/arm64/kubectl
      • Kubernetes 1.18

        curl -o kubectl https://s3.us-west-2.amazonaws.com/amazon-eks/1.18.9/2020-11-02/bin/linux/amd64/kubectl
        curl -o kubectl https://s3.us-west-2.amazonaws.com/amazon-eks/1.18.9/2020-11-02/bin/linux/arm64/kubectl
    2. (Opcional) Compruebe el dato binario descargado con la suma SHA-256 de su dato binario.

      1. Descargue la suma SHA-256 para la versión de Kubernetes del clúster desde Amazon S3 usando 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.23

          curl -o kubectl.sha256 https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.7/2022-06-29/bin/linux/amd64/kubectl.sha256
          curl -o kubectl.sha256 https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.7/2022-06-29/bin/linux/arm64/kubectl.sha256
        • Kubernetes 1.22

          curl -o kubectl.sha256 https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.6/2022-03-09/bin/linux/amd64/kubectl.sha256
          curl -o kubectl.sha256 https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.6/2022-03-09/bin/linux/arm64/kubectl.sha256
        • Kubernetes 1.21

          curl -o kubectl.sha256 https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.2/2021-07-05/bin/linux/amd64/kubectl.sha256
          curl -o kubectl.sha256 https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.2/2021-07-05/bin/linux/arm64/kubectl.sha256
        • Kubernetes 1.20

          curl -o kubectl.sha256 https://s3.us-west-2.amazonaws.com/amazon-eks/1.20.4/2021-04-12/bin/linux/amd64/kubectl.sha256
          curl -o kubectl.sha256 https://s3.us-west-2.amazonaws.com/amazon-eks/1.20.4/2021-04-12/bin/linux/arm64/kubectl.sha256
        • Kubernetes 1.19

          curl -o kubectl.sha256 https://s3.us-west-2.amazonaws.com/amazon-eks/1.19.6/2021-01-05/bin/linux/amd64/kubectl.sha256
          curl -o kubectl.sha256 https://s3.us-west-2.amazonaws.com/amazon-eks/1.19.6/2021-01-05/bin/linux/arm64/kubectl.sha256
        • Kubernetes 1.18

          curl -o kubectl.sha256 https://s3.us-west-2.amazonaws.com/amazon-eks/1.18.9/2020-11-02/bin/linux/amd64/kubectl.sha256
          curl -o kubectl.sha256 https://s3.us-west-2.amazonaws.com/amazon-eks/1.18.9/2020-11-02/bin/linux/arm64/kubectl.sha256
      2. Verifique la suma SHA-256 del dato binario descargado.

        openssl sha1 -sha256 kubectl
      3. Compare la suma SHA-256 generada en la salida del comando con el archivo SHA-256 descargado. Los dos deben coincidir.

    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=$PATH:$HOME/bin
    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=$PATH:$HOME/bin' >> ~/.bashrc
    6. Una vez instalado kubectl, puede comprobar la versión con el comando siguiente:

      kubectl version --short --client
    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.23

        curl -o kubectl.exe https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.7/2022-06-29/bin/windows/amd64/kubectl.exe
      • Kubernetes 1.22

        curl -o kubectl.exe https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.6/2022-03-09/bin/windows/amd64/kubectl.exe
      • Kubernetes 1.21

        curl -o kubectl.exe https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.2/2021-07-05/bin/windows/amd64/kubectl.exe
      • Kubernetes 1.20

        curl -o kubectl.exe https://s3.us-west-2.amazonaws.com/amazon-eks/1.20.4/2021-04-12/bin/windows/amd64/kubectl.exe
      • Kubernetes 1.19

        curl -o kubectl.exe https://s3.us-west-2.amazonaws.com/amazon-eks/1.19.6/2021-01-05/bin/windows/amd64/kubectl.exe
      • Kubernetes 1.18

        curl -o kubectl.exe https://s3.us-west-2.amazonaws.com/amazon-eks/1.18.9/2020-11-02/bin/windows/amd64/kubectl.exe
    3. (Opcional) Compruebe el dato binario descargado con la suma SHA-256 de su dato binario.

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

        • Kubernetes 1.23

          curl -o kubectl.exe.sha256 https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.7/2022-06-29/bin/windows/amd64/kubectl.exe.sha256
        • Kubernetes 1.22

          curl -o kubectl.exe.sha256 https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.6/2022-03-09/bin/windows/amd64/kubectl.exe.sha256
        • Kubernetes 1.21

          curl -o kubectl.exe.sha256 https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.2/2021-07-05/bin/windows/amd64/kubectl.exe.sha256
        • Kubernetes 1.20

          curl -o kubectl.exe.sha256 https://s3.us-west-2.amazonaws.com/amazon-eks/1.20.4/2021-04-12/bin/windows/amd64/kubectl.exe.sha256
        • Kubernetes 1.19

          curl -o kubectl.exe.sha256 https://s3.us-west-2.amazonaws.com/amazon-eks/1.19.6/2021-01-05/bin/windows/amd64/kubectl.exe.sha256
        • Kubernetes 1.18

          curl -o kubectl.exe.sha256 https://s3.us-west-2.amazonaws.com/amazon-eks/1.18.9/2020-11-02/bin/windows/amd64/kubectl.exe.sha256
      2. Verifique la suma SHA-256 del dato binario descargado.

        Get-FileHash kubectl.exe
      3. Compare la suma SHA-256 generada en la salida del comando con el archivo SHA-256 descargado. Los dos deben coincidir, aunque la salida de PowerShell estará 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.

    5. Una vez instalado kubectl, puede comprobar la versión con el comando siguiente:

      kubectl version --short --client