FAQ sul contesto dei comandi di deployment per Emdash CMS

Pubblicato il 2026-04-08 di Emdash Cms Everything

Dove esattamente eseguire i comandi di deployment?

Regola predefinita: dalla root del progetto sito di destinazione.
Se sei nella directory sbagliata, script, config e binding spesso risolvono nel contesto sbagliato.

Cosa conta come “root del progetto di destinazione”?

Di solito ha tutti questi elementi:

• package.json specifico del progetto
• astro.config.* specifico del sito
• wrangler.jsonc (per il flusso Cloudflare)

Se questi tre sono presenti, probabilmente sei nel contesto di deployment corretto.

Come differisce tra monorepo, copia da template e standalone?

Progetto standalone

Percorso più diretto: tutti i comandi in un’unica directory.

Progetto derivato da template

Prima aggiorna name, script e binding del progetto dopo la copia dal template; poi esegui i comandi di deployment.

Monorepo

Entra nel package dell’app specifica prima di fare deploy. Non eseguire i comandi di deploy dalla root del monorepo a meno che gli script non inoltrino esplicitamente a quel package.

Quali sono i sintomi più comuni della directory sbagliata?

• script di deployment non trovato (esiste in una sottocartella)
• wrangler.jsonc mancante o file sbagliato caricato
• mismatch dei nomi di binding (si usa la config di un altro progetto)
• build ok ma il deploy punta al nome worker sbagliato

La maggior parte sono fallimenti di contesto, non di sintassi dei comandi.

Preflight rapido da 20 secondi

Prima dei comandi di deploy:

1. Conferma che pwd punti al progetto atteso.
2. Conferma che il name in package.json corrisponda al sito di destinazione.
3. Conferma che i nomi in wrangler.jsonc (name, D1, R2) corrispondano all’ambiente di destinazione.

Risparmia più tempo dei tentativi ripetuti.

Posso mescolare i package manager?

Sconsigliato.
Usa un solo package manager per flusso di deployment per evitare deriva del lockfile e risoluzione incoerente delle dipendenze.

Pratiche di team per prevenire errori di contesto

Controlli consigliati:

• documentare le directory esatte dei comandi nel README
• aggiungere preflight negli script critici
• aggiungere controlli di coerenza dei percorsi in CI

La maggior parte dei fallimenti di deployment non sono problemi profondi della piattaforma, ma assunzioni implicite sul contesto dei comandi.

Snippet di comandi utile

pwd
ls
npm run build
npm run deploy