O Kubernetes não apenas transformou a maneira como os contêineres são gerenciados, mas também forneceu uma ferramenta poderosa para os desenvolvedores: o kubectl. Esta ferramenta de linha de comando permite interações diretas com clusters Kubernetes, tornando-se a espinha dorsal para muitos engenheiros DevOps. Vamos decifrar os 20 comandos essenciais do kubectl para maximizar sua eficiência no mundo Kubernetes.
Pré-requisitos:
- Cluster Kubernetes: Se você ainda não tem um, configure-o. Para iniciantes, Minikube ou Docker Desktop são opções sólidas para testes locais.
- Instalação do kubectl: Garanta que o kubectl esteja instalado para que possa começar a interagir com seu cluster. A documentação oficial do Kubernetes fornece um guia completo de instalação.
Os Comandos Essenciais:
- kubectl version: Garanta que tudo esteja atualizado e conectando corretamente.
kubectl version
- kubectl cluster-info: Um resumo das informações do cluster em suas mãos.
kubectl cluster-info
- kubectl get nodes: Saiba quem está na sua equipe – os nós de trabalho.
kubectl get nodes
- kubectl get pods: Uma visão geral dos pods no namespace.
kubectl get pods
- kubectl describe pods: Profunde-se nos detalhes de um pod.
kubectl describe pod <nome_do_pod>
- kubectl logs: Diagnósticos rápidos? Verifique os logs.
kubectl logs <nome_do_pod> <nome_do_contêiner>
- kubectl exec: Precisa mexer dentro de um contêiner? Faça-o com segurança.
kubectl exec -it <nome_do_pod> -c <nome_do_contêiner> -- /bin/sh
- kubectl apply: Implemente mudanças via arquivos de configuração.
kubectl apply -f <caminho_do_arquivo>
- kubectl delete: Limpe recursos indesejados.
kubectl delete pod <nome_do_pod>
- kubectl scale: Ajuste o número de réplicas conforme a demanda.
kubectl scale deployment <nome_do_deployment> --replicas=3 - kubectl get deployments: Monitore os deployments ativos.
kubectl get deployments - kubectl get services: Fique por dentro dos serviços em ação.
kubectl get services - kubectl expose: Traga visibilidade ao seu Deployment.
kubectl expose deployment <nome_do_deployment> --type=NodePort --port=<numero_da_porta> - kubectl get namespaces: Explore diferentes namespaces.
kubectl get namespaces - kubectl create namespace: Organize seus recursos criando namespaces.
kubectl create namespace <nome_do_namespace> - kubectl config get-contexts: Mantenha-se ciente dos contextos em seu arsenal.
kubectl config get-contexts - kubectl config use-context: Alterne entre contextos conforme a necessidade.
kubectl config use-context <nome_do_contexto> - kubectl rollout: Gerencie deployments com eficiência.
kubectl rollout status deployment/<nome_do_deployment> - kubectl apply -f -: Seja ágil ao aplicar configurações.
cat <<EOF | kubectl apply -f - apiVersion: v1 kind: Pod metadata: name: my-pod spec: containers: - name: my-container image: nginx EOF - kubectl taint: Gerencie a distribuição de pods de acordo com as características dos nós.
bash kubectl taint nodes <nome_do_nó> key=value:efeito_da_marcação
O domínio desses comandos kubectl ampliará sua competência e eficiência no gerenciamento do Kubernetes. Equipado com essa habilidade, você estará pronto para enfrentar os desafios e aproveitar ao máximo as oportunidades que o Kubernetes oferece. Então, comece a praticar e aprimore sua jornada DevOps no universo Kubernetes!
21 a 25: Comandos Avançados para Troubleshooting Rápido (Debug e JSONPath)
Além dos comandos básicos de listagem e aplicação de manifests, situações de incidente em produção exigem filtros precisos por status, logs de contêineres anteriores que sofreram CrashLoopBackOff e inspeção com containers efêmeros:
# 1. Ver logs do container ANTERIOR antes de reiniciar em CrashLoopBackOff
kubectl logs -p pod/api-xyz -n producao
# 2. Listar eventos ordenados por horário para achar o motivo exato de falhas
kubectl get events -n producao --sort-by='.lastTimestamp'
# 3. Criar container efêmero de debug dentro de um pod minimalista/distroless sem shell
kubectl debug -it pod/api-xyz -n producao --image=nicolaka/netshoot --target=api
# 4. Mostrar imagens rodando e seus respectivos nós em formato tabular enxuto
kubectl get pods -A -o custom-columns="NS:.metadata.namespace,POD:.metadata.name,NODE:.spec.nodeName,IMAGE:.spec.containers[*].image"
# 5. Validar manifest sem aplicar mudanças no cluster (server-side dry-run)
kubectl apply -f deploy.yaml --dry-run=server
Mapa de Diagnóstico por Sintoma no Cluster
| Status do Pod | Causa Mais Comum | Comando Imediato |
|---|---|---|
Pending | Falta de CPU/RAM nos nós, taint sem toleration ou PVC preso | kubectl describe pod <nome> |
ImagePullBackOff | Tag inexistente, registry offline ou imagePullSecret ausente | kubectl describe pod <nome> |
CrashLoopBackOff | Erro na aplicação, variável de ambiente faltando ou OOMKilled | kubectl logs -p <pod> e checar Exit Code 137 |
| Service sem resposta | Label selector do Service não bate com o label do Pod ou ReadinessProbe falhando | kubectl get endpoints <svc> |
Dica prática para evitar acidentes em múltiplos clusters: sempre confirme o contexto e o namespace padrão antes de rodar qualquer comando destrutivo com kubectl config current-context e utilize ferramentas como kubectx/kubens. Para automação de deploy de pacotes completos, veja também nosso guia de Helm no Kubernetes.

