Fichier wrangler manquant
Symptôme : Wrangler demande le nom du projet à chaque déploiement ou ne sait pas quel projet utiliser.
Contexte
Section titled “Contexte”Lors du déploiement avec wrangler pages deploy, si aucun fichier de configuration n’existe (wrangler.toml ou wrangler.jsonc), Wrangler :
- Demande interactivement quel projet utiliser
- Ou utilise le dernier projet déployé (comportement non fiable)
Cela pose problème en CI/CD où il n’y a pas d’interaction possible.
Diagnostic
Section titled “Diagnostic”Vérifier si le fichier existe
Section titled “Vérifier si le fichier existe”ls -la wrangler.*Vérifier le git status
Section titled “Vérifier le git status”git statusSi vous voyez D wrangler.jsonc ou D wrangler.toml, le fichier a été supprimé localement.
Solutions
Section titled “Solutions”Solution 1 : Télécharger la config depuis Cloudflare
Section titled “Solution 1 : Télécharger la config depuis Cloudflare”Si le projet existe déjà sur Cloudflare :
bun wrangler pages download config <nom-du-projet>Exemple :
bun wrangler pages download config mindlet-docCela crée un fichier wrangler.toml avec la configuration du projet.
Solution 2 : Créer manuellement le fichier
Section titled “Solution 2 : Créer manuellement le fichier”Pour Cloudflare Pages (wrangler.toml) :
name = "mindlet-doc"compatibility_date = "2026-01-17"compatibility_flags = ["nodejs_compat"]pages_build_output_dir = "./dist"
[observability]enabled = true
[env.production]Pour Cloudflare Workers (wrangler.toml) :
name = "mindlet-api"main = "src/index.ts"compatibility_date = "2026-01-17"compatibility_flags = ["nodejs_compat"]
[observability]enabled = trueSolution 3 : Spécifier le projet en ligne de commande
Section titled “Solution 3 : Spécifier le projet en ligne de commande”Si vous ne voulez pas de fichier de config (non recommandé pour CI) :
# Pour Pagesbun wrangler pages deploy dist --project-name=mindlet-doc
# Pour Workers (nécessite quand même un wrangler.toml minimal)bun wrangler deploySolution 4 : Restaurer depuis git
Section titled “Solution 4 : Restaurer depuis git”Si le fichier a été supprimé par erreur :
git checkout HEAD -- wrangler.toml# ougit checkout HEAD -- wrangler.jsoncVérification
Section titled “Vérification”Après avoir créé/restauré le fichier :
# Vérifier que wrangler le lit correctementbun wrangler pages project list
# Tester un dry-runbun wrangler pages deploy dist --dry-runBonnes pratiques
Section titled “Bonnes pratiques”- Toujours committer le fichier wrangler dans le repo
- Utiliser
wrangler.tomlplutôt que.jsonc(plus lisible) - Spécifier
--project-namedans les scripts CI pour être explicite - Ne pas stocker de secrets dans wrangler.toml (utiliser
wrangler secret)