第7章 デプロイ — GitHub Pagesで公開する
必須 この段階を進めるなら、必ず読んでください。一言まとめ: GitHub Pagesは、リポジトリにあるウェブ用のファイルをそのままインターネットのサイトにしてくれる無料サービスです。無料アカウントでは、公開リポジトリでないと使えません。 デプロイ(公開)は外の世界に影響を与える行動なので、Claude Codeの巻き戻しでは取り消せません。 公開してよいかどうかは、人が確認してから押します。
この章は、2026年11月1日に確認したGitHubとClaude Codeの公式ドキュメントをもとに書きました。GitHubの画面は、英語表示で書いています。
GitHub Pagesとは
GitHub Pagesは、リポジトリにあるウェブ用のファイル(HTML・CSS・JavaScript、ウェブページを作っているファイル)を受け取り、ウェブサイトとして公開するサービスです。[1] 必要なら、公開する前にビルド(ファイルをサイトに載せる形に変える作業)を通します。やることボードはファイルをそのまま載せればよいので、ビルドを気にしなくてもかまいません。
Pagesは静的サイト(Static site)を載せる場所です。静的サイトとは、訪問者ごとに内容が変わるサーバーを持たず、決まったファイルをそのまま見せるサイトのことです。やることボードのように、表を見せるページに向いています。
第2章で見たとおり、無料アカウントは公開リポジトリでだけPagesを使えます。[2] そして、Pagesのサイトはインターネットに公開されます。 契約しているプランで非公開リポジトリにできる場合でも、サイトは公開されます。そのため、デリケートなデータは公開前に消しておく必要があります。[3]
理解度チェック
無料アカウントの GitHub Pages の説明として正しいものはどれでしょうか?
公開する2つの方法
| 方法 | いつ使う? |
|---|---|
| ブランチから公開 | ビルドの手順を自分で調整する必要がないとき(おすすめ) |
| GitHub Actionsで公開 | ビルドの手順を自分で決めたいとき |
出典: GitHub公式ドキュメント(一部のみ抜粋)[4]
2つ目の方法のGitHub Actionsは、第5章で見た機能です。反映するたびに、決めておいた作業をGitHubが自動で動かしてくれます。この方法では、その機能に公開まで任せます。
やることボードのように、ファイルをそのまま見せるページなら、ブランチから公開で十分です。公式ドキュメントも、ビルドの手順を調整する必要がなければこの方法をすすめています。[4:1] ブランチとフォルダ(リポジトリの一番上の / または /docs)を選ぶと、そのブランチに反映するたびに、そのフォルダの内容が公開されます。[5]
公開されたサイトのアドレスは https://自分のID.github.io/リポジトリ名/ の形になります。
詳しく: GitHub Actionsで公開する方法(クリックして開く)
このガイドの「自分でやってみよう」では使いません。GitHubの入門チュートリアルがこの方法を使っているので、チュートリアルを見たときに迷わないように書いておきます。
設定のPagesでSourceをGitHub Actionsに変え、デプロイ用の設定ファイルを入れると、それ以降は main に反映するたびにサイトが再デプロイされます。[6]
理解度チェック
やること一覧ボードのように、ビルドの工程を調整する必要がないページに、公式ドキュメントがすすめる公開方法はどれでしょうか?
上限と禁止事項
無料ですが、使ってはいけない用途があります。まずは、この2つだけ覚えておきましょう。
- 事業に使わない: 事業・ネットショップ・商用サービス(SaaS、お金を受け取って提供するオンラインサービス)の運営は禁止です。[7]
- パスワードを受け取らない: パスワードやカード番号をやり取りするページには使わないでください。[8]
練習用のやることボードは、どちらにも当てはまりません。
訪問者のIPアドレスが記録されます。 IPアドレスは、インターネットにつながった機器ごとに付く番号です。Pagesのサイトに誰かがアクセスすると、ログインしているかどうかに関係なく、セキュリティ目的で訪問者のIPアドレスが記録・保存されます。[9] 自分のページに「何も集めていません」と書きたい場合は、この点もあわせて書いておきましょう。
詳しく: サイズ・時間の上限と練習用サイトの条件(クリックして開く)
| 区分 | 上限 |
|---|---|
| サイズ | 公開するサイトは1GB以下 |
| 時間 | デプロイが10分を超えると失敗 |
| 帯域幅 | 1か月100GB(ゆるやかな上限) |
出典: GitHub公式ドキュメント(一部のみ抜粋)[10][11][12]
帯域幅は、訪問者に送ったデータの量です。
実際のサービスをまねた練習用のサイトには、条件があります。学ぶためにまねて作ること自体は禁止されていませんが、コードを自分で書き、ユーザーのデータを集めず、元のサービスとは関係のない教育目的のものだという目立つ注意書きを付ける必要があります。[13]
理解度チェック
GitHub Pages に使ってはいけない用途はどれでしょうか?
デプロイは巻き戻しでは取り消せない
ステップ3で学んだClaude Codeの巻き戻し(チェックポイント)は、セッションの中ですばやく復旧するためのものです。永続的な記録は、Gitが担当します。[14] そして、データベースや外部サービス、デプロイのように、外のシステムに影響を与える行動は、チェックポイントでは取り消せません。[15]
だから、デプロイの直前には人が確認します。公式ドキュメントも、提案されたコマンドが安全かどうかを承認する前に確認する責任はユーザーにあると書いています。[16]
デプロイの前に、次の質問をしてみましょう。
- 第5章の確認の仕組みは通ったか?
- 第6章のレビューを終えて、PRをマージしたか?
- 公開リポジトリとページに、本名・連絡先・パスワードが入っていないか?(第9章)
デリケートなものをアップロードしてしまったときは、取り消すだけでは足りません。公開リポジトリのGitの記録に残るからです。第9章の順番(先に無効にして、入れ替える)に従ってください。
理解度チェック
公開を Claude Code の巻き戻し(チェックポイント)で元に戻せないのは、なぜでしょうか?
自分でやってみよう
- まず第9章の公開前チェックリストで、秘密の値や個人情報を確認する。
- GitHubで
cafe-todo-boardリポジトリの Settings → Pages を開く。 - 「Build and deployment」の Source で Deploy from a branch を選び、Branch で
mainブランチと/(一番上)のフォルダを選ぶ。[17] - リポジトリの一番上に
index.htmlがあるか確認する。GitHub Pagesは、公開するフォルダの一番上でこのファイルを探す。[18] そのあとhttps://自分のID.github.io/cafe-todo-board/を開く。反映までには、最大で10分ほどかかることがある。[17:1] やることボードが表示されれば成功。 - スマートフォンでも開いてみる。
- ページの下に「練習用に作ったページで、訪問情報は集めていません(GitHub Pagesはセキュリティ目的で訪問者のIPを記録します)」のような注意書きを付けるかどうか、考えてみる。
続きの課題: 第8章では、「期限を過ぎたやることを赤色に」のような改善をイシューに書いて、もう一周します。
まとめ
- GitHub Pagesは、リポジトリのウェブ用ファイルをサイトとして公開する。無料アカウントは公開リポジトリでだけ使え、サイトはいつも公開される。
- ビルドを調整する必要がなければ、ブランチから公開する。
- 事業・ネットショップ・パスワードの入力には使わない。サイズと時間の上限があり、訪問者のIPが記録される。
- デプロイは巻き戻しでは取り消せない。確認・レビュー・公開前チェックを終えてから、人が押す。
用語まとめ
| 用語 | 読み方 | 一言でいうと |
|---|---|---|
| GitHub Pages | ギットハブ・ページズ | リポジトリのファイルを無料のウェブサイトとして公開するサービス |
| Static site | スタティック・サイト | 決まったファイルをそのまま見せるサイト(静的サイト) |
| Hosting | ホスティング | サイトをインターネット上に置いておくこと |
| Bandwidth | バンドウィズ | 訪問者に送ったデータの量(帯域幅) |
この章は読み終わりましたか?
学習の記録はこのブラウザにのみ保存されます。全体の進み具合は 全体目次で確認できます。
次の章: 第8章 運用と改善
参考資料(18件)
GitHub 公式ドキュメント、「What is GitHub Pages?」。"GitHub Pages is a static site hosting service that takes HTML, CSS, and JavaScript files straight from a repository on GitHub, optionally runs the files through a build process, and publishes a website." docs.github.com (確認日 2026-11-01) ↩︎
GitHub 公式ドキュメント、「What is GitHub Pages?」。"GitHub Pages is available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server." docs.github.com (確認日 2026-11-01) ↩︎
GitHub 公式ドキュメント、「Configuring a publishing source for your GitHub Pages site」。"GitHub Pages sites are publicly available on the internet, even if the repository for the site is private (if your plan or organization allows it)." docs.github.com (確認日 2026-11-01) ↩︎
GitHub 公式ドキュメント、「Configuring a publishing source for your GitHub Pages site」。"You can publish your site when changes are pushed to a specific branch, or you can write a GitHub Actions workflow to publish your site." / "If you do not need any control over the build process for your site, we recommend that you publish your site when changes are pushed to a specific branch." docs.github.com (確認日 2026-11-01) ↩︎
GitHub 公式ドキュメント、「Configuring a publishing source for your GitHub Pages site」。"Whenever changes are pushed to the source branch, the changes in the source folder will be published to your GitHub Pages site." docs.github.com (確認日 2026-11-01) ↩︎
GitHub 公式ドキュメント、「Deploying your website automatically」。"Under "Build and deployment", from the Source dropdown, select GitHub Actions." / "From now on, every push to
mainredeploys your site with your latest changes." docs.github.com (確認日 2026-11-01) ↩︎GitHub 公式ドキュメント、「GitHub Pages limits」。"GitHub Pages is not intended for or allowed to be used as a free web-hosting service to run your online business, e-commerce site, or any other website that is primarily directed at either facilitating commercial transactions or providing commercial software as a service (SaaS)." docs.github.com (確認日 2026-11-01) ↩︎
GitHub 公式ドキュメント、「GitHub Pages limits」。"GitHub Pages sites shouldn't be used for sensitive transactions like sending passwords or credit card numbers." docs.github.com (確認日 2026-11-01) ↩︎
GitHub 公式ドキュメント、「What is GitHub Pages?」。"When a GitHub Pages site is visited, the visitor's IP address is logged and stored for security purposes, regardless of whether the visitor has signed into GitHub or not." docs.github.com (確認日 2026-11-01) ↩︎
GitHub 公式ドキュメント、「GitHub Pages limits」。"Published GitHub Pages sites may be no larger than 1 GB." docs.github.com (確認日 2026-11-01) ↩︎
GitHub 公式ドキュメント、「GitHub Pages limits」。"GitHub Pages deployments will timeout if they take longer than 10 minutes." docs.github.com (確認日 2026-11-01) ↩︎
GitHub 公式ドキュメント、「GitHub Pages limits」。"GitHub Pages sites have a soft bandwidth limit of 100 GB per month." docs.github.com (確認日 2026-11-01) ↩︎
GitHub 公式ドキュメント、「GitHub Pages limits」。"Using GitHub Pages to create a copy of an existing website as a learning exercise is not prohibited." / "you must write the code yourself, the site must not collect any user data, and you must include a prominent disclaimer on the site indicating that the project is not associated with the original and was only created for educational purposes." docs.github.com (確認日 2026-11-01) ↩︎
Claude Code 公式ドキュメント、「Checkpointing」。"Checkpoints are designed for quick, session-level recovery. For permanent version history and collaboration, continue using version control, such as Git, for commits, branches, and long-term history." code.claude.com (確認日 2026-11-01) ↩︎
Claude Code 公式ドキュメント、「How Claude Code works」。"Actions that affect remote systems (databases, APIs, deployments) can't be checkpointed. You control those with your permission mode and permission rules." code.claude.com (確認日 2026-11-01) ↩︎
Claude Code 公式ドキュメント、「Security」。"You're responsible for reviewing proposed code and commands for safety before approval." code.claude.com (確認日 2026-11-01) ↩︎
GitHub 公式ドキュメント、「Quickstart for GitHub Pages」。"Under "Build and deployment", under "Source", select Deploy from a branch." / "Note that it can take up to 10 minutes for changes to your site to publish after you push the changes to GitHub." docs.github.com (確認日 2026-11-01) ↩︎
GitHub 公式ドキュメント、「Creating a GitHub Pages site」。"GitHub Pages will look for an
index.html,index.md, orREADME.mdfile as the entry file for your site." docs.github.com (確認日 2026-11-01) ↩︎