# Instale e configure o kubectl no Windows
LLMS index: [llms.txt](/llms.txt)
---
## 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.36 pode se comunicar com as versões v1.35, v1.36 e v1.37 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)](#install-kubectl-binary-on-windows-via-direct-download-or-curl)
- [Instale no Windows usando Chocolatey, Scoop ou winget](#install-nonstandard-package-tools)
### Instale o binário kubectl no Windows (via download direto ou curl) {#install-kubectl-binary-on-windows-via-direct-download-or-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.36 diretamente para sua arquitetura específica visitando a [pagina de lançamentos do Kubernetes](https://kubernetes.io/releases/download/#binaries). 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:
```powershell
curl.exe -LO "https://dl.k8s.io/release/v1.36.0/bin/windows/amd64/kubectl.exe"
```
2. Validar o binário (opcional)
Baixe o arquivo de checksum do `kubectl`:
```powershell
curl.exe -LO "https://dl.k8s.io/v1.36.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:
```cmd
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`:
```powershell
$(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:
```cmd
kubectl version --client
```
Ou use este comando para uma visão detalhada da versão:
```cmd
kubectl version --client --output=yaml
```
Nota
Docker Desktop para Windows
adiciona sua própria versão do
kubectl ao
PATH. Se você instalou o Docker Desktop anteriormente,
pode ser necessário colocar sua entrada no
PATH antes da adicionada pelo instalador do Docker Desktop
ou remover o
kubectl do Docker Desktop.
choco install kubernetes-cli
winget install -e --id Kubernetes.kubectl
Nota
Edite o arquivo de configuração com um editor de texto de sua escolha, como o Notepad.
## 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:
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 comando kubectl cluster-info retornar a URL de resposta, mas você não conseguir
acessar seu cluster, use o comando abaixo para verificar se ele está configurado
corretamente:
kubectl cluster-info dump
Depurando a mensagem de erro 'No Auth Provider Found'
No Kubernetes 1.26, o kubectl removeu os autenticadores embutidos para as distribuições
de Kubernetes dos provedores de nuvem abaixo. Estes provedores lançaram plugins
para o kubectl que fornecem autenticação específica para a nuvem. Para instruções,
veja as seguintes documentações de cada provedor:
Também podem haver outras razões para que a mesma mensagem de erro ocorra, não
relacionadas a esta mudança.
## 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:
```powershell
curl.exe -LO "https://dl.k8s.io/release/v1.36.0/bin/windows/amd64/kubectl-convert.exe"
```
2. Validar o binário (opcional).
Baixe o arquivo de checksum do `kubectl-convert`:
```powershell
curl.exe -LO "https://dl.k8s.io/v1.36.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:
```cmd
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`:
```powershell
$($(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.
```shell
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:
```powershell
del kubectl-convert.exe
del kubectl-convert.exe.sha256
```
## Próximos passos