关于状态检查
状态检查用于获知您的提交是否符合为您参与的仓库设置的条件。
本文内容
状态检查基于针对您每次向仓库的推送而运行的外部流程,例如持续集成构建。 You can see the pending, passing, or failing state of status checks next to individual commits in your pull request.
对仓库具有写入权限的任何人都可为仓库中的任何状态检查设置状态。
在仓库的分支页面或仓库的拉取请求列表中,可以查看仓库上次提交的整体状态。
如果需要对仓库进行状态检查,必须通过所需的状态检查后,您才可将分支合并到受保护分支。 更多信息请参阅“关于必要的状态检查”。
GitHub Enterprise 上的状态检查类型
GitHub Enterprise 上的状态检查有两种类型:
- 检查
- 状态
Checks are different from statuses in that they provide line annotations, more detailed messaging, and are only available for use with GitHub 应用程序s.
组织所有者和能够推送到仓库的用户可使用 GitHub Enterprise 的 API 创建检查和状态。 更多信息请参阅 GitHub 开发者文档中的“检查”和“状态”
检查
When checks are set up in a repository, pull requests have a Checks tab where you can view detailed build output from status checks and rerun failed checks.
当提交中的特定行造成检查失败时,您会在拉取请求的 Files(文件)选项卡中相关代码旁边看到有关失败、警告或通知的详细信息。
您可以使用 Conversation(对话)选项卡下的提交下拉菜单,浏览拉取请求中不同提交的检查摘要。
跳过和申请个别提交的检查
当仓库设置为自动申请检查推送时,您可以选择跳过所推送的个别提交的检查。 当仓库未设置为自动申请检查推送时,您可以申请检查您推送的个别提交。 有关这些设置的更多信息,请参阅 GitHub 开发者文档中的“检查套件”。
要跳过或申请检查提交,请在提交消息末添加以下尾行之一:
-
要跳过检查提交,请输入提交消息以及简短、有意义的更改描述。 在提交说明后,不要加上右引号,而是添加两个空行,后接
skip-checks: true
:$ git commit -m "Update README. > > skip-checks: true
-
要申请检查提交,请输入提交消息以及简短、有意义的更改描述。 在提交说明后,不要加上右引号,而是添加两个空行,后接
request-checks: true
:$ git commit -m "Refactor usability tests. > > request-checks: true