EmDash + Cloudflare D1:サーバーレスデータベースアーキテクチャ
EmDash CMS、Cloudflare D1、R2を組み合わせたフルスタックアーキテクチャ。Binding設定、seed.json、ローカル開発まで解説。
WordPress的老い枯れたアーキテクチャに代わる、モダンなCMSソリューションがある。EmDashはAstro用に設計されたオープンソースのフルスタックCMSで、Cloudflare D1(SQLite互換サーバーレスDB)とR2(オブジェクトストレージ)を組み合わせる。この記事では、そのデータベースアーキテクチャを完全解説する。
1. アーキテクチャ概要#
EmDashのアーキテクチャは4つの柱で構成される:
| コンポーネント | 役割 |
|---|---|
| Astro | フレームワーク、SSR/SSG、Live Collections |
| EmDash CMS | 管理画面、コンテンツモデル、REST API、プラグイン |
| Cloudflare D1 | コンテンツ、設定、タクソノミー、ユーザー、メディアメタデータのSQL DB |
| Cloudflare R2 | 画像やアップロードなどのメディアファイルストレージ |
2. Cloudflare D1:SQLiteサーバーレスデータベース#
D1はCloudflareのマネージドサーバーレスデータベース。SQLiteのSQLセマンティクスに、災害復旧、Worker/HTTP APIアクセスを内蔵している。
主な仕様#
| 項目 | 内容 |
|---|---|
| エンジン | SQLite |
| 無料枠 | 5M rows read/日、100K rows written/日、最大5GB |
| 有料プラン | 1DB最大10GB、アカウント最大50,000DB(合計1TB) |
| Time Travel | 過去30日以内の任意の minute にポイントインタイムリカバリー |
| グローバル読み取りレプリカ | ベータ版:リージョン間读み取りレプリカ |
D1が選ばれる理由#
- SQLite互換:既存のSQLite知識がそのまま活用可能
- サーバーレス:アイドル課金なし、クエリとストレージのみ課金
- エッジ配信:Cloudflareのグローバルネットワークで低レイテンシ
- EmDash公式サポート:
emdash/dbでd1()アダプターを提供
3. Binding設定:wrangler.jsonc#
D1とR2のBindingはwrangler.jsoncで設定する:
{
"name": "my-worker",
"compatibility_date": "2026-06-28",
// D1 Database Binding
"d1_databases": [
{
"binding": "DB", // env.DB としてコードからアクセス
"database_name": "emdash-db", // 人間が読める名前
"database_id": "xxxxxxxx-xxxx-xxxx-xxxx" // `wrangler d1 create` で取得したUUID
}
],
// R2 Bucket Binding
"r2_buckets": [
{
"binding": "MEDIA", // env.MEDIA としてコードからアクセス
"bucket_name": "emdash-media"
}
]
}jsoncBindingの流れ#
[!NOTE]
binding名はコード内でenv.DB、env.MEDIAとして使われる。名前を変えた場合はコード側も変更が必要。
4. EmDashのDBアダプター#
EmDashはastro.config.mjsでDBアダプターを指定する:
import emdash from "emdash/astro";
import { d1 } from "emdash/db";
export default defineConfig({
integrations: [
emdash({
database: d1(), // Cloudflare D1アダプター
}),
],
});js利用可能なアダプター:
| アダプター | 用途 |
|---|---|
d1() | Cloudflare D1(サーバーレス) |
sqlite() | ローカルSQLite(開発用) |
libsql() | LibSQL/Turso |
postgresql() | PostgreSQL |
5. seed.json:スキーマの信頼できるソース#
seed/seed.jsonはEmDashサイトのブートストラップドキュメント。コレクション、フィールド、タクソノミー、メニュー、リダイレクト、ウィジェットエリア、サイト設定を定義する。
seed.jsonの構造#
{
"$schema": "https://emdashcms.com/seed.schema.json",
"version": "1",
"meta": {
"name": "My Blog",
"description": "A blog powered by EmDash + D1"
},
"settings": {
"title": "My Blog",
"postsPerPage": 10
},
"collections": [
{
"name": "posts",
"fields": [
{ "name": "title", "type": "string" },
{ "name": "body", "type": "portabletext" }
]
}
],
"taxonomies": [],
"menus": [],
"redirects": [],
"widgetAreas": [],
"content": {}
}json適用ルール#
| 操作 | 振る舞い |
|---|---|
| コレクション・設定 | upsert — 存在すれば更新、なければ作成 |
| メニュー・ウィジェット | replace — seedの内容で完全上書き |
| コンテンツエントリ | skip — slugが存在する場合はスキップ |
適用方法#
# CLIで適用
npx emdash seed seed/seed.json
# 既存のスキーマをエクスポート
npx emdash export-seed > .emdash/seed.json
# コンテンツ込みでエクスポート
npx emdash export-seed --with-content > .emdash/seed.jsonbash[!TIP] seed.jsonは「最初のリクエスト時」にデータベースが空の場合に自動適用される。開発中は明示的にCLIで適用するのが確実。
6. ローカル開発:Miniflare + SQLite#
ローカル開発ではMiniflare(Cloudflareのローカルシミュレーター)が使われる。
ストレージパス#
.wrangler/state/v3/d1/miniflare-D1DatabaseObject/<hash>.sqlitetext| 項目 | 説明 |
|---|---|
<hash> | database_idから派生した16進ハッシュ |
| ファイル形式 | SQLite互換(better-sqlite3で直接接続可能) |
| 持続性 | wrangler devセッション間でデータが保持される |
| ローカル/リモート | --local / --remoteフラグで完全分離 |
ローカル開発のフロー#
# ローカルでD1にシードを適用
npx emdash seed seed/seed.json --local
# 開発サーバー起動
wrangler dev
# ローカルDBを確認
ls .wrangler/state/v3/d1/miniflare-D1DatabaseObject/bash[!NOTE] ローカルDBとリモートDBは完全に分離されている。
--localと--remoteで使い分ける。
7. 全体のデータフロー#
8. まとめ#
| コンポーネント | 役割 | ファイル |
|---|---|---|
| D1 | コンテンツDB | wrangler.jsonc(Binding設定) |
| R2 | メディアストレージ | wrangler.jsonc(Binding設定) |
| EmDash | CMSレイヤー | astro.config.mjs(d1()アダプター) |
| seed.json | スキーマの信頼できるソース | seed/seed.json |
| Miniflare | ローカルDB | .wrangler/state/v3/d1/miniflare-D1DatabaseObject/*.sqlite |
EmDash + D1 + R2の組み合わせにより、サーバーレスでスケーラブルなCMSアーキテクチャを構築できる。WordPressのサーバー管理から解放され、エッジで高速に配信される。