公開元について
変更が特定のブランチにプッシュされたときにサイトを公開できます。または、GitHub Actions ワークフローを記述してサイトを公開することもできます。 GitHub Actions を GitHub Pages の発行元として使用するには、サイト管理者が GitHub Actions を GitHub Enterprise Server に対して有効にする必要があります。 詳しくは、「GitHub Enterprise Server の GitHub Actions を有効化する」をご覧ください。
サイトのビルド プロセスを制御する必要がない場合は、変更が特定のブランチにプッシュされたときにサイトを公開することをお勧めします。 公開ソースとして使用するブランチとフォルダーを指定できます。 ソース ブランチにはリポジトリ内の任意のブランチを指定でき、ソース フォルダーにはソース ブランチのリポジトリ (/
) のルートまたはソース ブランチの /docs
フォルダーのいずれかを指定できます。 変更がソース ブランチにプッシュされるたびに、ソース フォルダー内の変更が GitHub Pages サイトに公開されます。
Jekyll 以外のビルド プロセスを使用する場合、または専用ブランチでコンパイル済みの静的ファイルを保持したくない場合は、GitHub Actions ワークフローを記述してサイトを公開することをお勧めします。 GitHub Enterprise Server には、ワークフローの記述に役立つ一般的な公開シナリオ用のワークフロー テンプレートが用意されています。
警告: サイト管理者がパブリック ページを有効にしている場合、サイトのリポジトリがプライベートまたは内部であっても、GitHub Pages サイトはインターネット上で一般公開されます。 サイトのリポジトリにセンシティブなデータがあるなら、公開前にそのデータを取り除くのが良いでしょう。 詳細については、「Enterprise 向けの GitHub Pages を設定する」および「リポジトリについて」を参照してください。
ブランチからの公開
-
公開元として使用するブランチがリポジトリ内に既に存在していることを確認します。
-
GitHub Enterprise Serverで、サイトのリポジトリにアクセスしてください。
-
リポジトリ名の下にある [設定] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウン メニューを選び、 [設定] をクリックします。
-
サイド バーの [コードと自動化] セクションで、 [ ページ] をクリックします。
-
[ビルドとデプロイ] の [ソース] で、 [ソースからのデプロイ] を選択します。
-
[ビルドとデプロイ] で、ブランチ ドロップダウン メニューを使って、公開元を選びます。
-
必要に応じて、フォルダー ドロップダウン メニューを使って公開元のフォルダを選択します。
-
[保存] をクリックします。
ブランチからの公開のトラブルシューティング
Note: If your repository contains symbolic links, you will need to publish your site using a GitHub Actions workflow. For more information about GitHub Actions, see "GitHub Actions ドキュメント."
注:
-
ブランチから公開しようとしていて、サイトが自動的に公開されていない場合は、管理者アクセス許可と検証済みの電子メール アドレスを持つユーザーが公開ソースにプッシュしていることを確認してください。
-
GITHUB_TOKEN
を使う GitHub Actions ワークフローによってプッシュされたコミットでは、GitHub Pages ビルドがトリガーされません。
公開ソースとして任意のブランチの docs
フォルダーを選択し、後でリポジトリ内のそのブランチから /docs
フォルダーを削除した場合、サイトはビルドされず、見つからない /docs
フォルダーのページ ビルド エラー メッセージが表示されます。 詳しくは、「GitHub Pages サイトの Jekyll ビルドエラーに関するトラブルシューティング」を参照してください。
カスタム GitHub Actions ワークフローによる公開
GitHub Actions を使用して公開するサイトを構成するには、次の手順を行います。
-
GitHub Enterprise Serverで、サイトのリポジトリにアクセスしてください。
-
リポジトリ名の下にある [設定] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウン メニューを選び、 [設定] をクリックします。
-
サイド バーの [コードと自動化] セクションで、 [ ページ] をクリックします。
-
[ビルドとデプロイ] の [ソース] で、 [GitHub Actions] を選びます。
-
GitHub Enterprise Server により、いくつかのワークフロー テンプレートが提案されます。 サイトを公開するワークフローが既にある場合、この手順をスキップできます。 それ以外の場合、GitHub Actions ワークフローを作成するオプションのいずれかを選択します。 カスタム ワークフローの作成に関する詳しい情報については、「サイトを公開するカスタム GitHub Actions ワークフローの作成」を参照してください。
GitHub Pages では、特定のワークフローを GitHub Pages 設定に関連付けません。 ただし、GitHub Pages 設定は、最近サイトをデプロイしたワークフロー実行にリンクされます。
サイトを公開するカスタム GitHub Actions ワークフローの作成
GitHub Actions について詳しくは、「GitHub Actions ドキュメント」をご覧ください。
GitHub Actions で発行するようにサイトを構成する場合、GitHub Enterprise Server により、一般的な公開シナリオのワークフロー テンプレートが提案されます。 ワークフローの一般的なフローは、次のとおりです。
- リポジトリの既定のブランチへのプッシュがあるたびに、またはワークフローが [Actions] タブから手動で実行されるたびに、トリガーされます。
actions/checkout
アクションを使用してリポジトリの内容をチェックアウトします。- サイトで必要な場合、静的サイト ファイルをビルドします。
actions/upload-pages-artifact
アクションを使用して静的ファイルを成果物としてアップロードします。- ワークフローが既定のブランチへのプッシュによってトリガーされた場合、
actions/deploy-pages
アクションを使用して成果物をデプロイします。 ワークフローが pull request によってトリガーされた場合、この手順はスキップされます。
ワークフロー テンプレートでは、github-pages
という名前のデプロイ環境を使用します。 github-pages
という名前の環境がリポジトリにまだ含まれていない場合、この環境は自動的に作成されます。 既定のブランチのみがこの環境にデプロイできるように、デプロイ保護ルールを追加することをお勧めします。 詳しくは、「デプロイに環境の使用」を参照してください。
カスタム GitHub Actions ワークフローによる公開のトラブルシューティング
GitHub Actions ワークフローのトラブルシューティング方法については、「ワークフローの監視とトラブルシューティング」をご覧ください。