Instalação do kubectl - Amazon EKS

Instalação do kubectl

O Kubernetes usa um utilitário de linha de comando chamado kubectl para se comunicar com o servidor da API do cluster. O binário kubectl está disponível em muitos gerenciadores de pacotes de sistema operacional, e essa opção geralmente é muito mais fácil do que o processo de download e instalação manual. Você pode seguir as instruções para seu sistema operacional ou gerenciadores de pacotes específicos na Documentação do Kubernetes para instalar.

Este tópico ajuda a baixar e instalar os binários kubectl fornecidos pelo Amazon EKS para sistemas operacionais macOS, Linux e Windows. Selecione o nome da guia do seu sistema operacional. Esses binários são idênticos às versões da comunidade upstream, e não são exclusivos 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 kubectl 1.20 deve funcionar com clusters do Kubernetes 1.19, 1.20 e 1.21.

Selecione a guia com o nome do sistema operacional no qual você deseja instalar o kubectl.

macOS

Para instalar o kubectl no MacOS

  1. Faça download do binário kubectl fornecido pelo Amazon EKS para a versão do Kubernetes do cluster no Amazon S3.

    • Kubernetes 1.21

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

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

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

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/darwin/amd64/kubectl
    • Kubernetes 1.17

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/darwin/amd64/kubectl
  2. (Opcional) Verifique se o binário baixado com a soma SHA-256 para o binário.

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

      • Kubernetes 1.21

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

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

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

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/darwin/amd64/kubectl.sha256
      • Kubernetes 1.17

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/darwin/amd64/kubectl.sha256
    2. Verifique a soma de SHA-256 para o binário obtido por download.

      openssl sha1 -sha256 kubectl
    3. Compare a soma de SHA-256 gerada na saída do comando com o seu arquivo SHA-256 baixado. Os dois devem corresponder.

  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=$PATH:$HOME/bin' >> ~/.bash_profile
  6. Depois de instalar o kubectl, você pode verificar a versão com o seguinte comando:

    kubectl version --short --client
Linux

Para instalar o kubectl no Linux

  1. Baixe o binário kubectl fornecido pelo Amazon EKS para a versão do Kubernetes do seu cluster no Simple Storage Service (Amazon S3) por meio do comando para a sua plataforma de hardware.

    • Kubernetes 1.21

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

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

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

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/linux/amd64/kubectl
      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/linux/arm64/kubectl
    • Kubernetes 1.17

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/linux/amd64/kubectl
      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/linux/arm64/kubectl
  2. (Opcional) Verifique se o binário baixado com a soma SHA-256 para o binário.

    1. Baixe a soma de SHA-256 para a versão do Kubernetes do seu cluster para Linux por meio do comando para a sua plataforma de hardware.

      • Kubernetes 1.21

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

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

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

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/linux/amd64/kubectl.sha256
        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/linux/arm64/kubectl.sha256
      • Kubernetes 1.17

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/linux/amd64/kubectl.sha256
        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/linux/arm64/kubectl.sha256
    2. Verifique a soma de SHA-256 para o binário obtido por download.

      openssl sha1 -sha256 kubectl
    3. Compare a soma de SHA-256 gerada na saída do comando com o seu arquivo SHA-256 baixado. Os dois devem corresponder.

  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=$PATH:$HOME/bin
  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=$PATH:$HOME/bin' >> ~/.bashrc
  6. Depois de instalar o kubectl, você pode verificar a versão com o seguinte comando:

    kubectl version --short --client
Windows

Para instalar o kubectl no Windows

  1. Abra um terminal do PowerShell.

  2. Faça download do binário kubectl fornecido pelo Amazon EKS para a versão do Kubernetes do cluster no Amazon S3.

    • Kubernetes 1.21

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

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

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

      curl -o kubectl.exe https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/windows/amd64/kubectl.exe
    • Kubernetes 1.17

      curl -o kubectl.exe https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/windows/amd64/kubectl.exe
  3. (Opcional) Verifique se o binário baixado com a soma SHA-256 para o binário.

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

      • Kubernetes 1.21

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

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

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

        curl -o kubectl.exe.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/windows/amd64/kubectl.exe.sha256
      • Kubernetes 1.17

        curl -o kubectl.exe.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/windows/amd64/kubectl.exe.sha256
    2. Verifique a soma de SHA-256 para o binário obtido por download.

      Get-FileHash kubectl.exe
    3. Compare a soma de SHA-256 gerada na saída do comando com o seu arquivo SHA-256 baixado. Os dois devem corresponder, embora a saída do PowerShell tenha letras maiúsculas.

  4. Copie o binário em uma pasta em seu PATH. Se você tem um diretório existente no PATH que você usa 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.

  5. Depois de instalar o kubectl, você pode verificar a versão com o seguinte comando:

    kubectl version --short --client