我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们

此版本的 GitHub Enterprise 已停止服务 2021-03-02. 即使针对重大安全问题,也不会发布补丁。 要获得更好的性能、改进的安全性和新功能,请升级到 GitHub Enterprise 的最新版本。 如需升级方面的帮助,请联系 GitHub Enterprise 支持

关于状态检查

状态检查用于获知您的提交是否符合为您参与的仓库设置的条件。

本文内容

状态检查基于针对您每次向仓库的推送而运行的外部流程,例如持续集成构建。 您可以在拉取请求的个别提交旁边看到状态检查的待处理通过失败状态。

提交和状态列表

对仓库具有写入权限的任何人都可为仓库中的任何状态检查设置状态。

在仓库的分支页面或仓库的拉取请求列表中,可以查看仓库上次提交的整体状态。

如果需要对仓库进行状态检查,必须通过所需的状态检查后,您才可将分支合并到受保护分支。 更多信息请参阅“关于受保护分支”。

GitHub Enterprise Server 上的状态检查类型

GitHub Enterprise Server 上的状态检查有两种类型:

  • 检查
  • 状态

检查状态的不同之处在于它们提供行注解、更详细的信息,并且只适用于 GitHub 应用程序。

组织所有者和能够推送到仓库的用户可使用 GitHub Enterprise Server 的 API 创建检查和状态。 更多信息请参阅“检查”和“状态”。

检查

在仓库中设置检查时,拉取请求会有一个 Checks(检查)选项卡,从中可以查看状态检查的详细构建输出和重新运行失败的检查。

拉取请求中的状态检查

当提交中的特定行造成检查失败时,您会在拉取请求的 Files(文件)选项卡中相关代码旁边看到有关失败、警告或通知的详细信息。

状态检查详细信息

您可以使用 Conversation(对话)选项卡下的提交下拉菜单,浏览拉取请求中不同提交的检查摘要。

下拉菜单中不同提交的检查摘要

跳过和申请个别提交的检查

当仓库设置为自动申请检查推送时,您可以选择跳过所推送的个别提交的检查。 当仓库设置为自动申请检查推送时,您可以申请检查您推送的个别提交。 有关这些设置的更多信息,请参阅“检查套件”。

要跳过或申请检查提交,请在提交消息末添加以下尾行之一:

  • 跳过检查提交,请输入提交消息以及简短、有意义的更改描述。 在提交说明后,不要加上右引号,而是添加两个空行,后接 skip-checks: true
    $ git commit -m "Update README.
    >
    >
    skip-checks: true
    • 申请检查提交,请输入提交消息以及简短、有意义的更改描述。 在提交说明后,不要加上右引号,而是添加两个空行,后接 request-checks: true
      $ git commit -m "Refactor usability tests.
      >
      >
      request-checks: true