Deploy
Visão Geral
Seção intitulada “Visão Geral”O deploy do Aura é atômico e reversível — cada deploy cria uma nova versão do Worker, com rollback instantâneo via Cloudflare Dashboard.
| Propriedade | Valor |
|---|---|
| Plataforma | Cloudflare Workers |
| CLI | Wrangler |
| Trigger | Manual (via CLI) |
| Rollback | < 30 segundos via Dashboard |
| Downtime | Zero (atomic swap) |
Processo
Seção intitulada “Processo”1. Build
Seção intitulada “1. Build”# Instalar dependênciasnpm install
# Build do Worker (TypeScript → JS)npm run build2. Deploy
Seção intitulada “2. Deploy”# Deploy para produçãonpm run deploy# ounpx wrangler deployO Wrangler faz:
- Compila
src/worker.ts→ bundle JS - Upload dos static assets (
app/,public/) - Atomic swap do Worker em produção
- Versão anterior mantida para rollback
3. Rollback
Seção intitulada “3. Rollback”Se necessário reverter:
- Acesse Cloudflare Dashboard → Workers →
profarma-apps - Aba Deployments → selecione versão anterior
- Click Rollback to this deployment
- Worker reverte em < 30 segundos
Migrações D1
Seção intitulada “Migrações D1”Migrações do banco de dados são aplicadas separadamente:
# Listar migrações pendentesnpx wrangler d1 migrations list profarma-apps
# Aplicar migraçõesnpx wrangler d1 migrations apply profarma-appsMigrações estão em
migrations/— numeradas sequencialmente (0001_init.sql,0002_seed.sql, etc.)
Secrets
Seção intitulada “Secrets”Secrets são gerenciados via Wrangler CLI e nunca entram no código:
# Definir um secretnpx wrangler secret put AUTH_SECRET
# Listar secrets configuradosnpx wrangler secret listAmbientes
Seção intitulada “Ambientes”| Ambiente | URL | Notas |
|---|---|---|
| Produção | app.profarma.dev | Único ambiente |
| (sem staging) | — | Workers isola por design — cada deploy é atômico |
O modelo Cloudflare Workers não requer staging — deploys são instantâneos e reversíveis. Em caso de problema, rollback em < 30s.
Checklist de Deploy
Seção intitulada “Checklist de Deploy”-
npm run buildsem erros - Migrações D1 aplicadas (se houver novas)
- Secrets configurados (se houver novos)
-
npm run deployexecutado com sucesso - Verificação visual em
app.profarma.dev -
/auth/merespondendo corretamente - Turnstile funcionando (teste manual)