Iniciante
GitOps do zero: ArgoCD num cluster k3s
Suba um cluster k3s, instale o ArgoCD e faça o primeiro deploy sincronizado direto de um repositório Git.
- Kubernetes
- ArgoCD
- GitOps
- k3s
Antes de começar
Neste guia você sai de uma máquina Linux limpa até um deploy gerenciado por GitOps. É a mesma base que uso no meu homelab, só que reduzida ao essencial.
Você vai precisar de: uma VM ou máquina com Linux (2 vCPU, 4 GB de RAM), acesso sudo e um repositório Git público.
1. Instale o k3s
O k3s é uma distribuição Kubernetes leve, ótima para laboratório.
bashcurl -sfL https://get.k3s.io | sh - sudo k3s kubectl get nodesQuando o nó aparecer como
Ready, copie o kubeconfig para o seu usuário:bashmkdir -p ~/.kube sudo cp /etc/rancher/k3s/k3s.yaml ~/.kube/config sudo chown $USER ~/.kube/config2. Instale o ArgoCD
bashkubectl create namespace argocd kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml kubectl -n argocd rollout status deploy/argocd-server3. Acesse o painel
Pegue a senha inicial do usuário
admin:bashkubectl -n argocd get secret argocd-initial-admin-secret \ -o jsonpath="{.data.password}" | base64 -d; echoE abra o painel com um port-forward:
bashkubectl port-forward svc/argocd-server -n argocd 8080:443Acesse
https://localhost:8080.Troque a senha inicial assim que entrar e apague o secret
argocd-initial-admin-secret.4. Crie sua primeira Application
Salve como
app.yaml, apontando para o seu repositório:app.yamlapiVersion: argoproj.io/v1alpha1 kind: Application metadata: name: guestbook namespace: argocd spec: project: default source: repoURL: https://github.com/argoproj/argocd-example-apps.git targetRevision: HEAD path: guestbook destination: server: https://kubernetes.default.svc namespace: guestbook syncPolicy: automated: prune: true selfHeal: true syncOptions: - CreateNamespace=truebashkubectl apply -f app.yaml5. Veja o GitOps em ação
Com
selfHeal: true, o ArgoCD desfaz qualquer mudança manual. Teste:bashkubectl -n guestbook scale deploy guestbook-ui --replicas=3 kubectl -n guestbook get deploy guestbook-ui -wEm segundos o deployment volta para o número de réplicas definido no Git. A partir daqui, toda mudança no cluster passa por um commit.
Missão cumprida!
Gostou do guia? Entre na newsletter para receber os próximos.