Acessar o cluster com kubectl
O kubectl é a ferramenta de linha de comando do Kubernetes. Com ele você inspeciona, gerencia e corrige o que roda no cluster — tarefas que precisam de automação ou de acesso avançado que o painel não oferece.
Antes de começar
- O arquivo kubeconfig do cluster: no painel do cluster, clique em Baixar Config.
- A porta 6443 TCP liberada para o seu IP no grupo de segurança do cluster — veja Grupos de segurança.
1. Baixe o kubeconfig
O kubeconfig contém as credenciais e o endereço da API do cluster. Guarde-o como uma senha: quem tem esse arquivo administra o cluster.
2. Instale o kubectl na mesma versão do cluster
Veja a versão no campo Versão do painel do cluster: v1-34.3 corresponde ao kubectl v1.34.3, e v1-33.6 ao v1.33.6. O kubectl funciona com a versão do cluster e com uma versão acima ou abaixo. Nos exemplos abaixo, troque v1.34.3 pela versão do seu cluster.
- Linux
- macOS
- Windows
curl -LO "https://dl.k8s.io/release/v1.34.3/bin/linux/amd64/kubectl"
chmod +x kubectl
sudo mv kubectl /usr/local/bin/
kubectl version --client
# Apple Silicon (M1 ou mais novo). Em Mac com Intel, troque arm64 por amd64.
curl -LO "https://dl.k8s.io/release/v1.34.3/bin/darwin/arm64/kubectl"
chmod +x kubectl
sudo mv kubectl /usr/local/bin/
kubectl version --client
curl.exe -LO "https://dl.k8s.io/release/v1.34.3/bin/windows/amd64/kubectl.exe"
$env:Path += ";$PWD" # deixa o kubectl desta pasta disponível nesta janela
kubectl version --client
O PowerShell não roda programas da pasta atual só pelo nome. A linha do $env:Path resolve isso até você fechar a janela; para não repetir, mova o kubectl.exe para uma pasta que já esteja no PATH.
3. Rode os comandos
Informe o kubeconfig em cada comando com --kubeconfig:
# Nós do cluster
kubectl --kubeconfig CAMINHO_DO_KUBECONFIG get nodes
# Pods de todos os namespaces
kubectl --kubeconfig CAMINHO_DO_KUBECONFIG get pods -A
# Serviços de todos os namespaces
kubectl --kubeconfig CAMINHO_DO_KUBECONFIG get services -A
Defina a variável KUBECONFIG uma vez por sessão do terminal:
export KUBECONFIG=CAMINHO_DO_KUBECONFIG
kubectl get nodes
No PowerShell:
$env:KUBECONFIG = "C:\caminho\kube.conf"
kubectl get nodes
Problemas comuns
| Sintoma | Causa provável | Solução |
|---|---|---|
kubectl fica sem resposta e dá timeout | Porta 6443 fechada no grupo de segurança do cluster | Libere TCP 6443 para o seu IP — veja Grupos de segurança |
Unable to connect to the server | Caminho errado do kubeconfig | Confira o --kubeconfig ou a variável KUBECONFIG |
| Aviso de versão incompatível | kubectl mais de uma versão distante do cluster | Baixe o kubectl na versão do cluster |
Próximos passos
- Acessar o Dashboard do Kubernetes — ver e gerenciar o cluster pelo navegador.