表示テーマ
ハンドブックのデプロイとアクセス制限
このハンドブックをCloudflare Pagesで配信するときに使う。ゲーム本体の一般公開準備は公開前チェックリストを参照する。
実装済みなのは静的サイトとビルド設定まで。Cloudflareのプロジェクト作成・デプロイ・Access設定・認証検証は別途必要であり、完了扱いにしない。 以下は管理者が実施する手順で、実アカウントでの設定は未検証。画面名は変更される場合があるため、公式資料も確認する。
ローカルで確認する
Node.js 24を使い、リポジトリ直下で実行する。
sh
npm ci
npm run docs:dev配信する成果物を確認するときは次を使う。
sh
npm run docs:build
npm run docs:preview -- --host 0.0.0.0VitePress 1.6系が依存する旧Viteの既知の脆弱性を避けるため、package.json の overrides でVite 6.4.6以降を使用する。VitePressの更新時にはこの指定の要否とビルド・画面表示を再確認する。
出力は .vitepress/dist。README.md がトップページとなり、guides/・resources/・AGENTS.md・templates/AGENTS.md を直接ビルドする。本文のコピーや別のCMSは作らない。ページ追加時は .vitepress/config.mts のナビゲーションも更新する。リンク切れはビルドで検出する。
立ち上げチェックリストは guides/project-setup.md のMarkdownタスクリストから生成する。項目の追加・説明の変更はそのMarkdownで行う。チェック操作に応じて進捗を表示し、再読み込み時はMarkdownの初期状態に戻る。チェック状態の永続化は行わない。JavaScriptが無効でも手順本文は読める。
公開前にソースと配信範囲を確認する
- GitHubのSettingsでリポジトリの公開範囲を確認する。公開リポジトリのMarkdown・履歴はAccessでは隠せない。内部情報が必要なら非公開化するか、公開可能な資料と分離する。
- 静的HTML、検索インデックス、JavaScriptには閲覧対象の内容が含まれる。トークン・個人情報・内部の証跡をコミットしない。
noindexは検索エンジンへの依頼にすぎず、認証の代わりにならない。- 初回は公開してよい仮の内容のみを持つ隔離したブランチ/ディレクトリを配信する。保護を確認するまで、このハンドブックの本文を配信しない。Pagesの初回デプロイ直後には未保護のURLが存在し得る。
Cloudflare Pagesを作る
- CloudflareのWorkers & Pagesで PagesのGit連携プロジェクトを作成し、対象のGitHubリポジトリを接続する。Workersへのデプロイとは区別する。
- 最初は公開可能な仮内容だけのブランチをProduction branchに指定する。プレビューの自動ビルドは一旦無効にし、保護確認後に必要なブランチのみ有効にする。
- ハンドブックの配信へ切り替える際の設定は以下。ルートはリポジトリ直下で、Functionsやサーバーは不要。
| 設定 | 値 |
|---|---|
| Framework preset | VitePress(なければNone) |
| Root directory | リポジトリ直下(空欄) |
| Build command | npm run docs:build |
| Build output directory | .vitepress/dist |
| Node.js | NODE_VERSION=24(.node-versionと揃える) |
| Production branch | マージ先ブランチ(通常 main、保護確認後に切り替える) |
依存関係はコミット済みの package-lock.json を使う。環境で自動インストールを無効にしている場合はビルドコマンドを npm ci && npm run docs:build とする。このサイトにはデプロイ用シークレットの埋め込みは不要。
Cloudflare Accessを設定する(管理者作業)
- Zero Trustを有効にし、利用するIdPまたはメールOTPを設定する。
- Pagesプロジェクトのプレビューデプロイ向けAccess設定を有効にする。自動作成されたアプリケーションの対象とポリシーをZero Trust側で確認する。プレビュー用の設定だけでProductionが保護されたとは判断しない。
- Zero TrustのAccess → ApplicationsでSelf-hostedアプリケーションを設定する。実際のホスト名を用いて、次の全経路を保護する。パスは全体を対象にする。
| 経路 | 確認対象の例 |
|---|---|
| Production | <project>.pages.dev |
| Preview | <hash>.<project>.pages.dev、<branch>.<project>.pages.dev(ワイルドカード *.<project>.pages.dev の適用範囲も確認) |
| 独自ドメイン | 設定した全ホスト名。後から追加したものも個別に確認 |
- Allowポリシーは許可するメールアドレスやIdPグループを明示する。Everyoneや意図しないBypassを残さない。Pagesが作ったアプリケーションと手動設定の競合・対象漏れを確認する。
- ホスト名を保護できない場合は、内部本文の配信を止めたまま原因を解消する。プレビューを使わない場合も既存のデプロイURLが残っていないか確認する。
保護を検証してから本文を配信する
各ホスト名のトップだけでなく、/guides/project-setup.html などの直接URLと、生成済みHTMLが参照する /assets/ のファイルも点検する。
- 未認証のシークレットウィンドウではログインを要求され、本文や検索データを取得できない。
- 許可していないアカウントでは拒否される。
- 許可したアカウントではページ・検索・チェックリストを使える。
- Production、ハッシュ・ブランチ別Preview、独自ドメインのすべてで同じ確認をする。古いデプロイURLも確認する。
- 一時公開した内部情報がある場合は保護設定だけで済ませず、デプロイ削除やキャッシュ、ソース履歴への露出も調査する。
確認後にProduction branchを本文のあるブランチに変更して再デプロイし、同じ検証を繰り返す。対象ホスト名・確認日・許可/拒否の結果を管理者が確認できる場所に残す。アカウント設定が未実施の間は「Access設定済み」と報告しない。