Ajudar a melhorar esta página
Para contribuir com este guia de usuário, escolha o link Editar esta página no GitHub, disponível no painel direito de cada página.
Configurar o kubectl e o eksctl
Após a AWS CLI ser instalada, há duas outras ferramentas que você deve instalar para criar e gerenciar seus clusters do Kubernetes:
-
kubectl: a ferramenta de linha de comandokubectlé a principal ferramenta que você usará para gerenciar recursos em seu cluster do Kubernetes. Esta página descreve como baixar e configurar o bináriokubectlque corresponde à versão do seu cluster do Kubernetes. Consulte Instalar ou atualizar o kubectl. -
eksctl: a ferramenta de linha de comandoeksctlfoi criada para criar clusters do EKS na Nuvem AWS ou on-premises (com o EKS Anywhere), bem como para modificar e excluir esses clusters. Consulte Instalar eksctl.
Instalar ou atualizar o kubectl
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 upstreamkubectl necessária, embora muitos construtores simplesmente executem brew install kubectl para instalá-la.
nota
Você deve usar uma versão do kubectl que esteja em uma versão secundária de diferença do ambiente de gerenciamento do cluster do Amazon EKS. Por exemplo, um cliente 1.32 kubectl funciona com clusters do Kubernetes 1.31, 1.32 e 1.33.
Etapa 1: verifique se o kubectl está instalado
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.31.X-eks-1234567
Se não receber nenhum resultado, você não tem o kubectl instalado ou ele não está instalado em um local que esteja no caminho do seu dispositivo.
Etapa 2: instalar ou atualizar kubectl
Instale ou atualize o kubectl em um dos seguintes sistemas operacionais:
nota
Se os downloads estiverem lentos para a sua região da AWS das regiões da AWS usadas nesta seção, considere configurar o CloudFront para trazer o conteúdo para frente. Para obter mais informações, consulte Começar a usar uma distribuição básica do CloudFront.
macOS
Siga as etapas abaixo para instalar o kubectl no macOS. As etapas incluem:
-
Escolher e baixar o binário para a versão do Kubernetes desejada.
-
Opcionalmente, verificar a soma de verificação do binário.
-
Adicionar execução às permissões do binário.
-
Copiar o binário em uma pasta em sua variável PATH.
-
Opcionalmente, adicionar o diretório do binário a sua variável PATH.
Procedimento:
-
Baixe o binário para a versão do Kubernetes do cluster do Amazon S3.
-
Kubernetes
1.33curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.3/2025-08-03/bin/darwin/amd64/kubectl -
Kubernetes
1.32curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.7/2025-08-03/bin/darwin/amd64/kubectl -
Kubernetes
1.31curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.11/2025-08-03/bin/darwin/amd64/kubectl -
Kubernetes
1.30curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2025-08-03/bin/darwin/amd64/kubectl -
Kubernetes
1.29curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2025-08-03/bin/darwin/amd64/kubectl -
Kubernetes
1.28curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.15/2025-08-03/bin/darwin/amd64/kubectl -
Kubernetes
1.27curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.16/2025-01-10/bin/darwin/amd64/kubectl -
Kubernetes
1.26curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-12-12/bin/darwin/amd64/kubectl
-
-
(Opcional) Verifique o binário baixado com a soma de verificação do
SHA-256para o seu binário.-
Baixe a soma de verificação do
SHA-256para a versão do Kubernetes do cluster.-
Kubernetes
1.33curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.3/2025-08-03/bin/darwin/amd64/kubectl.sha256 -
Kubernetes
1.32curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.7/2025-08-03/bin/darwin/amd64/kubectl.sha256 -
Kubernetes
1.31curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.11/2025-08-03/bin/darwin/amd64/kubectl.sha256 -
Kubernetes
1.30curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2025-08-03/bin/darwin/amd64/kubectl.sha256 -
Kubernetes
1.29curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2025-08-03/bin/darwin/amd64/kubectl.sha256 -
Kubernetes
1.28curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.15/2025-08-03/bin/darwin/amd64/kubectl.sha256 -
Kubernetes
1.27curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.16/2025-01-10/bin/darwin/amd64/kubectl.sha256 -
Kubernetes
1.26curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-12-12/bin/darwin/amd64/kubectl.sha256
-
-
Verifique a soma de verificação
SHA-256para 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.sha256baixado.
-
-
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/kubectle garantir que$HOME/binvenha primeiro em seu$PATH.mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH -
(Opcional) Adicione o caminho
$HOME/binao 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)
Siga as etapas abaixo para instalar o kubectl no Linux (amd64). As etapas incluem:
-
Escolher e baixar o binário para a versão do Kubernetes desejada.
-
Opcionalmente, verificar a soma de verificação do binário.
-
Adicionar execução às permissões do binário.
-
Copiar o binário em uma pasta em sua variável PATH.
-
Opcionalmente, adicionar o diretório do binário a sua variável PATH.
Procedimento:
-
Baixe o binário
kubectlpara a versão do Kubernetes do cluster do Amazon S3.-
Kubernetes
1.33curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.3/2025-08-03/bin/linux/amd64/kubectl -
Kubernetes
1.32curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.7/2025-08-03/bin/linux/amd64/kubectl -
Kubernetes
1.31curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.11/2025-08-03/bin/linux/amd64/kubectl -
Kubernetes
1.30curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2025-08-03/bin/linux/amd64/kubectl -
Kubernetes
1.29curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2025-08-03/bin/linux/amd64/kubectl -
Kubernetes
1.28curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.15/2025-08-03/bin/linux/amd64/kubectl -
Kubernetes
1.27curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.16/2024-12-12/bin/linux/amd64/kubectl -
Kubernetes
1.26curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-12-12/bin/linux/amd64/kubectl
-
-
(Opcional) Verifique o binário baixado com a soma de verificação do
SHA-256para o seu binário.-
Baixe a soma de verificação do
SHA-256para a versão do Kubernetes do cluster do Amazon S3 usando o comando para a plataforma de hardware do seu dispositivo.-
Kubernetes
1.33curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.3/2025-08-03/bin/linux/amd64/kubectl.sha256 -
Kubernetes
1.32curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.7/2025-08-03/bin/linux/amd64/kubectl.sha256 -
Kubernetes
1.31curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.11/2025-08-03/bin/linux/amd64/kubectl.sha256 -
Kubernetes
1.30curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2025-08-03/bin/linux/amd64/kubectl.sha256 -
Kubernetes
1.29curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2025-08-03/bin/linux/amd64/kubectl.sha256 -
Kubernetes
1.28curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.15/2025-08-03/bin/linux/amd64/kubectl.sha256 -
Kubernetes
1.27curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.16/2024-12-12/bin/linux/amd64/kubectl.sha256 -
Kubernetes
1.26curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-12-12/bin/linux/amd64/kubectl.sha256
-
-
Verifique a soma de verificação
SHA-256do binário baixado com um dos comandos a seguir.sha256sum -c kubectl.sha256or
openssl sha1 -sha256 kubectl -
No primeiro, você deve ver
kubectl: OK; no segundo, confirme se a soma de verificação gerada no resultado corresponde à soma de verificação no arquivokubectl.sha256baixado.
-
-
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/kubectle garantir que$HOME/binvenha primeiro em seu$PATH.mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH -
(Opcional) Adicione o caminho
$HOME/binao 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)
Siga as etapas abaixo para instalar o kubectl no Linux (arm64). As etapas incluem:
-
Escolher e baixar o binário para a versão do Kubernetes desejada.
-
Opcionalmente, verificar a soma de verificação do binário.
-
Adicionar execução às permissões do binário.
-
Copiar o binário em uma pasta em sua variável PATH.
-
Opcionalmente, adicionar o diretório do binário a sua variável PATH.
Procedimento:
-
Baixe o binário
kubectlpara a versão do Kubernetes do cluster do Amazon S3.-
Kubernetes
1.33curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.3/2025-08-03/bin/linux/arm64/kubectl -
Kubernetes
1.32curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.7/2025-08-03/bin/linux/arm64/kubectl -
Kubernetes
1.31curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.11/2025-08-03/bin/linux/arm64/kubectl -
Kubernetes
1.30curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2025-08-03/bin/linux/arm64/kubectl -
Kubernetes
1.29curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2025-08-03/bin/linux/arm64/kubectl -
Kubernetes
1.28curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.15/2025-08-03/bin/linux/arm64/kubectl -
Kubernetes
1.27curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.16/2024-12-12/bin/linux/arm64/kubectl -
Kubernetes
1.26curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-12-12/bin/linux/arm64/kubectl
-
-
(Opcional) Verifique o binário baixado com a soma de verificação do
SHA-256para o seu binário.-
Baixe a soma de verificação do
SHA-256para a versão do Kubernetes do cluster do Amazon S3 usando o comando para a plataforma de hardware do seu dispositivo.-
Kubernetes
1.33curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.3/2025-08-03/bin/linux/arm64/kubectl.sha256 -
Kubernetes
1.32curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.7/2025-08-03/bin/linux/arm64/kubectl.sha256 -
Kubernetes
1.31curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.11/2025-08-03/bin/linux/arm64/kubectl.sha256 -
Kubernetes
1.30curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2025-08-03/bin/linux/arm64/kubectl.sha256 -
Kubernetes
1.29curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2025-08-03/bin/linux/arm64/kubectl.sha256 -
Kubernetes
1.28curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.15/2025-08-03/bin/linux/arm64/kubectl.sha256 -
Kubernetes
1.27curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.16/2024-12-12/bin/linux/arm64/kubectl.sha256 -
Kubernetes
1.26curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-12-12/bin/linux/arm64/kubectl.sha256
-
-
Verifique a soma de verificação
SHA-256do binário baixado com um dos comandos a seguir.sha256sum -c kubectl.sha256or
openssl sha1 -sha256 kubectl -
No primeiro, você deve ver
kubectl: OK; no segundo, confirme se a soma de verificação gerada no resultado corresponde à soma de verificação no arquivokubectl.sha256baixado.
-
-
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/kubectle garantir que$HOME/binvenha primeiro em seu$PATH.mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH -
(Opcional) Adicione o caminho
$HOME/binao 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
Siga as etapas abaixo para instalar o kubectl no Windows. As etapas incluem:
-
Escolher e baixar o binário para a versão do Kubernetes desejada.
-
Opcionalmente, verificar a soma de verificação do binário.
-
Copiar o binário em uma pasta em sua variável PATH.
-
Opcionalmente, adicionar o diretório do binário a sua variável PATH.
Procedimento:
-
Abra um terminal do PowerShell.
-
Baixe o binário
kubectlpara a versão do Kubernetes do cluster do Amazon S3.-
Kubernetes
1.33curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.3/2025-08-03/bin/windows/amd64/kubectl.exe -
Kubernetes
1.32curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.7/2025-08-03/bin/windows/amd64/kubectl.exe -
Kubernetes
1.31curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.11/2025-08-03/bin/windows/amd64/kubectl.exe -
Kubernetes
1.30curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2025-08-03/bin/windows/amd64/kubectl.exe -
Kubernetes
1.29curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2025-08-03/bin/windows/amd64/kubectl.exe -
Kubernetes
1.28curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.15/2025-08-03/bin/windows/amd64/kubectl.exe -
Kubernetes
1.27curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.16/2024-12-12/bin/windows/amd64/kubectl.exe -
Kubernetes
1.26curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-12-12/bin/windows/amd64/kubectl.exe
-
-
(Opcional) Verifique o binário baixado com a soma de verificação do
SHA-256para o seu binário.-
Baixe a soma de verificação do
SHA-256para a versão do Kubernetes do cluster para Windows.-
Kubernetes
1.33curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.3/2025-08-03/bin/windows/amd64/kubectl.exe.sha256 -
Kubernetes
1.32curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.7/2025-08-03/bin/windows/amd64/kubectl.exe.sha256 -
Kubernetes
1.31curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.11/2025-08-03/bin/windows/amd64/kubectl.exe.sha256 -
Kubernetes
1.30curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2025-08-03/bin/windows/amd64/kubectl.exe.sha256 -
Kubernetes
1.29curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2025-08-03/bin/windows/amd64/kubectl.exe.sha256 -
Kubernetes
1.28curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.15/2025-08-03/bin/windows/amd64/kubectl.exe.sha256 -
Kubernetes
1.27curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.16/2024-12-12/bin/windows/amd64/kubectl.exe.sha256 -
Kubernetes
1.26curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-12-12/bin/windows/amd64/kubectl.exe.sha256
-
-
Verifique a soma de verificação
SHA-256para 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.sha256baixado. 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 noPATHque é 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.exeno seu novo diretório. -
Edite a variável de ambiente
PATHdo 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. Substituaregion-codepela região da AWS em que o cluster se encontra. Substituamy-clusterpelo nome do cluster.aws eks update-kubeconfig --region region-code --name my-cluster -
Considere configurar o preenchimento automático, que permite usar a tecla Tab para preencher os subcomandos do
kubectlapós digitar as primeiras letras. Consulte Kubectl autocompletena documentação do Kubernetes para obter detalhes.
Instalar o eksctl
A CLI do eksctl é usada para trabalhar com clusters do EKS. Ela automatiza muitas tarefas individuais. Consulte Instalaçãoeksctl para obter instruções sobre instalação do eksctl. Para Linux, use as instruções aplicáveis ao UNIX.
Ao usar eksctl, a entidade principal de segurança do IAM que você está usando deve ter permissões para trabalhar com perfis do IAM do Amazon EKS, perfis vinculadas a serviços, AWS CloudFormation, um VPC e recursos relacionados. Para obter mais informações, consulte Ações e uso de perfis vinculadas a serviços no Guia do Usuário do IAM. Você deve concluir todas as etapas deste manual como o mesmo usuário. Execute o seguinte comando para verificar o usuário atual:
aws sts get-caller-identity