はしくれエンジニアもどきのメモ

情報系技術・哲学・デザインなどの勉強メモ・備忘録です。

Github Pagesの作成・設定・制限メモ

Github Pagesの作成・設定・制限メモ

2016年から使い方が更新されて制限も変わっていたようなのでメモ.

Github Pagesについて公式の説明は以下のページにある.

pages.github.com

特徴としては,一部制限があるが,

Github Pages の種類

以下の2種類がある.

  • User or organization site : よくhttps://<username>.github.io/でアクセスできるページ

  • Project site : repository に作ったページはこっちになる.urlはhttps://<username>.github.io/<repository>/

各サイトの作り方は,GitHub Pages | Websites for you and your projects, hosted directly from your GitHub repository. Just edit, push, and your changes are live.に載っている.

User siteの作り方

  1. Github上で <username>.github.io の名前でリポジトリを作る.
  2. 作業場所にgit cloneする.
    git clone https://github.com/<username>/<username>.github.io
  3. htmlファイルを作る
  4. pushする.
    git add --all
    git commit -m "Initial commit"
    git push -u origin master
  5. https://[username].github.io でアクセスできる.

User siteはmaster branch上で作れる.

Project siteの作り方

好きな名前のリポジトリを作ったら基本的にUser siteと同じ流れになる. 違いは設定が必要になる.

master branchまたはリポジトリ内のdocフォルダをsite化する場合:

  1. リポジトリページから「Repository Settings」を開く.
    「Repository Settings」を開く.
  2. [Source]を設定する.
    • master branchの場合,origin/masterを選択する.
    • docを使っている場合,その下/docを選択する.
    [Source]を設定する

gh-pages のブランチを切る場合:こちらにもpushする.この方法は2015年時に使用されていた.

Github Pagesをhttps対応

master branchまたはリポジトリ内のdocフォルダをsite化した場合,デフォルトでhttps対応になっている.

対応してない場合,[Enforce HTTPS]を有効にすればhttps対応になる.

https対応

独自ドメインを設定

使いたい独自ドメイン名を設定する.

独自ドメインを設定

設定できると your site is published at ... と表示される.

ドメイン管理側では, こちらの記事のようにGithub Pagesで使用しているDNSサーバのIPアドレスを設定する.

cartman0.hatenablog.com

DNSサーバのIPアドレスManaging a custom domain for your GitHub Pages site - GitHub Docsで記されている以下を設定する.

  • 185.199.108.153
  • 185.199.109.153
  • 185.199.110.153
  • 185.199.111.153

例えば,freenomの場合,以下のように設定することになる.

例:freenom

実際に独自ドメインを設定してみたページはこちら

https://hashikure.tk/

Github Pagesの制限

こちらのページに記されている.

help.github.com

- GitHub Pages source repositories have a recommended limit of 1GB .
- Published GitHub Pages sites may be no larger than 1 GB.
- GitHub Pages sites have a soft bandwidth limit of 100GB per month.
- GitHub Pages sites have a soft limit of 10 builds per hour.

容量は1GB以下に使用し,通信量100GB/月,つまりPV数が多い場合はだめで, 更新(push)は10/h回内にする(頻繁な更新運用はできない).