blog.dopana

Quay lại

WordPress đã lỗi thời, có giải pháp CMS hiện đại hơn. EmDash là CMS full-stack mã nguồn mở được thiết kế cho Astro, kết hợp Cloudflare D1 (SQLite serverless DB) và R2 (object storage). Bài viết này giải thích kiến trúc database hoàn chỉnh.

1. Tổng Quan Kiến Trúc#

Kiến trúc EmDash gồm 4 trụ cột chính:

Edge RuntimeFirst RequestAstro FrameworkEmDash CMS LayerCloudflare D1SQLite Serverless DBCloudflare R2Object Storageseed/seed.jsonSchema Source of Truthwrangler.jsoncBinding Config
Thành PhầnVai Trò
AstroFramework, SSR/SSG, Live Collections
EmDash CMSAdmin UI, content model, REST API, plugin
Cloudflare D1SQL DB cho content, settings, taxonomy, user, media metadata
Cloudflare R2Lưu trữ media files (hình ảnh, uploads)

2. Cloudflare D1: SQLite Serverless Database#

D1 là managed serverless database của Cloudflare. Semantic SQL của SQLite kết hợp disaster recovery, Worker/HTTP API tích hợp sẵn.

Thông Số Chính#

MụcChi Tiết
EngineSQLite
Free Tier5M rows read/ngày, 100K rows written/ngày, tối đa 5GB
Paid Plan1DB tối đa 10GB, account tối đa 50,000DB (tổng 1TB)
Time TravelPoint-in-time recovery trong 30 ngày gần nhất
Global Read ReplicaBeta: read replica cross-region

Tại Sao Chọn D1?#

  • SQLite compatible : Kiến thức SQLite hiện có dùng được ngay
  • Serverless : Không tính idle, chỉ tính query và storage
  • Edge delivery : Mạng lưới toàn cầu Cloudflare, latency thấp
  • EmDash support chính thức : emdash/db cung cấp d1() adapter

3. Binding Configuration: wrangler.jsonc#

Binding D1 và R2 cấu hình trong wrangler.jsonc:

Luồng Binding#

"wrangler d1 create emdash-db""Tạo D1 database"database_id (UUID)Ghi UUID vào wrangler.jsoncwrangler dev startKết nối D1 qua env.DBDeveloperWrangler CLICloudflareAstro/EmDashDeveloperWrangler CLICloudflareAstro/EmDash

[!NOTE] Tên binding dùng trong code là env.DB, env.MEDIA. Đổi tên thì code cũng phải đổi theo.

4. DB Adapter Của EmDash#

EmDash chỉ định DB adapter trong astro.config.mjs:

astro.config.mjs
import emdash from "emdash/astro";
import { d1 } from "emdash/db";

export default defineConfig({
  integrations: [
    emdash({
      database: d1(),  // Cloudflare D1 adapter
    }),
  ],
});
js

Các adapter khả dụng:

AdapterDùng Cho
d1()Cloudflare D1 (serverless)
sqlite()SQLite local (cho development)
libsql()LibSQL/Turso
postgresql()PostgreSQL

5. seed.json: Nguồn Sự Thật Cho Schema#

seed/seed.json là document bootstrap cho EmDash site. Định nghĩa collections, fields, taxonomies, menus, redirects, widget areas, site settings.

Cấu Trúc seed.json#

Quy Tắc Áp Dụng#

Thao TácHành Vi
Collections, Settingsupsert — có thì cập nhật, không thì tạo mới
Menus, Widgetsreplace — ghi đè hoàn toàn bằng seed
Content entriesskip — bỏ qua nếu slug đã tồn tại

Cách Áp Dụng#

# Áp dụng qua CLI
npx emdash seed seed/seed.json

# Export schema hiện tại
npx emdash export-seed > .emdash/seed.json

# Export kèm content
npx emdash export-seed --with-content > .emdash/seed.json
bash

[!TIP] seed.json tự động áp dụng ở “request đầu tiên” khi database trống. Trong development, nên áp dụng rõ ràng qua CLI cho chắc chắn.

6. Phát Triển Local: Miniflare + SQLite#

Phát triển local dùng Miniflare (local simulator của Cloudflare).

Đường Dẫn Lưu Trữ#

.wrangler/state/v3/d1/miniflare-D1DatabaseObject/<hash>.sqlite
text
MụcMô Tả
<hash>Hash hex bắt nguồn từ database_id
Định dạngSQLite compatible (kết nối trực tiếp bằng better-sqlite3)
PersistenceGiữ data giữa các session wrangler dev
Local/RemotePhân tách hoàn toàn với flag --local / --remote

Luồng Phát Triển Local#

# Áp dụng seed vào D1 local
npx emdash seed seed/seed.json --local

# Start dev server
wrangler dev

# Kiểm tra local DB
ls .wrangler/state/v3/d1/miniflare-D1DatabaseObject/
bash

[!NOTE] Local DB và remote DB hoàn toàn tách biệt. Dùng --local và --remote để phân biệt.

7. Luồng Dữ Liệu Toàn Bộ#

Request tranggetEmDashCollection()SQL query (env.DB)Content dataDữ liệu renderHTML responseRequest hình ảnhQua env.MEDIAPhân phối hình ảnhUserAstroEmDash RuntimeCloudflare D1Cloudflare R2UserAstroEmDash RuntimeCloudflare D1Cloudflare R2

8. Tóm Tắt#

Thành PhầnVai TròFile
D1Content DBwrangler.jsonc (cấu hình Binding)
R2Media storagewrangler.jsonc (cấu hình Binding)
EmDashCMS layerastro.config.mjs (d1() adapter)
seed.jsonNguồn sự thật schemaseed/seed.json
MiniflareLocal DB.wrangler/state/v3/d1/miniflare-D1DatabaseObject/*.sqlite

Kết hợp EmDash + D1 + R2 tạo kiến trúc CMS serverless scalable. Thoát khỏi quản lý server WordPress, phân phối nhanh trên edge.

Tài Liệu Tham Khảo#