Instale e configure o kubectl no Windows

Antes de você começar

Você deve usar uma versão do kubectl que esteja próxima da versão do seu cluster. Por exemplo, um cliente v1.31 pode se comunicar com as versões v1.30, v1.31 e v1.32 da camada de gerenciamento. Usar a versão compatível mais recente do kubectl ajuda a evitar problemas inesperados.

Instale o kubectl no Windows

Existem os seguintes métodos para instalar o kubectl no Windows:

• Instale o binário kubectl no Windows (via download direto ou curl)
• Instale no Windows usando Chocolatey, Scoop ou winget

Instale o binário kubectl no Windows (via download direto ou curl)

1. Você tem duas opções para instalar o kubectl em seu dispositivo Windows

   • Download direto:

     Baixe a última versão do patch 1.31 diretamente para sua arquitetura específica visitando a pagina de lançamentos do Kubernetes. Certifique-se de selecionar o binário correto para a sua arquitetura. (e.g., amd64, arm64, etc.).

   • Usando curl:

     Se você tiver o curl instalado, use este comando:

     curl.exe -LO "https://dl.k8s.io/release/v1.31.0/bin/windows/amd64/kubectl.exe"
     

   Nota:

   Para descobrir a versão estável mais recente (por exemplo, para scripts), veja https://dl.k8s.io/release/stable.txt.

2. Validar o binário (opcional)

   Baixe o arquivo de checksum do kubectl:

   curl.exe -LO "https://dl.k8s.io/v1.31.0/bin/windows/amd64/kubectl.exe.sha256"
   

   Valide o binário do kubectl com o arquivo de checksum:

   • Usando o Prompt de Comando para comparar manualmente a saída do CertUtil ao arquivo de checksum baixado:

     CertUtil -hashfile kubectl.exe SHA256
     type kubectl.exe.sha256
     

   • Usando PowerShell para automatizar a verificação com o operador -eq para obter um resultado True ou False:

      $(Get-FileHash -Algorithm SHA256 .\kubectl.exe).Hash -eq $(Get-Content .\kubectl.exe.sha256)
     

3. Adicione (no início ou no final) o diretório do binário kubectl na variável de ambiente PATH.

4. Teste para garantir que a versão do kubectl seja a mesma que foi baixada:

   kubectl version --client
   

   Ou use este comando para uma visão detalhada da versão:

   kubectl version --client --output=yaml
   

Instalar no Windows usando Chocolatey, Scoop, ou winget

1. Para instalar o kubectl no Windows, você pode usar o gerenciador de pacotes Chocolatey, o instalador de linha de comando Scoop ou o gerenciador de pacotes winget.

   • choco
   • scoop
   • winget

   choco install kubernetes-cli
   

   scoop install kubectl
   

   winget install -e --id Kubernetes.kubectl
   

2. Teste para garantir que a versão que você instalou está atualizada:

   kubectl version --client
   

3. Navegue até seu diretório pessoal:

   # Se você estiver usando o cmd.exe, execute: cd %USERPROFILE%
   cd ~
   

4. Crie o diretório .kube:

   mkdir .kube
   

5. Navegue para o diretório .kube que você acabou de criar:

   cd .kube
   

6. Configure o kubectl para usar um cluster Kubernetes remoto:

   New-Item config -type file
   

Verificar a configuração do kubectl

Para que o kubectl encontre e acesse um cluster Kubernetes, ele precisa de um arquivo kubeconfig, que é criado automaticamente quando você cria um cluster usando kube-up.sh ou instala com sucesso um cluster Minikube. Por padrão, a configuração kubectl está localizada em ~/.kube/config.

Verifique se o kubectl está configurado corretamente obtendo o estado do cluster:

kubectl cluster-info

Se você receber uma URL de resposta, o kubectl está configurado corretamente para acessar seu cluster.

Se você receber uma mensagem semelhante à seguinte, o kubectl não está configurado corretamente ou não consegue se conectar a um cluster Kubernetes.

The connection to the server <server-name:port> was refused - did you specify the right host or port?

Por exemplo, se você pretende executar um cluster Kubernetes no seu laptop (localmente), precisará que uma ferramenta como o Minikube seja instalada primeiro, para em seguida executar novamente os comandos indicados acima.

Se o kubectl cluster-info retornar a URL de resposta, mas você não conseguir acessar seu cluster, para verificar se ele está configurado corretamente, use:

kubectl cluster-info dump

Configurações e plugins opcionais do kubectl

Ativar autocompletar no shell

O kubectl oferece suporte ao autocompletar para Bash, Zsh, Fish e PowerShell, o que pode economizar tempo de digitação.

Abaixo estão os procedimentos para configurar o autocompletar no PowerShell.

O script de autocompletar do kubectl para PowerShell, pode ser gerado com o comando kubectl completion powershell.

Para fazer isso em todas as suas sessões de shell, adicione a seguinte linha ao seu arquivo $PROFILE:

kubectl completion powershell | Out-String | Invoke-Expression

Este comando irá regenerar o script de autocompletar toda vez que o PowerShell for iniciado. Você também pode adicionar o script gerado diretamente ao seu arquivo $PROFILE.

Para adicionar o script gerado ao seu arquivo $PROFILE, execute a seguinte linha no prompt do PowerShell:

kubectl completion powershell >> $PROFILE

Após recarregar seu shell, o autocompletar do kubectl deve estar funcionando.

Instalar o plugin kubectl convert

Um plugin para a ferramenta Kubernetes de linha de comando kubectl, que permite converter manifestos entre diferentes versões da API. Isso pode ser particularmente útil para migrar manifestos para uma versão não obsoleta com a versão mais recente da API Kubernetes. Para mais informações, visite Migrar para APIs não obsoletas

1. Baixe a última versão com este comando:

   curl.exe -LO "https://dl.k8s.io/release/v1.31.0/bin/windows/amd64/kubectl-convert.exe"
   

2. Validar o binário (opcional).

   Baixe o arquivo de checksum do kubectl-convert:

   curl.exe -LO "https://dl.k8s.io/v1.31.0/bin/windows/amd64/kubectl-convert.exe.sha256"
   

   Valide o binário do kubectl-convert com o arquivo de checksum:

   • Usando o Prompt de Comando para comparar manualmente a saída do CertUtil ao arquivo de checksum baixado:

     CertUtil -hashfile kubectl-convert.exe SHA256
     type kubectl-convert.exe.sha256
     

   • Usando PowerShell para automatizar a verificação com o operador -eq para obter um resultado True ou False:

     $($(CertUtil -hashfile .\kubectl-convert.exe SHA256)[1] -replace " ", "") -eq $(type .\kubectl-convert.exe.sha256)
     

3. Adicione (no início ou no final) o diretório do binário kubectl-convert na variável de ambiente PATH.

4. Verifique se o plugin foi instalado com sucesso.

   kubectl convert --help
   

   Se você não ver um erro, isso significa que o plugin foi instalado com sucesso.

5. Após instalar o plugin, limpe os arquivos de instalação:

   del kubectl-convert.exe
   del kubectl-convert.exe.sha256
   

Próximos passos

• Instale o Minikube
• Veja os guias de introdução para saber mais sobre a criação de clusters.
• Saiba como iniciar e publicar sua aplicação.
• Se você precisar de acesso a um cluster que não criou, consulte Compartilhamento de Acesso ao Cluster
• Leia os documentos de referência kubectl