infra

infra é um sistema de automação Terraform para criar e gerenciar múltiplos repositórios GitHub Pages com subdomínios personalizados.

Ele automatiza todo o processo de configuração de infraestrutura, desde a criação de repositórios até a configuração do Pages e geração de workflows de deploy.

Principais Recursos

1. Criação Automatizada de Repositórios: Cria repositórios GitHub com visibilidade especificada (público/privado) e convenções de nomenclatura.
2. Configuração GitHub Pages: Habilita automaticamente GitHub Pages via Terraform usando Personal Access Token com permissões de administrador.
3. Configuração de Domínio Personalizado: Gera arquivos CNAME para subdomínios personalizados (ex: register.arthurreira.dev, schedule.arthurreira.dev).
4. Workflows de Deploy: Gera automaticamente workflows GitHub Actions para cada repositório que constroem e fazem deploy de conteúdo estático para Pages.
5. Operações Idempotentes: Inclui importação automática de repositórios para evitar erros de recriação em re-execuções.

Arquitetura

O sistema consiste em dois componentes principais:

1. Infraestrutura Terraform (repositório infra):

   • Cria repositórios GitHub
   • Habilita GitHub Pages
   • Define domínios personalizados via arquivos CNAME
   • Gera workflows de deploy
   • Importa repositórios existentes para evitar recriação

2. Workflows de Deploy (repositórios de apps):

   • Disparo automático em push para branch main
   • Constrói conteúdo estático
   • Faz upload e deploy para Pages
   • Executa com permissões padrão do GitHub Actions

Stack Tecnológico

• Infraestrutura: Terraform >= 1.5
• Provider: integrations/github ~> 6.0
• Automação: GitHub Actions
• Deploy: GitHub Pages

Uso

O sistema pode ser executado localmente ou via GitHub Actions:

Local:

export TF_VAR_github_owner="arthurreira"
export TF_VAR_github_token="ghp_yourClassicPAT"
 
terraform -chdir=infra init
terraform -chdir=infra apply

GitHub Actions:

• Configure o segredo GH_PAT com Classic PAT (escopos repo + delete_repo)
• Execute o workflow na aba Actions
• Ative apply para executar mudanças

Resultado

Com DNS wildcard configurado (*.arthurreira.dev → GitHub Pages), o sistema provisiona automaticamente múltiplos sites de subdomínio:

• https://register.arthurreira.dev
• https://schedule.arthurreira.dev
• https://projects.arthurreira.dev

Cada site está totalmente configurado com Pages habilitado, domínio personalizado definido e workflows de deploy automáticos prontos para uso.