Pular para o conteúdo principal

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.

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

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
Não quer repetir o --kubeconfig?

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​

SintomaCausa provávelSolução
kubectl fica sem resposta e dá timeoutPorta 6443 fechada no grupo de segurança do clusterLibere TCP 6443 para o seu IP — veja Grupos de segurança
Unable to connect to the serverCaminho errado do kubeconfigConfira o --kubeconfig ou a variável KUBECONFIG
Aviso de versão incompatívelkubectl mais de uma versão distante do clusterBaixe o kubectl na versão do cluster

Próximos passos​