cloudflare-pagesgithubci-cd

GitHub と Cloudflare Pages で静的サイトを deploy する

TPThuanPD2026年8月20日60分420 回視聴
Cloudflare

GitHub repository を Cloudflare Pages に接続し、静的サイトを deploy して domain を設定する手順です。

Cloudflare PagesGitHub Deploy

Lab Overview and Learning Objectives

開始前の注意

Cloudflare アカウント、website の source code がある GitHub アカウント、GitHub 上で Cloudflare Workers and Pages を導入する権限を準備します。本ラボの画面は KaizenDev website を deploy したときのものです。

目的:ラボ完了後、Cloudflare Workers & Pages で build と deploy が行われ、確認用の production URL が得られます。
1

1. Workers & Pages を開く

Workers と Pages 上で動く project を管理する場所です。ここから新しい application を作成します。

  1. Cloudflare Dashboard にログインします。
  2. 左メニューから Workers & Pages を選択します。
  3. 右上の Create application を押します。
Create application ボタンがある Workers & Pages 画面
Create application ボタンがある Workers & Pages 画面
完了条件:source code の deploy 方法を選ぶ、新規 application の作成フローが開きます。
2

2. Connect GitHub を選択

Worker や Page の作成方法は複数ありますが、本ラボでは repository から自動で build と deploy を行うため GitHub を使用します。

  1. Create a Worker 画面で Import a repository を探します。
  2. Connect GitHub を選択します。
  3. GitHub の認証ページに遷移するまで待ちます。
Worker 作成時に Connect GitHub を選択
Worker 作成時に Connect GitHub を選択
完了条件:GitHub アカウントと Workers & Pages の接続が開始されます。
3

3. GitHub で Cloudflare を認可

Cloudflare が repository を読み取り deployment を作成できるよう、GitHub 上で Cloudflare Workers and Pages の導入と認可が必要です。

  1. ログイン中の GitHub アカウントが正しいことを確認します。
  2. All repositories を選ぶか、deploy する repository だけを選択します。
  3. Install & Authorize を押します。
GitHub の Install & Authorize 画面
GitHub の Install & Authorize 画面
完了条件:Cloudflare が選択した repository にアクセスし、source code の読み取りと build の実行ができるようになります。
4

4. メールでアクセスを確認

アカウントによっては、GitHub が Cloudflare との接続を完了する前に追加の確認を求めます。

  1. 画面に表示されているアカウントを確認します。
  2. 求められた場合は Verify via email を押します。
  3. 確認メールを開き、認証を完了します。
Verify via email ボタンがある Confirm access 画面
Verify via email ボタンがある Confirm access 画面
完了条件:アカウントが確認され、GitHub の接続処理を続行できます。
5

5. Install & Authorize を完了

確認後、認可画面に戻って GitHub 上の Cloudflare Workers and Pages の導入を完了します。

  1. Cloudflare が要求する権限を確認します。
  2. 選択した repository がラボ用のものであることを確認します。
  3. Install & Authorize を押して完了します。
Cloudflare Workers and Pages の Install & Authorize 完了
Cloudflare Workers and Pages の Install & Authorize 完了
完了条件:GitHub が Cloudflare にコードの読み取りと deployment の管理を許可します。
6

6. deploy する repository を選択

GitHub の接続後、アカウントがアクセスできる repository の一覧が表示されます。

  1. website の source code がある repository を探します。
  2. KaizenDev またはラボ用 project の repository を選択します。
  3. Next を押して build 設定に進みます。
Workers & Pages の GitHub repository 一覧
Workers & Pages の GitHub repository 一覧
完了条件:repository が選択され、Set up your application の手順に進みます。
7

7. build command と deploy command を設定

project を build するコマンドと、production へ deploy するコマンドを決める手順です。

  1. production branch を選択します。通常は main です。
  2. website に合わせて Project name を入力します。
  3. Build command を入力します(例: npm run build)。
  4. project に応じた Deploy command を入力します(例: npx wrangler deploy)。
  5. Deploy を押します。
Project name、build command、deploy command の設定
Project name、build command、deploy command の設定
完了条件:GitHub の source code から project の build が開始されます。
8

8. 最初の deployment を確認

build log がリアルタイムで表示されます。dependency、コマンド、環境変数、出力設定の誤りはここで確認します。

  1. project の Deployments タブを開きます。
  2. Queued、Building、Deploying の状態を確認します。
  3. deployment が失敗した場合は build log を読みます。
  4. build が成功したら deployment URL を控えます。
Cloudflare で build 中の deployment log 画面
Cloudflare で build 中の deployment log 画面
完了条件:最初の deployment が完了し、production URL が得られます。
9

9. 既定のドメインを確認

deploy 後、Cloudflare は project に既定のドメインを作成します。独自ドメインを設定する前の動作確認に使えます。

  1. project の Settings または Domains を開きます。
  2. Workers domain(既定のドメイン)が有効か確認します。
  3. ブラウザーで既定のドメインを開きます。
project の既定ドメインが表示された Domains 画面
project の既定ドメインが表示された Domains 画面
完了条件:既定の Cloudflare ドメインで website にアクセスできます。
10

10. 必要に応じて custom domain を設定

custom domain を使うと、既定のドメインではなく組織の実際のドメインで website を公開できます。

  1. Custom Domains and Routes で Add Custom Domain を押します。
  2. 使用する domain または subdomain を入力します。
  3. Cloudflare の DNS / route の案内に従います。
  4. domain の状態が Active になるまで待ちます。
Cloudflare の Custom Domains and Routes 画面
Cloudflare の Custom Domains and Routes 画面
完了条件:設定完了後、独自ドメインで website にアクセスできます。
11

11. deploy 後に website を確認

最後に production の website を開き、deploy 後の実際の表示を確認します。

  1. production URL または custom domain を開きます。
  2. トップページに想定どおりの KaizenDev の内容が表示されるか確認します。
  3. 画像、ナビゲーション、主要なボタンを確認します。
  4. 表示に問題がある場合は deployment log または source code に戻って修正します。
deploy 成功後に動作している KaizenDev website
deploy 成功後に動作している KaizenDev website
完了条件:KaizenDev website が Cloudflare 上で正しく表示されます。

参考ドキュメント