Implantar no Node.js | EmDash CMS Everything

O EmDash funciona em qualquer plataforma de hospedagem com Node.js 22 ou superior. Este guia cobre a implantação em provedores comuns usando SQLite e armazenamento local ou compatível com S3.

Pré-requisitos

Node.js v22.12.0 ou superior
Um provedor de hospedagem Node.js ou VPS

Configuração

Configure o EmDash para implantação em Node.js:

import { defineConfig } from "astro/config";
import node from "@astrojs/node";
import emdash, { local, s3 } from "emdash/astro";
import { sqlite } from "emdash/db";

export default defineConfig({
	output: "server",
	adapter: node({ mode: "standalone" }),
	integrations: [
		emdash({
			database: sqlite({ url: "file:./data/emdash.db" }),
			storage: local({
				directory: "./data/uploads",
				baseUrl: "/_emdash/api/media/file",
			}),
		}),
	],
});

Compilar e executar

Compile o projeto:

npm run build

Inicialize o banco de dados:

npx emdash init --database ./data/emdash.db

Inicie o servidor:
```
node ./dist/server/entry.mjs
```

O servidor roda por padrão em http://localhost:4321.

Armazenamento em produção

Em produção, use armazenamento compatível com S3 em vez do sistema de arquivos local:

import emdash, { s3 } from "emdash/astro";

export default defineConfig({
	integrations: [
		emdash({
			database: sqlite({ url: `file:${process.env.DATABASE_PATH}` }),
			storage: s3({
				endpoint: process.env.S3_ENDPOINT,
				bucket: process.env.S3_BUCKET,
				accessKeyId: process.env.S3_ACCESS_KEY_ID,
				secretAccessKey: process.env.S3_SECRET_ACCESS_KEY,
				publicUrl: process.env.S3_PUBLIC_URL, // Optional CDN URL
			}),
		}),
	],
});

Docker

Adicione um .dockerignore para manter o contexto de build pequeno:

node_modules
dist
.git

Crie um Dockerfile:

FROM node:22-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

FROM node:22-alpine
WORKDIR /app
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app/package.json ./
COPY --from=builder /app/seed ./seed
COPY --from=builder /app/astro.config.mjs ./

RUN mkdir -p data

ENV HOST=0.0.0.0
ENV PORT=4321

EXPOSE 4321
CMD ["sh", "-c", "npx emdash init && node ./dist/server/entry.mjs"]

Compilar e executar:

docker build -t my-emdash-site .
docker run -p 4321:4321 -v emdash-data:/app/data my-emdash-site

Ou use o Docker Compose:

services:
  emdash:
    build: .
    ports:
      - "4321:4321"
    volumes:
      - emdash-data:/app/data
    restart: unless-stopped

volumes:
  emdash-data:

docker compose up -d

Variáveis de ambiente

Obrigatórias em produção

Variável	Descrição
`EMDASH_AUTH_SECRET`	Assina cookies de sessão e tokens de autenticação. Gere com `npx emdash auth secret`.
`EMDASH_PREVIEW_SECRET`	Assina URLs de pré-visualização de rascunhos. Gere com `npx emdash auth secret`.

Banco de dados e armazenamento

Variável	Descrição	Exemplo
`EMDASH_SITE_URL`	Origem pública voltada ao navegador (usa SITE_URL como fallback)	`https://example.com`
`DATABASE_PATH`	Caminho do banco SQLite	`/data/emdash.db`
`HOST`	Host do servidor	`0.0.0.0`
`PORT`	Porta do servidor	`4321`
`S3_ENDPOINT`	URL do endpoint S3	`https://xxx.r2.cloudflarestorage.com`
`S3_BUCKET`	Nome do bucket S3	`my-media-bucket`
`S3_ACCESS_KEY_ID`	Chave de acesso S3	`AKIA...`
`S3_SECRET_ACCESS_KEY`	Chave secreta S3	`...`
`S3_PUBLIC_URL`	URL pública da mídia	`https://cdn.example.com`

Armazenamento persistente

O SQLite exige disco persistente. Garanta que a plataforma ofereça:

Um volume montado ou disco persistente
Permissão de escrita no diretório do banco de dados
Mecanismos de backup do arquivo do banco

Verificações de saúde

Adicione um endpoint de health check para balanceadores de carga:

export const GET = () => {
  return new Response("OK", { status: 200 });
};

Configure a plataforma para verificar /health nas sondas de liveness.