Pular para conteúdo

ADR-004 — Azure Static Web Apps para hospedagem da documentação

Status: ✅ Aceito Data: 2026-06-10

Contexto

O site de documentação gerado pelo MkDocs é um conjunto de arquivos HTML/CSS/JS estáticos que precisa ser hospedado e publicado automaticamente via CI/CD a cada push na branch master do repositório AMia-Roadmap.

As alternativas consideradas foram: 1. Azure Static Web Apps — hospedagem gerenciada para sites estáticos na Azure 2. Azure App Service — hospedagem de containers, mais complexo para sites estáticos 3. GitHub Pages — gratuito, mas o repositório está no Azure DevOps 4. Azure Blob Storage + CDN — possível, mas requer configuração manual de roteamento e HTTPS

Decisão

Adotar Azure Static Web Apps para hospedagem do site MkDocs gerado pelo repositório AMia-Roadmap.

Justificativa

  • Azure Static Web Apps é projetado especificamente para sites estáticos — sem overhead de container ou servidor web
  • Integração nativa com Azure DevOps Pipelines via task AzureStaticWebApp@0
  • HTTPS automático, CDN global e domínio customizável incluídos no serviço
  • Custo reduzido em comparação ao Azure App Service para conteúdo estático
  • Alinhado com a infraestrutura Azure já adotada no projeto (Key Vault, ACR, App Service para serviços dinâmicos)

Consequências

Positivas: - Deploy automático do site em < 5 minutos após push na master - Zero configuração de servidor web, certificados SSL ou CDN - Preview automático de Pull Requests (feature do Azure SWA)

Negativas: - Requer provisionamento manual do recurso Azure Static Web Apps antes do primeiro deploy - Token de deploy armazenado no Azure DevOps Variable Group (operação de infra fora do escopo do repositório) - Funcionalidades dinâmicas (backend serverless) requerem Azure Functions integradas ao SWA — não necessárias para documentação estática