Node.jsへのデプロイ

EmDashはNode.js 22+をサポートする任意のホスティングプラットフォームで動作します。このガイドでは、SQLiteとローカルまたはS3互換ストレージを使用した一般的なプロバイダーへのデプロイについて説明します。

前提条件

• Node.js v22.12.0 以上
• Node.jsホスティングプロバイダーまたはVPS

設定

Node.jsデプロイメント用にEmDashを設定します：

astro.config.mjs

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",
      }),
    }),
  ],
});

ビルドと実行

1. プロジェクトをビルドします：

npm run build

2. データベースを初期化します：

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

3. サーバーを起動します：

   node ./dist/server/entry.mjs

サーバーはデフォルトで http://localhost:4321 で実行されます。

本番環境ストレージ

本番環境では、ローカルファイルシステムの代わりにS3互換ストレージを使用します：

js title="astro.config.mjs"
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
      }),
    }),
  ],
});

ノート

S3互換ストレージは、Cloudflare R2（S3 API経由）、MinIO、およびその他のS3互換サービスで動作します。

Docker

Dockerfileを作成します：

dockerfile title="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 ./

ENV HOST=0.0.0.0
ENV PORT=4321

EXPOSE 4321
CMD ["node", "./dist/server/entry.mjs"]

ビルドして実行します：

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

環境変数

本番環境に必須

変数	説明
EMDASH_AUTH_SECRET	セッションクッキーと認証トークンに署名します。npx emdash auth secretで生成します。
EMDASH_PREVIEW_SECRET	下書きコンテンツのプレビューURLに署名します。npx emdash auth secretで生成します。

データベースとストレージ

変数	説明	例
DATABASE_PATH	SQLiteデータベースへのパス	/data/emdash.db
HOST	サーバーホスト	0.0.0.0
PORT	サーバーポート	4321
S3_ENDPOINT	S3エンドポイントURL	https://xxx.r2.cloudflarestorage.com
S3_BUCKET	S3バケット名	my-media-bucket
S3_ACCESS_KEY_ID	S3アクセスキー	AKIA...
S3_SECRET_ACCESS_KEY	S3シークレットキー	...
S3_PUBLIC_URL	メディア用の公開URL	https://cdn.example.com

注意

シークレットをリポジトリにコミットしないでください。本番環境では、プラットフォームのシークレット管理（環境変数、シークレットストアなど）を使用してください。

永続ストレージ

SQLiteには永続的なディスクストレージが必要です。ホスティングプラットフォームが以下を提供していることを確認してください：

• マウントされたボリュームまたは永続ディスク
• データベースディレクトリへの書き込みアクセス
• データベースファイルのバックアップメカニズム

注意

一時的なファイルシステムでは、再起動時にデータベースが失われます。リモートデータベースまたは永続ストレージを備えたlibSQLを使用してください。

ヘルスチェック

ロードバランサー用のヘルスチェックエンドポイントを追加します：

astro title="src/pages/health.ts"
export const GET = () => {
  return new Response("OK", { status: 200 });
};

プラットフォームを設定して、生存確認プローブのために /health をチェックします。