Skip to content

ハンドブックのデプロイとアクセス制限 ​

このハンドブックを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.0

VitePress 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を作る ​

  1. CloudflareのWorkers & Pagesで PagesのGit連携プロジェクトを作成し、対象のGitHubリポジトリを接続する。Workersへのデプロイとは区別する。
  2. 最初は公開可能な仮内容だけのブランチをProduction branchに指定する。プレビューの自動ビルドは一旦無効にし、保護確認後に必要なブランチのみ有効にする。
  3. ハンドブックの配信へ切り替える際の設定は以下。ルートはリポジトリ直下で、Functionsやサーバーは不要。
設定値
Framework presetVitePress(なければNone)
Root directoryリポジトリ直下(空欄)
Build commandnpm run docs:build
Build output directory.vitepress/dist
Node.jsNODE_VERSION=24(.node-versionと揃える)
Production branchマージ先ブランチ(通常 main、保護確認後に切り替える)

依存関係はコミット済みの package-lock.json を使う。環境で自動インストールを無効にしている場合はビルドコマンドを npm ci && npm run docs:build とする。このサイトにはデプロイ用シークレットの埋め込みは不要。

Cloudflare Accessを設定する(管理者作業) ​

  1. Zero Trustを有効にし、利用するIdPまたはメールOTPを設定する。
  2. Pagesプロジェクトのプレビューデプロイ向けAccess設定を有効にする。自動作成されたアプリケーションの対象とポリシーをZero Trust側で確認する。プレビュー用の設定だけでProductionが保護されたとは判断しない。
  3. Zero TrustのAccess → ApplicationsでSelf-hostedアプリケーションを設定する。実際のホスト名を用いて、次の全経路を保護する。パスは全体を対象にする。
経路確認対象の例
Production<project>.pages.dev
Preview<hash>.<project>.pages.dev、<branch>.<project>.pages.dev(ワイルドカード *.<project>.pages.dev の適用範囲も確認)
独自ドメイン設定した全ホスト名。後から追加したものも個別に確認
  1. Allowポリシーは許可するメールアドレスやIdPグループを明示する。Everyoneや意図しないBypassを残さない。Pagesが作ったアプリケーションと手動設定の競合・対象漏れを確認する。
  2. ホスト名を保護できない場合は、内部本文の配信を止めたまま原因を解消する。プレビューを使わない場合も既存のデプロイURLが残っていないか確認する。

保護を検証してから本文を配信する ​

各ホスト名のトップだけでなく、/guides/project-setup.html などの直接URLと、生成済みHTMLが参照する /assets/ のファイルも点検する。

  • 未認証のシークレットウィンドウではログインを要求され、本文や検索データを取得できない。
  • 許可していないアカウントでは拒否される。
  • 許可したアカウントではページ・検索・チェックリストを使える。
  • Production、ハッシュ・ブランチ別Preview、独自ドメインのすべてで同じ確認をする。古いデプロイURLも確認する。
  • 一時公開した内部情報がある場合は保護設定だけで済ませず、デプロイ削除やキャッシュ、ソース履歴への露出も調査する。

確認後にProduction branchを本文のあるブランチに変更して再デプロイし、同じ検証を繰り返す。対象ホスト名・確認日・許可/拒否の結果を管理者が確認できる場所に残す。アカウント設定が未実施の間は「Access設定済み」と報告しない。

公式資料 ​