一体型セットアップ
一体型は、content/ とサイト実装を1つのリポジトリに置く構成です。既定値で、最も間違いが少ない選択です。
公式サンプル: Rerurate514/riebeckite-e2e-integrated — integrated.riebeckite.dev
1. プロジェクトを作る
npx create-riebeckite my-site --preset starter --github-actions
cd my-site
npm install
--github-actions を付けると wrangler.jsonc と .github/workflows/publish.yml が生成されます。npm install は package-lock.json を作り、ワークフローはこのファイルがある場合に npm ci を使います。
2. Worker 名とドメインを設定する
wrangler.jsonc を編集します。
{
"$schema": "node_modules/wrangler/config-schema.json",
"name": "my-site",
"compatibility_date": "2026-06-09",
"compatibility_flags": ["nodejs_compat"],
"assets": { "directory": "./dist" },
"routes": [{ "pattern": "my-site.example.com", "custom_domain": true }]
}
編集するときも compatibility_flags と assets は残してください。assets のみの Worker には必要です。
Worker 名は Cloudflare アカウント内で一意にしてください。カスタムドメインの DNS レコードは自動で作られるため、同じホスト名の DNS レコードを別途追加しないでください。
riebeckite.config.ts に公開 URL を設定します。
site: {
title: "My site",
baseUrl: "https://my-site.example.com",
},
3. ローカルで動かす
npm exec riebeckite check
npm exec riebeckite dev
表示された URL をブラウザで開きます。content/index.md を編集し、ページが更新されることを確認してください。
4. ビルドする
npm exec riebeckite build
静的サイトは dist/ に出力されます。package-lock.json はコミットし、dist/ と node_modules/ はコミットしません。
5. デプロイする
最初の手動デプロイでは、--github-actions は Wrangler をプロジェクトに追加しないため、先にインストールします。
npm install -D wrangler
npm exec -- riebeckite publish run --execute
初回は Cloudflare のログインが開きます。自動デプロイには、GitHub リポジトリへ次を登録します。
- Secret
CLOUDFLARE_API_TOKEN:Account の Workers Scripts:Edit、Zone の Workers Routes:Edit、Zone の Zone:Read - Variable
CLOUDFLARE_ACCOUNT_ID:Cloudflare のアカウント ID
生成されたワークフローは main への push ごとにデプロイします。詳しくは Cloudflare Workers と GitHub Actions を参照してください。
6. 確認する
curl -I https://my-site.example.com/
curl -I https://my-site.example.com/notes/writing
HTML、CSS、画像、404 ページ、sitemap.xml、robots.txt を確認します。カスタムドメインが開かない場合は、ルートがデプロイされていないか、同じホスト名を別の Worker が使っています。
よくある間違い
- サイトのフォルダの外から
npm exec riebeckite ...を実行する。コマンドはサイトのルートから実行してください。 publish: trueを付けずにページを追加する。新しいノートは下書きのままで、ビルドしたサイトに出ません。dist/を直接編集する。dist/はビルドのたびにcontent/とapp/から作り直されるので、元のファイルを編集してください。dist/やnode_modules/をコミットする。代わりにpackage-lock.jsonをコミットしてください。- デプロイ後に
site.baseUrlだけ変えて再ビルドしない。サイトマップやフィードの URL は設定したbaseUrlを使うので、変更後は再ビルドして再デプロイしてください。
次に読む
Powered by Riebeckite