HomeLab — cmoreira.dev¶

Documentação da infraestrutura, plataforma e aplicações da organização cmoreira-dev: um homelab pessoal operado com as mesmas práticas de um ambiente de produção — IaC versionado, GitOps, cluster Kubernetes real e pipelines de CI/CD com identidade federada (sem credenciais estáticas).

Como a organização está dividida¶

O GitHub da org segue uma estrutura por categorias, uma pasta = um conjunto de repositórios relacionados:

Categoria	Conteúdo
`infra-as-code/`	Terraform/Terragrunt — provisionamento de infraestrutura viva (AWS, Proxmox)
`platform-engineering/`	Addons de cluster e GitOps (ArgoCD), portal interno (Backstage)
`teupadel.com/`	Aplicação de análise de movimento de padel com IA
`sara/`	Aplicação pessoal de prática de cifras/letras
`documentation/`	Este site

Ver Padrões de Repositório para a convenção de nomes (gitops.*, iac.*, api.*, ui.*, docs.*) e a estrutura interna esperada de cada tipo.

Arquitetura em uma imagem¶

flowchart TB
    subgraph internet["Internet"]
        user["Usuário"]
    end

    subgraph edge["Borda"]
        cf["Cloudflare Tunnel<br/>(cloudflared)"]
    end

    subgraph cluster["Cluster Kubernetes (Talos)"]
        gw["NGINX Gateway Fabric<br/>(Gateway API)"]
        argocd["ArgoCD"]
        apps["Workloads<br/>teupadel.com · Sara · addons"]
        gw --> apps
    end

    subgraph git["GitHub — org cmoreira-dev"]
        apprepos["Repos de app<br/>api.* / ui.*"]
        gitopsrepos["Repos gitops.*"]
    end

    subgraph aws["AWS"]
        ecr["ECR<br/>(imagens Docker)"]
        s3["S3 + DynamoDB<br/>(state Terragrunt)"]
        ssm["SSM Parameter Store<br/>(segredos)"]
    end

    user --> cf --> gw
    apprepos -- "CI: build + push (OIDC)" --> ecr
    ecr -. "pull de imagem" .-> apps
    gitopsrepos -- "auto-discovery" --> argocd
    argocd -- "sync" --> apps
    apps -. "ExternalSecret" .-> ssm

Cada camada dessa imagem tem uma página própria:

Cluster Kubernetes — Talos, bootstrap, addons de GPU
Rede & Ingress — Cloudflare Tunnel, Gateway API, roteamento
Secrets & Segurança — External Secrets, OIDC, sem credenciais estáticas
Terragrunt — infraestrutura AWS gerenciada como código
Padrão GitOps — como um git push vira workload rodando
Build & Registry — pipeline de imagens Docker

Aplicações rodando hoje¶

App	O que é	Stack	Repos
teupadel.com	Análise de movimento de padel com IA (upload de vídeo → feedback gerado por LLM)	Next.js SSR, FastAPI, pose estimation (ONNX), Claude	`ui.ia.teupadel.com`, `api.ia.teupadel.com`, `api.ia.pose-estimation`, `gitops.teupadel.com`
Sara	Player de cifras/letras com auto-scroll por BPM	Next.js, FastAPI (scraper)	`ui.ia.local-sara`, `api.ia.local-sara`, `gitops.local-sara`

Princípios que guiam esta infra¶

Tudo declarativo: infraestrutura em Terragrunt, workloads em Helm/Kustomize — sem kubectl apply ou terraform apply manual fora de bootstrap único.
GitOps de verdade: o ArgoCD é a única coisa que aplica manifests no cluster; um git push num repo gitops.* é o mecanismo de deploy inteiro.
Sem credenciais estáticas: CI usa OIDC (GitHub Actions → AWS IAM), workloads usam External Secrets (AWS SSM) — nenhum segredo de longa duração precisa ser copiado manualmente.
Convenção antes de configuração: o prefixo do nome do repo (gitops., api., ui., iac.) já diz o que ele faz e como é operado — ver Padrões de Repositório.