infrastructure

Bootstrap declarativo e setup GitOps de um cluster k3s de node único. Os dados de conexão não ficam neste repositório; quem administra usa um alias próprio já configurado no ~/.ssh/config.

O Ansible instala o k3s, configura o firewalld, clona os segredos de bootstrap do infrastructure-vault, instala o release do Argo CD, e aplica um único arquivo, o root.yaml. O Argo CD sincroniza tudo que descobre a partir dali, em argocd/applications. Nenhum segredo, em texto puro ou cifrado, fica neste repositório: todos vivem em infrastructure-vault.

flowchart LR
    Ansible[Ansible] --> K3s[k3s] --> FW[firewalld] --> Vault[clona infrastructure-vault]
    Vault --> ArgoCD[instala Argo CD]
    ArgoCD -->|kubectl apply| Root[root.yaml]
    Root --> Apps[argocd/applications sincronizado continuamente]

Esta documentação está dividida em três trilhas, que se referenciam entre si mas podem ser lidas de forma independente. A divisão segue Diátaxis: cada trilha responde a um tipo diferente de necessidade, não ao mesmo assunto visto de ângulos diferentes.

flowchart TB
    Aprender["Aprender: explicação, sem instrução"] --> Arquitetura["Arquitetura: referência deste cluster"]
    Arquitetura --> Operacao["Operação: tutorial e how-to guide"]

Aprender (explicação)

SSH, Git, Ansible, k3s, firewalld, Argo CD: o que cada peça é e faz, de forma geral, sem depender deste cluster específico. Comece aqui se algum desses nomes não é familiar.

Arquitetura (referência)

Como este cluster específico usa cada peça: a estrutura do repositório, o que cada role do Ansible faz e por quê, onde os segredos vivem, o que já roda hoje em produção, e os diagramas de fluxo do sistema inteiro.

Operação (tutorial e how-to guide)

O roteiro executável: checklist, o passo a passo do bootstrap na VM, os scripts de manutenção, o que fica fora do git, e as convenções de desenvolvimento (lint, commits).