ログイン

EmDash CMS を Cloudflare Workers にデプロイ・運用する

Deploy and run EmDash CMS sites on Cloudflare Workers

EmDash CMS の新規サイト構築、独自ドメイン接続、セットアップ、アップグレード、Workers の CPU 制限エラー診断までを検証付きで進める手順集。

Claude CodeHermes AgentCodex CLICursorMIT（改変・再配布・商用利用可）

できること

Astro ベースの CMS「EmDash」を Cloudflare Workers（D1・R2・KV）で動かすための実務手順をエージェントに渡します。

  • テンプレートからの新規サイト作成と wrangler deploy（D1/R2/KV の自動プロビジョニング）
  • seed/seed.json の事前検証（使い捨て SQLite に実際に適用してエラーを検出）
  • 独自ドメイン・サブドメインの接続と、EmDash 側のドメイン切り替え
  • EmDash / Astro のアップグレード（前後の URL チェックとデプロイ確認）
  • HTTP 503 や Cloudflare 1102（CPU 制限超過）の原因切り分け

使い方

エージェントに「EmDash で新しいサイトを Cloudflare に作って」「1102 エラーの原因を調べて」などと依頼すると、このスキルの手順に沿って作業します。詳細は references/ の各ファイルを参照します。

CI=1 node node_modules/astro/bin/astro.mjs build < /dev/null
CI=1 node node_modules/wrangler/bin/wrangler.js deploy < /dev/null

必要な環境

  • Cloudflare アカウント（Workers / D1 / R2 が使えること）
  • Node.js、wrangler、git（GitHub CLI 推奨）

注意点

  • パスキー作成、OAuth 承認、課金プランの変更、ドメイン購入は必ず人間が行います。エージェントは手前で止まります。
  • 「デプロイ完了」「初期設定完了」「コンテンツ公開」を区別し、実際に取得して確認できたものだけを完了として報告します。
  • 料金や上限値は変わるため、公式ドキュメントで最新値を確認してください。
English description

Create, domain-attach, set up, upgrade and troubleshoot EmDash CMS sites on Cloudflare Workers with verification gates at every step.

What it does

A field-tested procedure for running the Astro-based EmDash CMS on Cloudflare Workers (D1, R2, KV).

  • Create a site from the official templates and deploy with wrangler deploy (D1/R2/KV auto-provisioned)
  • Validate seed/seed.json against a throwaway SQLite database
  • Attach custom domains and switch the site URL safely
  • Upgrade EmDash / Astro with before/after URL checks
  • Diagnose HTTP 503 and Cloudflare error 1102 (CPU limit exceeded)

How to use

Ask "create a new EmDash site on Cloudflare" or "why does the admin API return 1102?"; the agent follows the skill and references/.

CI=1 node node_modules/astro/bin/astro.mjs build < /dev/null
CI=1 node node_modules/wrangler/bin/wrangler.js deploy < /dev/null

Requirements

  • A Cloudflare account with Workers, D1 and R2
  • Node.js, wrangler, git (GitHub CLI recommended)

Notes

  • Passkey creation, OAuth approval, billing changes and domain purchases are always done by a human; the agent stops before them.
  • Deployment, setup and content launch are reported separately; only fetched-back results count as done.
  • Check official docs for current prices and limits.

インストール方法

  1. ダウンロードしたZIPを展開します（中に emdash-cloudflare-deploy/ フォルダと SKILL.md があります）。
  2. フォルダごと、使うエージェントのスキル置き場にコピーします。
    • Claude Code：~/.claude/skills/（プロジェクト単位なら .claude/skills/）
    • Hermes Agent：~/.hermes/skills/
  3. エージェントを再起動し、スキル一覧に表示されることを確認します。

詳しい使い方