Instalar ou atualizar o kubectl

Kubectl é uma ferramenta de linha de comando que você usa para se comunicar com o servidor de API do Kubernetes. O binário kubectl está disponível em muitos gerenciadores de pacotes de sistemas operacionais. Usar um gerenciador de pacotes para a instalação geralmente é mais fácil do que o processo de download e instalação manual.

Este tópico ajuda a baixar e instalar ou atualizar o binário kubectl no dispositivo. O binário é idêntico às versões da comunidade upstream. O binário não é exclusivo do Amazon EKS ou da AWS.

nota

Você deve usar uma versão do kubectl que esteja em uma versão secundária de diferença do plano de controle do cluster do Amazon EKS. Por exemplo, um cliente do kubectl 1.28 funciona com clusters do Kubernetes 1.27, 1.28 e 1.29.

Para instalar ou atualizar o kubectl

1. Determine se você já tem o kubectl instalado no dispositivo.

   kubectl version --client
   

   Se você tiver kubectl instalado no caminho do dispositivo, o resultado de exemplo inclui informações semelhantes às seguintes. Se quiser atualizar a versão instalada atualmente para uma versão posterior, conclua a próxima etapa, certificando-se de instalar a nova versão no mesmo local em que a versão atual está.

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

   Se você não receber nenhuma saída, você não tem o kubectl instalado ou ele não está instalado em um local no caminho do dispositivo.

