O que faz
Executa uma implantação simulada e inspeciona o que seria realmente enviado, permitindo detectar um build mal direcionado, um bundle muito grande ou um binário de dependência sendo enviado como ativo estático — antes de ir ao ar.
Pré-requisitos
wranglerenodenoPATH- Um
wrangler.toml(ouwrangler.jsonc) na raiz do projeto - Credenciais do Cloudflare disponíveis para
wrangler(via env, não commitadas)
Verificar ambiente
Execute antes de qualquer outra coisa:
command -v wrangler && command -v node
Se algum faltar, pare e relate: MISSING_DEP: wrangler.
Passo a passo
-
Confirme que a configuração wrangler existe:
test -f wrangler.toml || test -f wrangler.jsoncSe nenhum existir, relate
MISSING_CONFIG: wrangler.toml. -
Confirme que
.wrangler/está no.gitignore(ele armazena estado local e pode conter tokens):test -f .gitignore && grep -qxF '.wrangler/' .gitignore || echo "WARN: .wrangler/ not gitignored" -
Execute a verificação preliminar (dry-run + inspeção de upload):
bash scripts/preflight.sh -
Execute a verificação de segredos:
bash scripts/check-secrets.sh -
Somente se ambos passarem, implante:
wrangler deploy
Nunca assumir
- Nunca assuma que
wrangler deploytem como alvo Pages quando você queria Workers, ou vice-versa. Confirme o alvo emwrangler.tomlantes de implantar. - Nunca assuma que o diretório de saída da build está correto — o wrangler descobre automaticamente e pode escolher o errado. Verifique o caminho de saída da simulação.
- Nunca assuma que
node_modulese bináriosworkerdestão excluídos do upload de ativos estáticos. Inspecione a simulação. - Nunca exiba um segredo. Se alguma etapa imprimir
${{ secrets.* }}ou um token, trate como um vazamento: relateCREDENTIAL_LEAKe interrompa. - Nunca commite
.wrangler/ou.dev.vars.
Saída
Um relatório de tamanho da simulação, uma lista de quaisquer binários vazados e um veredito de aprovação/reprovação. Nenhuma implantação acontece a menos que ambas as verificações passem.
Tratamento de falhas
wranglerausente → relateMISSING_DEP: wrangler, interrompa.- Falha na simulação → exiba o stderr do wrangler literalmente, não tente novamente cegamente.
ASSET_LEAK→ pare, corrija a build, execute novamente. Não implante.CREDENTIAL_LEAK→ rotacione a credencial, depois execute novamente.