blog.dopana

戻る

WordPress的老い枯れたアーキテクチャに代わる、モダンなCMSソリューションがある。EmDashはAstro用に設計されたオープンソースのフルスタックCMSで、Cloudflare D1(SQLite互換サーバーレスDB)とR2(オブジェクトストレージ)を組み合わせる。この記事では、そのデータベースアーキテクチャを完全解説する。

1. アーキテクチャ概要#

EmDashのアーキテクチャは4つの柱で構成される:

Edge RuntimeFirst RequestAstro FrameworkEmDash CMS LayerCloudflare D1SQLite Serverless DBCloudflare R2Object Storageseed/seed.jsonSchema Source of Truthwrangler.jsoncBinding Config
コンポーネント役割
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で設定する:

Bindingの流れ#

"wrangler d1 create emdash-db"D1データベース作成database_id (UUID)wrangler.jsonc に UUID を記入wrangler dev 起動env.DB 経由でD1に接続開発者Wrangler CLICloudflareAstro/EmDash開発者Wrangler CLICloudflareAstro/EmDash

[!NOTE] binding名はコード内でenv.DB、env.MEDIAとして使われる。名前を変えた場合はコード側も変更が必要。

4. EmDashのDBアダプター#

EmDashはastro.config.mjsでDBアダプターを指定する:

astro.config.mjs
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の構造#

適用ルール#

操作振る舞い
コレクション・設定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.json
bash

[!TIP] seed.jsonは「最初のリクエスト時」にデータベースが空の場合に自動適用される。開発中は明示的にCLIで適用するのが確実。

6. ローカル開発:Miniflare + SQLite#

ローカル開発ではMiniflare(Cloudflareのローカルシミュレーター)が使われる。

ストレージパス#

.wrangler/state/v3/d1/miniflare-D1DatabaseObject/<hash>.sqlite
text
項目説明
<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. 全体のデータフロー#

ページリクエストgetEmDashCollection()SQLクエリ(env.DB)コンテンツデータレンダリングデータHTML応答画像リクエストenv.MEDIA経由画像配信ユーザーAstroEmDash RuntimeCloudflare D1Cloudflare R2ユーザーAstroEmDash RuntimeCloudflare D1Cloudflare R2

8. まとめ#

コンポーネント役割ファイル
D1コンテンツDBwrangler.jsonc(Binding設定)
R2メディアストレージwrangler.jsonc(Binding設定)
EmDashCMSレイヤーastro.config.mjs(d1()アダプター)
seed.jsonスキーマの信頼できるソースseed/seed.json
MiniflareローカルDB.wrangler/state/v3/d1/miniflare-D1DatabaseObject/*.sqlite

EmDash + D1 + R2の組み合わせにより、サーバーレスでスケーラブルなCMSアーキテクチャを構築できる。WordPressのサーバー管理から解放され、エッジで高速に配信される。

参考文献#