E EmDash CMS Everything Guides, use cases, plugins, templates
Português

FAQ de contexto de comandos de deploy do Emdash CMS

Onde executar comandos de deploy do Emdash CMS em layouts monorepo, derivados de template e standalone.

Abrir no Claude Abrir no ChatGPT
Partilhar no X Partilhar no LinkedIn Partilhar no Reddit

Publicado em 2026-04-08 por Emdash Cms Everything

Onde exatamente executar comandos de deploy?

Regra padrão: na raiz do projeto do site alvo.
No diretório errado, scripts, configs e bindings costumam resolver no contexto errado.

O que conta como “raiz do projeto alvo”?

Normalmente tem tudo isto:

  • package.json específico do projeto
  • astro.config.* específico do site
  • wrangler.jsonc (fluxo Cloudflare)

Se esses três existem, provavelmente está no contexto correto.

Como difere em monorepo, cópia de template e standalone?

Projeto standalone

Caminho mais direto: todos os comandos em um diretório.

Projeto derivado de template

Após copiar o template, atualize name, scripts e bindings do projeto; então execute o deploy.

Monorepo

Entre no pacote do app específico antes de implantar. Não execute comandos de deploy do app a partir da raiz do monorepo, salvo se os scripts encaminharem explicitamente para esse pacote.

Sintomas mais comuns de diretório errado?

  • script de deploy não encontrado (está em subdiretório)
  • wrangler.jsonc ausente ou arquivo errado carregado
  • incompatibilidade de nomes de binding (config de outro projeto)
  • build ok mas deploy aponta para nome de worker errado

Na maioria são falhas de contexto, não de sintaxe.

Preflight rápido de 20 segundos

Antes dos comandos de deploy:

  1. Confirme que pwd aponta para o projeto esperado.
  2. Confirme que o name em package.json corresponde ao site alvo.
  3. Confirme que os nomes em wrangler.jsonc (name, D1, R2) batem com o ambiente alvo.

Isso economiza mais tempo que repetir tentativas.

Posso misturar gerenciadores de pacotes?

Não recomendado.
Use um gerenciador por fluxo de deploy para evitar drift de lockfile e resolução inconsistente de dependências.

Práticas de equipe para evitar erros de contexto

Controles recomendados:

  • documentar diretórios exatos dos comandos no README
  • adicionar preflights em scripts críticos
  • adicionar verificações de consistência de caminho em CI

A maioria das falhas de deploy não são problemas profundos da plataforma, mas suposições implícitas sobre o contexto dos comandos.

Trecho de comandos útil

pwd
ls
npm run build
npm run deploy