2. Instale ou atualize o kubectl nos sistemas operacionais macOS, Linux e Windows.

   macOS

   Para instalar ou atualizar o kubectl no macOS

   1. Baixe do Amazon S3 o binário para a versão do Kubernetes do cluster.

      • 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) Verifique o binário baixado com a soma de verificação do SHA-256 para o seu binário.

      1. Baixe a soma de verificação SHA-256 para a versão Kubernetes do cluster.

         • 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 a soma de verificação SHA-256 para o binário baixado.

         openssl sha1 -sha256 kubectl
         

      3. Verifique se a soma de verificação gerada no resultado corresponde à soma de verificação no arquivo kubectl.sha256 baixado.

   3. Aplique permissões de execução ao binário.

      chmod +x ./kubectl
      

   4. Copie o binário em uma pasta em seu PATH. Se você já tiver instalado uma versão do kubectl, recomendamos criar um $HOME/bin/kubectl e garantir que $HOME/bin venha primeiro em seu $PATH.

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

   5. (Opcional) Adicione o caminho $HOME/bin ao arquivo de inicialização do shell para que ele esteja configurado quando você abrir um shell.

      echo 'export PATH=$HOME/bin:$PATH' >> ~/.bash_profile
      

   Linux (amd64)

   Para instalar ou atualizar o kubectl no Linux (amd64)

   1. Baixe do Amazon S3 o binário do kubectl para a versão do Kubernetes do cluster.

      • 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) Verifique o binário baixado com a soma de verificação do SHA-256 para o seu binário.

      1. Baixe a soma de verificação SHA-256 para a versão Kubernetes do cluster do Amazon S3, usando o comando para a plataforma de hardware do dispositivo. O primeiro link para cada versão é para amd64 e o segundo link é 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. Verifique a soma de verificação SHA-256 do binário baixado com um dos comandos a seguir.

         • sha256sum -c kubectl.sha256
           

           Ao usar esse comando, confira se o seguinte comando é exibido:

           kubectl: OK

         • openssl sha1 -sha256 kubectl
           

           Ao usar esse comando, verifique se a soma de verificação gerada no resultado corresponde à soma de verificação no arquivo kubectl.sha256 baixado.

   3. Aplique permissões de execução ao binário.

      chmod +x ./kubectl
      

   4. Copie o binário em uma pasta em seu PATH. Se você já tiver instalado uma versão do kubectl, recomendamos criar um $HOME/bin/kubectl e garantir que $HOME/bin venha primeiro em seu $PATH.

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

   5. (Opcional) Adicione o caminho $HOME/bin ao arquivo de inicialização do shell para que ele esteja configurado quando você abrir um shell.

      nota

      Essa etapa pressupõe que você esteja usando o shell Bash. Se você estiver usando outro shell, altere o comando para usar o arquivo de inicialização do shell.

      echo 'export PATH=$HOME/bin:$PATH' >> ~/.bashrc
      

   Linux (arm64)

   Para instalar ou atualizar o kubectl no Linux (arm64)

   1. Baixe do Amazon S3 o binário do kubectl para a versão do Kubernetes do cluster.

      • 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) Verifique o binário baixado com a soma de verificação do SHA-256 para o seu binário.

      1. Baixe a soma de verificação SHA-256 para a versão Kubernetes do cluster do Amazon S3, usando o comando para a plataforma de hardware do dispositivo. O primeiro link para cada versão é para amd64 e o segundo link é 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. Verifique a soma de verificação SHA-256 do binário baixado com um dos comandos a seguir.

         • sha256sum -c kubectl.sha256
           

           Ao usar esse comando, confira se o seguinte comando é exibido:

           kubectl: OK

         • openssl sha1 -sha256 kubectl
           

           Ao usar esse comando, verifique se a soma de verificação gerada no resultado corresponde à soma de verificação no arquivo kubectl.sha256 baixado.

   3. Aplique permissões de execução ao binário.

      chmod +x ./kubectl
      

   4. Copie o binário em uma pasta em seu PATH. Se você já tiver instalado uma versão do kubectl, recomendamos criar um $HOME/bin/kubectl e garantir que $HOME/bin venha primeiro em seu $PATH.

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

   5. (Opcional) Adicione o caminho $HOME/bin ao arquivo de inicialização do shell para que ele esteja configurado quando você abrir um shell.

      nota

      Essa etapa pressupõe que você esteja usando o shell Bash. Se você estiver usando outro shell, altere o comando para usar o arquivo de inicialização do shell.

      echo 'export PATH=$HOME/bin:$PATH' >> ~/.bashrc
      

   Windows

   Para instalar ou atualizar o kubectl no Windows

   1. Abra um terminal do PowerShell.

   2. Baixe do Amazon S3 o binário do kubectl para a versão do Kubernetes do cluster.

      • 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) Verifique o binário baixado com a soma de verificação do SHA-256 para o seu binário.

      1. Baixe a soma de verificação SHA-256 para a versão Kubernetes para Windows do cluster.

         • 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 a soma de verificação SHA-256 para o binário baixado.

         Get-FileHash kubectl.exe
         

      3. Verifique se a soma de verificação gerada no resultado corresponde à soma de verificação no arquivo kubectl.sha256 baixado. A saída do PowerShell deve ser uma sequência de caracteres equivalente em maiúsculas.

   4. Copie o binário em uma pasta em seu PATH. Se você tiver um diretório existente no PATH que é usado para utilitários de linha de comando, copie o binário para esse diretório. Caso contrário, execute as etapas a seguir.

      1. Crie um novo diretório para os binários de linha de comando, como C:\bin.

      2. Copie o binário kubectl.exe no seu novo diretório.

      3. Edite a variável de ambiente PATH do sistema ou usuário para adicionar o novo diretório ao PATH.

      4. Feche o terminal do PowerShell e abra um novo para escolher a nova variável PATH.

3. Depois de instalar kubectl, você pode verificar a versão.

   kubectl version --client
   

Quando o kubectl é instalado pela primeira vez, ele ainda não está configurado para se comunicar com nenhum servidor. Abordaremos essa configuração conforme necessário em outros procedimentos. Se você precisar atualizar a configuração para se comunicar com um determinado cluster específico, poderá executar o comando a seguir. Substitua region-code pela Região da AWS em que está o cluster. Substitua o my-cluster pelo nome do cluster.

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