Ce qu'il fait
Effectue un déploiement à blanc et inspecte ce qui serait réellement téléversé, afin de détecter une cible de build erronée, un bundle trop volumineux ou un binaire de dépendance qui serait intégré comme ressource statique — avant la mise en ligne.
Prérequis
wrangleretnodedisponibles dans lePATH- Un fichier
wrangler.toml(ouwrangler.jsonc) à la racine du projet - Des identifiants Cloudflare accessibles par
wrangler(via variables d'environnement, non commités)
Vérifier l'environnement
Exécuter avant toute chose :
command -v wrangler && command -v node
Si l'un des deux est manquant, arrêter et signaler : MISSING_DEP: wrangler.
Étapes à suivre
-
Vérifier que la configuration wrangler existe :
test -f wrangler.toml || test -f wrangler.jsoncSi aucun des deux n'existe, signaler
MISSING_CONFIG: wrangler.toml. -
Vérifier que
.wrangler/est dans le.gitignore(contient l'état local et peut contenir des tokens) :test -f .gitignore && grep -qxF '.wrangler/' .gitignore || echo "WARN: .wrangler/ pas dans .gitignore" -
Exécuter la pré-vérification (dry-run + inspection du téléversement) :
bash scripts/preflight.sh -
Exécuter la vérification des secrets :
bash scripts/check-secrets.sh -
Si les deux étapes réussissent, déployer :
wrangler deploy
Ne jamais supposer
- Ne jamais supposer que
wrangler deploycible Pages alors que vous vouliez Workers, ou l'inverse. Vérifier la cible danswrangler.tomlavant de déployer. - Ne jamais supposer que le répertoire de sortie du build est correct — wrangler le détecte automatiquement et peut se tromper. Vérifier le chemin de sortie du dry-run.
- Ne jamais supposer que
node_moduleset les binairesworkerdsont exclus du téléversement de ressources statiques. Inspecter le dry-run. - Ne jamais afficher un secret. Si une étape imprime
${{ secrets.* }}ou un token, le considérer comme une fuite : signalerCREDENTIAL_LEAKet stopper. - Ne jamais commiter
.wrangler/ou.dev.vars.
Résultat
Un rapport de taille du dry-run, une liste des binaires éventuellement divulgués, et un verdict succès/échec. Aucun déploiement n'est effectué si les deux vérifications ne réussissent pas.
Gestion des échecs
wranglermanquant → signalerMISSING_DEP: wrangler, stopper.- L'analyse préalable échoue → afficher textuellement la stderr de wrangler, ne pas réessayer aveuglément.
ASSET_LEAK→ stopper, corriger le build, relancer. Ne pas déployer.CREDENTIAL_LEAK→ faire tourner le credential, puis relancer.