Skip to content

非公式本サイトは非公式の日本語ドキュメントであり、Cloudflare 公式サイトではありません。最新情報はdevelopers.cloudflare.comをご確認ください。

Docusaurus

最終更新 Markdown で表示Agent セットアップ

CLI から始める: Workers 上に Docusaurus プロジェクトを足場から作成し、テンプレートを選びます。

npm create cloudflare@latest -- my-docusaurus-app --framework=docusaurus

またはデプロイだけする: Docusaurus でドキュメントサイトを作成し、CI/CD とプレビューまで設定済みの状態で Cloudflare Workers にデプロイします。

Workers にデプロイ

Docusaurus とは

Docusaurus ↗ は、ドキュメントサイトの構築、デプロイ、保守向けのオープンソースフレームワークです。React 上に構築されており、ドキュメントに特化した静的サイトを直感的に作れます。

Docusaurus は使いやすくカスタマイズしやすいため、ドキュメントサイトをすばやく作りたい開発者や組織に選ばれています。

Workers に新しい Docusaurus プロジェクトをデプロイする

  1. create-cloudflare CLI（C3）で新しいプロジェクトを作成します。

    npm create cloudflare@latest -- my-docusaurus-app --framework=docusaurus --platform=workers

    裏側では何が起きていますか？

    このコマンドを実行すると、C3 は新しいプロジェクトディレクトリを作成し、Docusaurus の公式セットアップツール ↗ を起動して、プロジェクトを Cloudflare 向けに設定します。その後、アプリケーションを Cloudflare にすぐデプロイするかどうかを選べます。

  2. ローカルで開発します。

    プロジェクトを作成したら、プロジェクトディレクトリで次のコマンドを実行し、ローカル開発サーバーを起動します。

    npm run dev

  3. プロジェクトをデプロイします。

    プロジェクトは、ローカルマシンまたは任意の CI/CD システム（Workers Builds を含む）から、*.workers.dev サブドメイン または カスタムドメイン にデプロイできます。

    次のコマンドでビルドとデプロイを行います。CI サービスを使う場合は、「デプロイコマンド」も合わせて更新してください。

    npm run deploy

既存の Docusaurus プロジェクトを Workers にデプロイする

静的サイトの場合

Docusaurus プロジェクトがすべて事前レンダリングされている場合（通常はそうです）は、次の手順に従います。

  1. Wrangler 設定ファイルを追加します。

    プロジェクトのルートに、次の内容の Wrangler 設定ファイルを作成します。

    	{
		"name": "my-docusaurus-app",
		// Update to today's date
		// Set this to today's date
		"compatibility_date": "2026-09-20",
		"assets": {
			"directory": "./build"
		}
	}
    name = "my-docusaurus-app"
# Set this to today's date
compatibility_date = "2026-09-20"

[assets]
directory = "./build"

    この設定は何をしていますか？

    この設定の要点は assets フィールドです。Wrangler に静的アセットの場所を伝えます。ここでは ./build ディレクトリを見るように指定しています。アセットが別のディレクトリにある場合は、directory の値を合わせて更新します。 ほかの アセット設定オプション も参照してください。

    この設定に main フィールドがない点にも注意してください。静的アセットだけを配信するため、オンデマンドレンダリング / SSR 用の Worker コードは不要です。

  2. プロジェクトをビルドしてデプロイします。

    プロジェクトは、ローカルマシンまたは任意の CI/CD システム（Workers Builds を含む）から、*.workers.dev サブドメイン または カスタムドメイン にデプロイできます。次のコマンドでビルドとデプロイを行います。CI サービスを使う場合は、「デプロイコマンド」も合わせて更新してください。

    npx docusaurus build
    npx wrangler@latest deploy

Docusaurus でバインディングを使う

バインディングは、Docusaurus プロジェクトをほかの Cloudflare サービスにつなぎ、アプリケーション内でデータを保存・取得できるようにする仕組みです。

バインディングを使うと、アプリケーションを Cloudflare Developer Platform と完全に統合でき、コンピュート、ストレージ、AI などへアクセスできます。

役に立ちましたか？