Pular para o conteúdo
Guias passo a passo

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. 1. Instale o k3s

    O k3s é uma distribuição Kubernetes leve, ótima para laboratório.

    bash
    curl -sfL https://get.k3s.io | sh -
    sudo k3s kubectl get nodes
    

    Quando o nó aparecer como Ready, copie o kubeconfig para o seu usuário:

    bash
    mkdir -p ~/.kube
    sudo cp /etc/rancher/k3s/k3s.yaml ~/.kube/config
    sudo chown $USER ~/.kube/config
    
  2. 2. Instale o ArgoCD

    bash
    kubectl 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-server
    
  3. 3. Acesse o painel

    Pegue a senha inicial do usuário admin:

    bash
    kubectl -n argocd get secret argocd-initial-admin-secret \
      -o jsonpath="{.data.password}" | base64 -d; echo
    

    E abra o painel com um port-forward:

    bash
    kubectl port-forward svc/argocd-server -n argocd 8080:443
    

    Acesse https://localhost:8080.

    Troque a senha inicial assim que entrar e apague o secret argocd-initial-admin-secret.

  4. 4. Crie sua primeira Application

    Salve como app.yaml, apontando para o seu repositório:

    app.yaml
    apiVersion: 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=true
    
    bash
    kubectl apply -f app.yaml
    
  5. 5. Veja o GitOps em ação

    Com selfHeal: true, o ArgoCD desfaz qualquer mudança manual. Teste:

    bash
    kubectl -n guestbook scale deploy guestbook-ui --replicas=3
    kubectl -n guestbook get deploy guestbook-ui -w
    

    Em 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.