Cloudflare Pagesの使い方|AIで作ったサイトをGitHubから公開する

公開 更新 10 分で読了
Cloudflare Pagesの使い方|AIで作ったサイトをGitHubから公開する

AIで作ったHTML・CSS・画像をGitHubに置き、Cloudflare Pagesの無料枠で公開する方法を解説します。公開フォルダと本番ブランチの設定、プレビューURLでの更新確認、404・画像切れ・変更が反映されないときの確認先まで紹介します。

Cloudflare Pagesは、HTML・CSS・画像でできた静的サイトをインターネットに公開するCloudflareのサービスです。無料プランで始められ、GitHubのリポジトリをつなぐと、AIで作ったHTMLを共有用の pages.dev のURLで開けます。以降はGitHubで変更を保存し、本番と別のURLで表示を確かめてから反映できます。[1][2]

Cloudflareは現在、新規プロジェクトにはWorkersを推奨しています。Pagesを使う場合は、以下の手順でGitHubから静的サイトを公開できます。[12]

Xでは、AIを使い始めた人にGitHubとCloudflareの学習を勧める投稿がありました。[11] この手順では、両方のサービスを使って、手元のHTMLを共有できるURLにします。

Cloudflare Pagesで公開できるファイルを確認する

最初は、ブラウザが直接読み込めるHTML・CSS・画像をそろえます。次の例では、公開するファイルを site にまとめ、その直下にトップページの index.html を置きます。[3]

HTML、CSS、画像に見立てたカードとフォルダ

