ステータスチェックは、リポジトリにプッシュをするたびに実行される継続的インテグレーションのビルドのような、外部のプロセスに基づいています。 プルリクエスト中の個々のコミットの隣に、 pending、passing、 failing などの、ステータスチェックのステータスが表示されます。
書き込み権限があるユーザまたはインテグレーションなら誰でも、リポジトリのステータスチェックを任意のステータスに設定できます。
ブランチへの最後のコミットの全体的なステータスは、リポジトリのブランチページあるいはリポジトリのプルリクエストのリストで見ることができます。
リポジトリでステータスチェックが要求されているなら、必須のステータスチェックをパスしてからでないと保護されたブランチにあなたのブランチはマージできません。 詳しい情報については必須のステータスチェックについてを参照してください。
GitHub Enterpriseでのステータスチェックの種類
GitHub Enterprise のステータスチェックには 2 種類あります。
- チェック
- ステータス
チェックは、行のアノテーション、より詳細なメッセージを提供するという点でステータスとは異なっており、GitHub App でのみ利用できます。
Organization オーナー、およびリポジトリにプッシュアクセスを持つユーザは、GitHub Enterprise の API でチェックおよびステータスを作成できます。 詳しい情報については、「チェック」および「 ステータス」を参照してください。
チェック
リポジトリでチェックが設定されている場合、プルリクエストには [Checks] タブがあり、そこからステータスチェックからの詳細なビルドの出力を表示して、失敗したチェックを再実行できます。
コミットの特定の行でチェックが失敗している場合、その失敗、警告、注意に関する詳細がプルリクエストの [Files] タブの関連するコードの横に表示されます。
[Conversation] タブの下のコミットドロップダウンメニューを使って、プルリクエスト中のさまざまなコミットのチェックのサマリー間を行き来できます。
個々のコミットに関するチェックのスキップとリクエスト
リポジトリがプッシュに対して自動的にチェックをリクエストするように設定されている場合、プッシュする個々のコミットについてチェックをスキップできます。 リポジトリがプッシュに対して自動的にチェックをリクエストするよう設定されていない場合、プッシュする個々のコミットについてチェックをリクエストできます。 これらの設定についての詳しい情報は、「チェックスイート」を参照してください。
コミットに対するチェックをスキップもしくはリクエストするには、以下の追加行のいずれかをコミットメッセージの末尾に追加します:
- コミットのチェックをスキップには、コミットメッセージと変更の短く意味のある説明を入力してください。 コミットの説明の後に、閉じる引用符の代わりに 2 つの空の行を追加し、その後に
skip-checks: true
と続けます。$ git commit -m "Update README. > > skip-checks: true
- コミットのチェックをリクエストするには、コミットメッセージと変更の短く意味のある説明を入力してください。 コミットの説明の後に、閉じる引用符の代わりに 2 つの空の行を追加し、その後に
request-checks: true
と続けます:$ git commit -m "Refactor usability tests. > > request-checks: true
- コミットのチェックをリクエストするには、コミットメッセージと変更の短く意味のある説明を入力してください。 コミットの説明の後に、閉じる引用符の代わりに 2 つの空の行を追加し、その後に