Distribuire su Node.js | EmDash CMS Everything

EmDash funziona su qualsiasi piattaforma di hosting con Node.js 22 o superiore. Questa guida illustra la distribuzione presso provider comuni usando SQLite e storage locale o compatibile con S3.

Prerequisiti

Node.js v22.12.0 o superiore
Un provider di hosting Node.js o un VPS

Configurazione

Configura EmDash per la distribuzione su 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",
			}),
		}),
	],
});

Build ed esecuzione

Esegui la build del progetto:

npm run build

Inizializza il database:

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

Avvia il server:
```
node ./dist/server/entry.mjs
```

Il server è in ascolto su http://localhost:4321 per impostazione predefinita.

Storage in produzione

In produzione usa uno storage compatibile con S3 invece del file system locale:

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

Aggiungi un .dockerignore per mantenere il contesto di build ridotto:

node_modules
dist
.git

Crea un 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"]

Build ed esecuzione:

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

Oppure usa Docker Compose:

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

volumes:
  emdash-data:

docker compose up -d

Variabili d’ambiente

Obbligatorie in produzione

Variabile	Descrizione
`EMDASH_AUTH_SECRET`	Firma i cookie di sessione e i token di autenticazione. Genera con `npx emdash auth secret`.
`EMDASH_PREVIEW_SECRET`	Firma gli URL di anteprima per i contenuti bozza. Genera con `npx emdash auth secret`.

Database e storage

Variabile	Descrizione	Esempio
`EMDASH_SITE_URL`	Origine pubblica lato browser (fallback su SITE_URL)	`https://example.com`
`DATABASE_PATH`	Percorso del database SQLite	`/data/emdash.db`
`HOST`	Host del server	`0.0.0.0`
`PORT`	Porta del server	`4321`
`S3_ENDPOINT`	URL endpoint S3	`https://xxx.r2.cloudflarestorage.com`
`S3_BUCKET`	Nome bucket S3	`my-media-bucket`
`S3_ACCESS_KEY_ID`	Chiave di accesso S3	`AKIA...`
`S3_SECRET_ACCESS_KEY`	Chiave segreta S3	`...`
`S3_PUBLIC_URL`	URL pubblico dei media	`https://cdn.example.com`

Storage persistente

SQLite richiede disco persistente. Assicurati che la piattaforma offra:

Un volume montato o disco persistente
Permessi di scrittura sulla directory del database
Meccanismi di backup del file del database

Health check

Aggiungi un endpoint di health check per i load balancer:

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

Configura la piattaforma per verificare /health nelle probe di liveness.