site/
├── index.html
├── style.css
└── images/
    └── cover.jpg
  1. ページを保存する。 次のHTMLをUTF-8で site/index.html として保存します。 href と src には、HTMLから見たCSSと画像の位置が入っています。

    <!doctype html>
    <html lang="ja">
    <head>
      <meta charset="utf-8">
      <meta name="viewport" content="width=device-width, initial-scale=1">
      <title>週末の散歩</title>
      <link rel="stylesheet" href="./style.css">
    </head>
    <body>
      <main>
        <h1>週末の散歩</h1>
        <p>近所で見つけた風景を紹介します。</p>
        <img src="./images/cover.jpg" alt="散歩道の風景">
      </main>
    </body>
    </html>
    
  2. CSSと画像を置く。 次のCSSを site/style.css に保存し、掲載できるJPEG画像を site/images/cover.jpg に置きます。手持ちの画像を使う場合は、実際に写っている内容に合わせて alt も書き換えます。

    body { margin: 0; padding: 2rem; background: #fff6e8; color: #252a34; }
    main { max-width: 42rem; margin-inline: auto; }
    img { display: block; max-width: 100%; height: auto; }
    
  3. ブラウザで開く。 index.html を開き、ページの背景が薄いクリーム色になり、見出しと画像が出ることを確かめます。画像が表示されなければ、拡張子も含めて cover.jpg と実ファイル名を比べます。

AIに既存のページを整えてもらう場合は、「このページを静的HTMLとして共有できるように、site/index.html、site/style.css、site/images/ の構成に整理してください。CSSと画像は相対パスで参照し、ブラウザで直接開くために必要なファイルを一覧にしてください」と頼めます。最初に公開する範囲やフォームの扱いから詰めたい場合は、Claude Codeで実装前の要件を具体化する手順も使えます。

公開フォルダには、配信してよいファイルだけを入れます。AIが生成したHTMLやJavaScriptにAPIキー、トークン、個人情報が入っていないか確認し、.env や作業メモもGitHubへアップロードするファイルから外します。

ログイン、フォームの保存、データベースへの読み書きなどは、サーバー側の処理を別途用意する必要があります。画面を共有するだけなら静的ファイルで始められます。投稿の管理や編集画面まで必要なら、EmDashでCMSを立ち上げる手順が次の検討先です。

GitHubにHTMLを置き、Cloudflare Pagesと接続する

AIが作ったHTMLをGitHubから公開するには、静的ファイルを保存したGitHubのリポジトリを、Cloudflare PagesのGit連携で選びます。GitHubとCloudflareのアカウントを用意し、今回のサイト用に新しいリポジトリを作ると、接続先と公開するファイルを確認しやすくなります。[1][4]

ファイルの束をクラウドにつなぐ紙の模型

  1. GitHubにファイルを保存する。 リポジトリのファイル一覧から Add file → Upload files を開き、site フォルダを構成ごとアップロードします。コミットはファイルの変更を保存した記録です。保存後、使うブランチのファイル一覧で site/index.html と site/images/cover.jpg を開けることを確かめます。[4]
  2. CloudflareでPagesのGit連携を選ぶ。 Cloudflareのダッシュボードで Workers & Pages を開き、Create application → Pages → Connect to Git と進んでGitHubを選びます。リポジトリを選んだ後、公式ガイドの Install & Authorize と Begin setup に沿って進みます。[1]
  3. 対象のリポジトリだけにアクセスを許可する。 GitHub Appのインストール時に Only select repositories を選び、今回使うリポジトリを指定します。接続候補に対象が出てこない場合は、GitHubの Installed GitHub Apps で、リポジトリを所有するアカウントや組織にアプリが入り、対象が許可されているか確かめます。[5]

GitHubのリポジトリは非公開でも連携できます。リポジトリの閲覧権限と、デプロイ後のサイトを閲覧できる範囲は別です。公開するファイルは、リポジトリが非公開でも共有してよい内容に絞ります。[1][6]

本番ブランチと公開フォルダを選ぶ

Production branch には本番に反映したいブランチを選び、公開フォルダには index.html が入った site を指定します。設定画面の Set up builds and deployments では、作例の場合は次の値を使います。[1][3]

設定項目 作例で指定する値
Project name 共有用URLに使うプロジェクト名
Production branch ファイルを保存した main
Framework preset 選択せずに進む
Build command exit 0
Build output directory site
Root directory (advanced) 既定のまま

静的HTML向けの公式ガイドに従い、exit 0 を指定します。これはビルド処理を行わず正常に終了するコマンドです。[3]

ここでの公開フォルダは、ブラウザへ配るファイルが入った場所です。ルートディレクトリを変えていなければ、作例ではリポジトリ直下の site が出力先です。サイトを開くときのURLに /site/ を足す必要はありません。[1][3]

  1. Save and Deploy を選ぶ。 デプロイは、指定したファイルを公開先へ反映する処理です。初回の処理が終わると、表示確認用のURLが発行されます。[1]
  2. 本番の状態を確認する。 Continue to project でプロジェクトを開き、本番URLと対応するコミットを確認します。結果が失敗なら、同じ画面からデプロイのログを開き、公開フォルダとして指定した名前が実際のフォルダと一致するか見直します。[1]

公開URLで表示を確かめ、次の変更をプレビューする

共有に使うのは、プロジェクト画面に出る本番URLです。変更用ブランチを作ると、既定では別のデプロイが作られ、本番を更新する前にプレビューURLで変更を見られます。[1][6]

本番とプレビューの違いを表した二つのページ模型

  1. 初回の表示を確認する。 プロジェクト名が仮に walk-note なら、本番URLの形は https://walk-note.pages.dev/ です。実際には発行されたURLを開いて見出し、背景色、画像を見ます。画像のURLも直接開き、作例ならパスが /images/cover.jpg であることを確認します。[1][6]
  2. 変更用のブランチで見出しを変える。 GitHubで preview-title などのブランチを作り、site/index.html の見出しを「週末の散歩メモ」に変えてコミットします。Cloudflareでプレビューのデプロイを開き、ブランチ名とコミットが今回のものか確かめてから、発行されたURLを開きます。[5][6]
  3. 本番に反映する。 プレビューで新しい見出しと画像が出たら、変更を本番ブランチにマージします。Cloudflareのプロジェクト画面で本番デプロイの完了を待ち、GitHubの本番ブランチ側で確認したコミットと、Cloudflareの本番デプロイに出るコミットを照合します。最後に、同じ本番URLに新しい見出しが出ることを確かめます。[1][6]

プレビューには、特定のデプロイを指すハッシュ付きURLと、ブランチの最新デプロイを指す別名があります。たとえば abc123.walk-note.pages.dev はその時点の版を示し、preview-title.walk-note.pages.dev はそのブランチに新しい版が反映されると指す先が更新されます。プレビューは既定で公開されるので、公開前の資料や個人情報を載せる場合は閲覧制限を先に設定します。[6]

既存サイトの移行でURLを引き継ぐ場合は、公開後も旧URLから必要なページへたどれるか確認が必要です。WordPressを使っている場合は、EmDashへ移行するときのURLと移行範囲の確認も参考になります。

404や画像切れをファイル配置から調べる

まず「どのURLを開いたか」と「どのファイルや変更が見えないか」を照合します。ページ全体の404、画像だけの欠落、表示が古い場合では、最初に見る場所が違います。[1][3][6][7]

ファイルの配置を虫眼鏡で調べる紙の模型

症状 最初の確認先 作例での確かめ方
トップページを開くと404になる 公開フォルダ直下の index.html 出力先が site なら、対象コミットに site/index.html があるか確認します。 site/site/index.html のように一段深い場合は配置または出力先を直します。
ページは開くが画像だけ表示されない HTMLの相対パスと実ファイル名 ./images/cover.jpg と site/images/cover.jpg を比べ、 Cover.JPG などの大小文字や拡張子の違いも確認します。
変更前の見出しのまま 開いているURL、ブランチ、コミット 本番URLを開いているかを確かめ、本番のデプロイ詳細とGitHubの本番ブランチでコミットを比べます。
  1. 公開フォルダを起点にたどる。 GitHubではリポジトリから site/index.html を開きますが、公開URLでは site の中身がサイトのルートです。画像を探すときは本番URLの後ろに /images/cover.jpg を足し、そのファイルが配信されているか確かめます。[1][3]
  2. GitHubでファイル名を照合する。 画像が手元では出る場合も、ファイル名がHTMLの参照先と一文字ずつ一致するか確認します。GitHub上に画像自体がなければ、対象ブランチに画像を追加してから、新しいデプロイで表示を確認します。
  3. 版を照合してから再読み込みする。 デプロイのコミットが古い場合は、変更が本番ブランチまで入ったかと、デプロイが完了したかを先に確かめます。コミットが合っている場合は、新しいタブや別のブラウザでも同じURLを開いて見比べます。[1][7]

よくある質問

Cloudflare PagesのGitHub連携では、GitHubでファイルを保存し、Cloudflareで配信と公開URLを管理します。無料枠や独自ドメイン、Reactの出力先は、公式資料で確認できます。[1][2][8][9][10]

静的サイトの模型と質問を表す四枚のカード

よくある質問

Q. GitHubに置くだけで公開できますか?
Cloudflare PagesのURLで公開するには、最初にPagesのプロジェクトとGitHubのリポジトリを接続してデプロイします。連携後は、対象のブランチへ更新を保存すると、既定ではその変更でデプロイが始まります。
Q. 独自ドメインは必要ですか?
発行される pages.dev のURLをそのまま共有できます。すでに持っているドメインを使う場合は、最初のデプロイで表示を確認したあとに、プロジェクトでカスタムドメインを設定できます。
Q. 無料枠で始められますか?
Cloudflare Pagesの無料枠で始められます。公式の上限表では、無料プランは月500ビルドで、1サイトに置けるファイルは最大20,000件、1ファイルの上限は25 MiBです。
Q. Reactなどでビルドが必要な場合はどこを見ますか?
Cloudflare公式のビルド設定表と、使っているフレームワークのガイドを確認します。ReactとViteの公式例では、Build command が npm run build、公開する出力先が dist です。プロジェクトの設定を変えている場合は、実際に生成された場所を指定します。

出典・参考データ

  1. [1] Cloudflare PagesのGit連携
  2. [2] Cloudflare Pagesの製品・プラン
  3. [3] Cloudflare Pagesの静的HTMLガイド
  4. [4] GitHubのファイル追加ガイド
  5. [5] Cloudflare PagesのGitHub連携
  6. [6] Cloudflare Pagesのプレビュー
  7. [7] Cloudflare Pagesのファイル配信
  8. [8] Cloudflare Pagesの上限
  9. [9] Cloudflare Pagesのビルド設定
  10. [10] Cloudflare PagesのReactガイド
  11. [11] 題材のX投稿
  12. [12] Cloudflare Pagesの概要と新規プロジェクト向けの案内

この記事を書いた人

水島 翔吾

株式会社kairos 代表取締役 / AgentSignal 開発者

AI クローラー・AI 流入計測と AIO 診断ツール AgentSignal を開発。実測データを元に AI 検索時代の計測と対策を書いています。

関連記事