🛡️ Plano de Deploy Seguro no GitHub Pages sem Exceder Limites de Actions

Data: 10 de Agosto de 2026
Autor: Sistema Automatizado / RicardoTecPro
Escopo: Hub Central (portal_mkdocs_hub) + 50 Repositórios de Módulos e Especializações (portal_mkdocs_repos)

📊 Diagnóstico do Consumo Atual

Com base no painel do GitHub Billing: - Minutos Consumidos: ~67,7 min / 3.000 min inclusos (~2.2% utilizado). - Armazenamento Actions: 0 GB / 2 GB inclusos. - Custo Atual: $0.00.

[!IMPORTANT] Regra de Faturamento do GitHub Actions: - Repositórios Públicos: Execuções em runners Linux (ubuntu-latest) são 100% GRATUITAS e ILIMITADAS (não consomem os 3.000 minutos da cota). - Repositórios Privados: Cada minuto de execução em runner Linux consome 1 min da cota mensal.

💡 Estratégia em 3 Pilares

1. Deploy Local via CLI (Método Principal — Consumo ZERO de Actions)

Em vez de disparar 50 compilações nos servidores do GitHub Actions: - O comando mkdocs gh-deploy --force gera o site estático HTML/CSS na máquina local e faz o push direto para a branch gh-pages do repositório no GitHub. - Consumo de minutos no GitHub Actions: 0 minutos (ZERO).

2. Otimização dos Workflows deploy.yml (Para CI/CD no GitHub)

Para qualquer repositório que execute workflows no GitHub Actions: - Path Filtering: O workflow só dispara se arquivos em docs/** ou mkdocs.yml forem alterados. - Cache de Dependências (cache: 'pip'): Tempo de instalação cai de ~45s para ~5s. - Cancelamento Concorrente (concurrency): Commits em sequência cancelam builds antigos pendentes. - Timeout de Segurança (timeout-minutes: 5): Cancela o job se demorar mais de 5 minutos.

3. Script de Automação de Deploy (scripts/deploy_todos_repos.py)

Permite executar o deploy de 1 repositório individual (para teste) ou de todos os 50 repositórios em lote.

🚀 Guia de Execução

Testar 1 Repositório Específico:

python scripts/deploy_todos_repos.py --repo ads_mod_01_fundamentos_da_computacao

Executar Deploy de Todos os 50 Repositórios:

python scripts/deploy_todos_repos.py --all