ステータスチェックは、リポジトリにプッシュをするたびに実行される継続的インテグレーションのビルドのような、外部のプロセスに基づいています。 pull request 中の個々のコミットの隣に、ステータスチェックの pending、passing、failing などのステータスが表示されます。
書き込み権限があるユーザまたはインテグレーションなら誰でも、リポジトリのステータスチェックを任意のステータスに設定できます。
ブランチへの最後のコミットの全体的なステータスは、リポジトリのブランチページあるいはリポジトリのプルリクエストのリストで見ることができます。
リポジトリでステータスチェックが要求されているなら、必� �のステータスチェックをパスしてからでないと保護されたブランチにあなたのブランチはマージできません。 詳細については、「保護されたブランチについて」を参照してく� さい。
GitHub Enterprise Serverでのステータスチェックの種類
GitHub Enterprise Server のステータスチェックには 2 種類あります。
- チェック
- ステータス
チェック は、行のアノテーション、より詳細なメッセージを提供するという点で ステータス とは異なっており、GitHub App でのみ利用できます。
Organization オーナー、およびリポジトリにプッシュアクセスを持つユーザは、GitHub Enterprise Server の API でチェックおよびステータスを作成できます。 詳細については、「チェック」と「ステータス」を参照してく� さい。
チェック
リポジトリで チェック がセットアップされている� �合、pull request には [チェック] タブがあり、そこからステータスチェックからの詳細なビルドのアウトプットを見て、失敗したチェックを再実行できます。
注釈: リポジトリの 状態 ではなく、チェック を設定した� �合にのみ、 [チェック] タブに pull request が設定されます。
コミットの特定の行でチェックが失敗している� �合、その失敗、警告、注意に関する詳細が pull request の [ファイル] タブの関連するコードの横に表示されます。
[会話] タブの下のコミットドロップダウンメニューを使って、pull request 中のさまざまなコミットのチェックのサマリー間を行き来できます。
個々のコミットに関するチェックのスキップとリクエスト
リポジトリがプッシュに対して自動的にチェックをリクエストするように設定されている� �合、プッシュする個々のコミットについてチェックをスキップできます。 リポジトリがプッシュに対して自動的にチェックをリクエストするよう設定されて いない � �合、プッシュする個々のコミットについてチェックをリクエストできます。 これらの設定の詳細については、「チェックスイート」を参照してく� さい。
コミットに対するチェックをスキップもしくはリクエストするには、以下の追� 行のいずれかをコミットメッセージの末尾に追� します:
- コミットの チェックをスキップ には、コミットメッセージと変更の短く意味のある説明を入力してく� さい。 コミットの説明の後、終了引用符の前に、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"