Ajudar a melhorar esta página
Quer contribuir para este guia do usuário? Role até o final desta página e selecione Editar esta página no GitHub. Suas contribuições ajudarão a tornar nosso guia do usuário melhor para todos.
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
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.29
funciona com clusters do Kubernetes 1.28
, 1.29
e 1.30
.
Para instalar ou atualizar o kubectl
-
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: v
1.30.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. -
Instale ou atualize o
kubectl
nos sistemas operacionaismacOS
, Linux e Windows.- macOS
-
Para instalar ou atualizar o
kubectl
nomacOS
-
Baixe do Amazon S3 o binário para a versão do Kubernetes do cluster.
Kubernetes
1.30
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/darwin/amd64/kubectl
Kubernetes
1.29
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.3/2024-04-19/bin/darwin/amd64/kubectl
Kubernetes
1.28
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.8/2024-04-19/bin/darwin/amd64/kubectl
-
Kubernetes
1.27
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.12/2024-04-19/bin/darwin/amd64/kubectl
-
Kubernetes
1.26
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-04-19/bin/darwin/amd64/kubectl
-
Kubernetes
1.25
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-04-19/bin/darwin/amd64/kubectl
-
Kubernetes
1.24
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-04-19/bin/darwin/amd64/kubectl
-
Kubernetes
1.23
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-04-19/bin/darwin/amd64/kubectl
-
Kubernetes
1.22
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-04-19/bin/darwin/amd64/kubectl
-
Kubernetes
1.21
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-04-19/bin/darwin/amd64/kubectl
-
(Opcional) Verifique o binário baixado com a soma de verificação do
SHA-256
para o seu binário.-
Baixe a soma de verificação
SHA-256
para a versão Kubernetes do cluster.Kubernetes
1.30
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/darwin/amd64/kubectl.sha256
Kubernetes
1.29
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.3/2024-04-19/bin/darwin/amd64/kubectl.sha256
Kubernetes
1.28
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.8/2024-04-19/bin/darwin/amd64/kubectl.sha256
-
Kubernetes
1.27
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.12/2024-04-19/bin/darwin/amd64/kubectl.sha256
-
Kubernetes
1.26
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-04-19/bin/darwin/amd64/kubectl.sha256
-
Kubernetes
1.25
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-04-19/bin/darwin/amd64/kubectl.sha256
-
Kubernetes
1.24
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-04-19/bin/darwin/amd64/kubectl.sha256
-
Kubernetes
1.23
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-04-19/bin/darwin/amd64/kubectl.sha256
-
Kubernetes
1.22
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-04-19/bin/darwin/amd64/kubectl.sha256
-
Kubernetes
1.21
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-04-19/bin/darwin/amd64/kubectl.sha256
-
Verifique a soma de verificação
SHA-256
para o binário baixado.openssl sha1 -sha256 kubectl
-
Verifique se a soma de verificação gerada no resultado corresponde à soma de verificação no arquivo
kubectl.sha256
baixado.
-
-
Aplique permissões de execução ao binário.
chmod +x ./kubectl
-
Copie o binário em uma pasta em seu
PATH
. Se você já tiver instalado uma versão dokubectl
, 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
-
(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
)-
Baixe do Amazon S3 o binário do
kubectl
para a versão do Kubernetes do cluster.-
Kubernetes
1.30
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/linux/amd64/kubectl
-
Kubernetes
1.30
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/linux/amd64/kubectl
-
Kubernetes
1.29
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.3/2024-04-19/bin/linux/amd64/kubectl
-
Kubernetes
1.28
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.8/2024-04-19/bin/linux/amd64/kubectl
-
Kubernetes
1.27
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.12/2024-04-19/bin/linux/amd64/kubectl
-
Kubernetes
1.26
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-04-19/bin/linux/amd64/kubectl
-
Kubernetes
1.25
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-04-19/bin/linux/amd64/kubectl
-
Kubernetes
1.24
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-04-19/bin/linux/amd64/kubectl
-
Kubernetes
1.23
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-04-19/bin/linux/amd64/kubectl
-
Kubernetes
1.22
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-04-19/bin/linux/amd64/kubectl
-
Kubernetes
1.21
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-04-19/bin/linux/amd64/kubectl
-
-
(Opcional) Verifique o binário baixado com a soma de verificação do
SHA-256
para o seu binário.-
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 é paraamd64
e o segundo link é paraarm64
.-
Kubernetes
1.30
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/linux/amd64/kubectl.sha256
-
Kubernetes
1.30
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/linux/amd64/kubectl.sha256
-
Kubernetes
1.29
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.3/2024-04-19/bin/linux/amd64/kubectl.sha256
-
Kubernetes
1.28
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.8/2024-04-19/bin/linux/amd64/kubectl.sha256
-
Kubernetes
1.27
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.12/2024-04-19/bin/linux/amd64/kubectl.sha256
-
Kubernetes
1.26
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-04-19/bin/linux/amd64/kubectl.sha256
-
Kubernetes
1.25
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-04-19/bin/linux/amd64/kubectl.sha256
-
Kubernetes
1.24
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-04-19/bin/linux/amd64/kubectl.sha256
-
Kubernetes
1.23
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-04-19/bin/linux/amd64/kubectl.sha256
-
Kubernetes
1.22
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-04-19/bin/linux/amd64/kubectl.sha256
-
Kubernetes
1.21
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-04-19/bin/linux/amd64/kubectl.sha256
-
-
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.
-
-
-
Aplique permissões de execução ao binário.
chmod +x ./kubectl
-
Copie o binário em uma pasta em seu
PATH
. Se você já tiver instalado uma versão dokubectl
, 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
-
(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
)-
Baixe do Amazon S3 o binário do
kubectl
para a versão do Kubernetes do cluster.-
Kubernetes
1.30
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/linux/arm64/kubectl
-
Kubernetes
1.30
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/linux/arm64/kubectl
-
Kubernetes
1.29
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.3/2024-04-19/bin/linux/arm64/kubectl
-
Kubernetes
1.28
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.8/2024-04-19/bin/linux/arm64/kubectl
-
Kubernetes
1.27
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.12/2024-04-19/bin/linux/arm64/kubectl
-
Kubernetes
1.26
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-04-19/bin/linux/arm64/kubectl
-
Kubernetes
1.25
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-04-19/bin/linux/arm64/kubectl
-
Kubernetes
1.24
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-04-19/bin/linux/arm64/kubectl
-
Kubernetes
1.23
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-04-19/bin/linux/arm64/kubectl
-
Kubernetes
1.22
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-04-19/bin/linux/arm64/kubectl
-
Kubernetes
1.21
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-04-19/bin/linux/arm64/kubectl
-
-
(Opcional) Verifique o binário baixado com a soma de verificação do
SHA-256
para o seu binário.-
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 é paraamd64
e o segundo link é paraarm64
.-
Kubernetes
1.30
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/linux/arm64/kubectl.sha256
-
Kubernetes
1.30
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/linux/arm64/kubectl.sha256
-
Kubernetes
1.29
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.3/2024-04-19/bin/linux/arm64/kubectl.sha256
-
Kubernetes
1.28
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.8/2024-04-19/bin/linux/arm64/kubectl.sha256
-
Kubernetes
1.27
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.12/2024-04-19/bin/linux/arm64/kubectl.sha256
-
Kubernetes
1.26
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-04-19/bin/linux/arm64/kubectl.sha256
-
Kubernetes
1.25
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-04-19/bin/linux/arm64/kubectl.sha256
-
Kubernetes
1.24
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-04-19/bin/linux/arm64/kubectl.sha256
-
Kubernetes
1.23
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-04-19/bin/linux/arm64/kubectl.sha256
-
Kubernetes
1.22
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-04-19/bin/linux/arm64/kubectl.sha256
-
Kubernetes
1.21
curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-04-19/bin/linux/arm64/kubectl.sha256
-
-
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.
-
-
-
Aplique permissões de execução ao binário.
chmod +x ./kubectl
-
Copie o binário em uma pasta em seu
PATH
. Se você já tiver instalado uma versão dokubectl
, 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
-
(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-
Abra um terminal do PowerShell.
-
Baixe do Amazon S3 o binário do
kubectl
para a versão do Kubernetes do cluster.Kubernetes
1.30
curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/windows/amd64/kubectl.exe
Kubernetes
1.29
curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.3/2024-04-19/bin/windows/amd64/kubectl.exe
Kubernetes
1.28
curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.8/2024-04-19/bin/windows/amd64/kubectl.exe
-
Kubernetes
1.27
curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.12/2024-04-19/bin/windows/amd64/kubectl.exe
-
Kubernetes
1.26
curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-04-19/bin/windows/amd64/kubectl.exe
-
Kubernetes
1.25
curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-04-19/bin/windows/amd64/kubectl.exe
-
Kubernetes
1.24
curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-04-19/bin/windows/amd64/kubectl.exe
-
Kubernetes
1.23
curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-04-19/bin/windows/amd64/kubectl.exe
-
Kubernetes
1.22
curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-04-19/bin/windows/amd64/kubectl.exe
-
Kubernetes
1.21
curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-04-19/bin/windows/amd64/kubectl.exe
-
(Opcional) Verifique o binário baixado com a soma de verificação do
SHA-256
para o seu binário.-
Baixe a soma de verificação
SHA-256
para a versão Kubernetes para Windows do cluster.Kubernetes
1.30
curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/windows/amd64/kubectl.exe.sha256
Kubernetes
1.29
curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.3/2024-04-19/bin/windows/amd64/kubectl.exe.sha256
Kubernetes
1.28
curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.8/2024-04-19/bin/windows/amd64/kubectl.exe.sha256
-
Kubernetes
1.27
curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.12/2024-04-19/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-04-19/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-04-19/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-04-19/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-04-19/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-04-19/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-04-19/bin/windows/amd64/kubectl.exe.sha256
-
Verifique a soma de verificação
SHA-256
para o binário baixado.Get-FileHash kubectl.exe
-
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.
-
-
Copie o binário em uma pasta em seu
PATH
. Se você tiver um diretório existente noPATH
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.-
Crie um novo diretório para os binários de linha de comando, como
C:\bin
. -
Copie o binário
kubectl.exe
no seu novo diretório. -
Edite a variável de ambiente
PATH
do sistema ou usuário para adicionar o novo diretório aoPATH
. -
Feche o terminal do PowerShell e abra um novo para escolher a nova variável
PATH
.
-
-
-
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
pela Região da AWS em que está o cluster. Substitua o region-code
pelo nome do cluster.my-cluster
aws eks update-kubeconfig --region
region-code
--namemy-cluster