Skip to main content

k3s | Kubernetes

  • k3s | Kubernetes

info

K3S é uma distribuição leve do Kubernetes, muito usada para ambientes de borda, testes locais e clusters pequenos.


🐳 Comandos Básicos do k3s

📦 Instalar o k3s (como servidor)

curl -sfL https://get.k3s.io | sh -

➕ Adicionar um worker ao cluster

curl -sfL https://get.k3s.io | K3S_URL=https://<SERVER_IP>:6443 K3S_TOKEN=<NODE_TOKEN> sh -

🧰 Gerenciamento do Serviço

▶️ Iniciar k3s manualmente

sudo systemctl start k3s

⏹️ Parar k3s

sudo systemctl stop k3s

🔄 Reiniciar k3s

sudo systemctl restart k3s

📊 Verificar status

sudo systemctl status k3s

📁 Arquivos e Paths Importantes

  • kubeconfig (para usar com kubectl):

    sudo cat /etc/rancher/k3s/k3s.yaml

    Você pode copiá-lo para ~/.kube/config e substituir o host de 127.0.0.1 pelo IP do servidor, se necessário.

  • Token do node (para adicionar workers):

    sudo cat /var/lib/rancher/k3s/server/node-token
  • Local onde fica salvo as .env

    cat /etc/systemd/system/k3s-agent.service.env

⚙️ Comandos do Binário k3s

📋 Ver status do cluster

k3s kubectl get nodes
k3s kubectl get pods -A

🐳 Aplicar um manifest

k3s kubectl apply -f meu-arquivo.yaml

❌ Remover um manifest

k3s kubectl delete -f meu-arquivo.yaml

🔄 Reset e Desinstalação

❌ Desinstalar completamente o k3s

/usr/local/bin/k3s-uninstall.sh

❌ Desinstalar um node (worker)

/usr/local/bin/k3s-agent-uninstall.sh

🚀 Exemplos de Uso Comum

Ver pods e serviços

k3s kubectl get pods -A
k3s kubectl get svc -A

Ver logs de um pod

k3s kubectl logs <nome-do-pod> -n <namespace>

Acessar shell de um pod

k3s kubectl exec -it <nome-do-pod> -n <namespace> -- /bin/sh