FAQ contexte des commandes de déploiement Emdash CMS

Publié le 2026-04-08 par Emdash Cms Everything

Où exactement lancer les commandes de déploiement ?

Règle par défaut : depuis la racine du projet site cible.
Dans le mauvais répertoire, scripts, configs et bindings pointent souvent vers le mauvais contexte.

Qu’est-ce que la « racine du projet cible » ?

Elle a en général tout ceci :

• un package.json spécifique au projet
• un astro.config.* spécifique au site
• un wrangler.jsonc (flux Cloudflare)

Si ces trois éléments sont présents, vous êtes probablement au bon endroit.

Différence entre monorepo, copie de template et projet autonome ?

Projet autonome

Chemin le plus direct : toutes les commandes dans un seul dossier.

Projet dérivé d’un template

Mettez d’abord à jour le name, les scripts et les bindings après copie du template ; puis lancez le déploiement.

Monorepo

Entrez dans le package d’application concerné avant de déployer. N’exécutez pas les commandes de déploiement depuis la racine du monorepo sauf si les scripts y délèguent explicitement.

Symptômes fréquents du mauvais répertoire ?

• script de déploiement introuvable (il est dans un sous-dossier)
• wrangler.jsonc absent ou mauvais fichier chargé
• incohérence des noms de binding (config d’un autre projet)
• build OK mais déploiement vers un mauvais nom de worker

Ce sont surtout des échecs de contexte, pas de syntaxe.

Prévol rapide en 20 secondes

Avant les commandes de déploiement :

1. Confirmez que pwd pointe vers le projet attendu.
2. Confirmez que le name dans package.json correspond au site cible.
3. Confirmez que les noms dans wrangler.jsonc (name, D1, R2) correspondent à l’environnement cible.

Cela fait gagner plus de temps que des réessais en boucle.

Puis-je mélanger les gestionnaires de paquets ?

Non recommandé.
Un seul gestionnaire par flux de déploiement pour éviter la dérive des lockfiles et les résolutions incohérentes.

Pratiques d’équipe contre les erreurs de contexte

Contrôles recommandés :

• documenter les répertoires exacts des commandes dans le README
• ajouter des prévols dans les scripts critiques
• ajouter des vérifications de cohérence de chemins en CI

La plupart des échecs de déploiement ne sont pas des problèmes profonds de plateforme, mais des hypothèses implicites sur le contexte des commandes.

Extrait de commandes utile

pwd
ls
npm run build
npm run deploy