ドキュメントには頻繁に更新が加えられ、その都度公開されています。本ページの翻訳はまだ未完成な部分があることをご了承ください。最新の情報については、英語のドキュメンテーションをご参照ください。本ページの翻訳に問題がある場合はこちらまでご連絡ください。

GitHub PagesサイトのJekyllビルドエラーについて

ローカルで、またはGitHub上でGitHub Pagesサイトをビルド中にJekyllでエラーが発生した場合には、詳細情報を伴うエラーメッセージが示されます。

GitHub Pages は、GitHub Free のパブリックリポジトリ、GitHub Pro のパブリックおよびプライベートリポジトリ、GitHub Team、GitHub Enterprise Cloud、GitHub Enterprise Server で利用いただけます。詳細は「GitHub の製品」を参照してください。

ここには以下の内容があります:

Jekyllのビルドエラーについて

サイトの公開元に変更をプッシュした後で、GitHub Pagesがサイトのビルドを試行しない場合があります。

  • 変更をプッシュしたユーザーがメールアドレスを検証していない。 詳しい情報については、「メールアドレスの検証」を参照してください。
  • デプロイキーでプッシュしている。 サイトのリポジトリへのプッシュを自動化する場合は、かわりにマシンユーザーを設定できます。 詳細は GitHub 開発者ドキュメンテーション にある「デプロイキーを管理する」を参照してください。
  • 公開元をビルドするようにCIサービスを設定していない。 たとえば、Travis CIはgh-pagesブランチを、セーフリストに追加しない限りビルドしません。 詳細は、Travis CIまたはCIサービスのドキュメンテーションで、「ビルドのカスタマイズ」を参照してください。

メモ: サイトに対する変更は、その変更をGitHubにプッシュしてから公開されるまでに、最大20分かかることがあります。

Jekyllがサイトのビルドを試行せず、エラーが発生した場合は、ビルドエラーメッセージが表示されます。 Jekyll ビルドエラーメッセージには主に 2 つのタイプがあります。

  • 「Page build warning」メッセージは、ビルドは成功したものの、今後問題が生じないようにするために変更を行なう必要がある可能性が存在することを意味します。
  • 「Page build failed」メッセージは、ビルドが完了できなかったことを意味します。 Jekyll が失敗の理由を検出できた場合、説明を含むエラーメッセージが表示されます。

ビルドエラーのトラブルシューティングに関する詳しい情報については、「GitHub Pages サイトの Jekyll ビルドエラーのトラブルシューティング」を参照してください。

Jekyll ビルドエラーメッセージを表示する

サイトのテストをローカルで行なうことをお勧めします。それにより、ビルドエラーメッセージをコマンドラインで表示でき、変更を GitHub にプッシュする前に、あらゆるビルドエラーに対処できます。 詳しい情報については、「Jekyll を使用して GitHub Pages サイトをローカルでテストする」を参照してください。

GitHub サイトの公開元を更新するためプルリクエストを作成すると、そのプルリクエストの [Checks] タブでビルドエラーメッセージが表示されます。 詳しい情報についてはステータスチェックについてを参照してください。

GitHub の公開元に変更をプッシュする際、GitHub Pages はサイトのビルドを試みます。 ビルドが失敗すると、プライマリメールアドレスにメールが送信されます。 また、ビルドの警告についてのメールも送信されます。

GitHub 上のビルドの失敗については、サイトのリポジトリの、[Settings] タブに表示されます。(ただし、ビルドの警告については表示されません。)

各コミット後にエラーメッセージを表示するように、Travis CI などのサードパーティサービスを設定できます。

  1. 公開元のルートに、以下の内容で Gemfile と呼ばれるファイルをまだ追加していない場合は、追加します。

    source `https:/rubygems.org`
    gem `github-pages`
    
  2. 選択したテストサービス用にサイトのリポジトリを設定します。 例えば、Travis CI を利用するには、以下の内容の .travis.yml ファイルを、公開元のルートに追加します。

    language: ruby
    rvm:
      - 2.3
    script: "bundle exec jekyll build"
    
  3. サードパーティのテストサービス内で、リポジトリを有効にする必要があるかもしれません。 詳しい情報については、お使いのテストサービスのドキュメンテーションを参照してください。

担当者にお尋ねください

探しているものが見つからなかったでしょうか?

弊社にお問い合わせください