提交状态发布器
tip
请参阅我们的 视频指南 ，了解如何 将构建信息发送到外部系统。
访问令牌 — 使用个人访问令牌或通过 OAuth 连接获取令牌。 令牌必须具有以下范围：
对于公开仓库：
public_repo和repo:status对于私有仓库：
仓库
如果您有一个已配置的 OAuth 连接 到 GitHub，您可以点击魔术棒按钮让 TeamCity 自动获取相应的访问令牌。
GitHub 应用程序访问令牌 — 如果此项目或任何父项目具有有效的 GitHub App 连接 ，Commit Status Publisher 可以使用可刷新访问令牌。 可刷新访问令牌是由 TeamCity 通过现有的 OAuth 连接从所需的 VCS 提供程序获取的短期令牌（与用户在 VCS 托管端手动生成的静态 PAT 令牌不同）。 有关生成和使用可刷新令牌的更多信息，请参阅以下文章： 管理可刷新访问令牌。
使用 VCS 根凭据 — TeamCity 将尝试从 VCS 根设置中提取凭据。 这个选项是为使用令牌（无论是静态/个人还是可刷新/OAuth）通过身份验证并使用HTTP(S)获取URL来获取仓库的VCS根设计的。 如果相关的 VCS 根使用匿名或标准的用户名-密码认证，或者使用 SSH 获取 URL，请选择其他选项。
密码 — 提供 GitHub 用户名和密码。 请注意，如果连接到 GitHub Enterprise 存储库，或者用户的 GitHub 帐户受到两步验证保护，密码认证将无法工作。 在这些情况下，您应该使用访问令牌代替。
note
为了保护一个分支并确保只有经过验证的 pull 请求才能合并到其中，您可以在 GitHub 仓库设置中创建一个 分支保护规则。 如果您将 TeamCity 构建设置为必需的状态检查，那么在请求的更改的构建成功完成之前，GitHub 不允许合并拉取请求。
tip
如果您的 VCS 根目录使用 App Token 连接到 GitHub，您可以利用 GitHub Checks API 在无需设置 Commit Status Publisher 功能的情况下，自动发布 Markdown 格式的构建状态。 请参阅此文章获取更多信息： GitHub Checks Webhook 触发器。
使用 pull requests build feature 来配置 pull requests 分支。 您也可以通过在您的 VCS Root 中配置 分支规范 来使分支可用，同时确保它包括拉取请求分支（也可以参见相关的 博客文章）。
添加 Commit Status Publisher 构建功能：
使用默认的 所有附加的 VCS 根 选项为所有附加的 VCS 根中的提交发布状态。
选择 GitHub 作为发布者，并指定其连接详细信息和凭据，然后测试连接：
保存您的设置。
将源代码的更改提交并在 GitHub 中创建拉取请求，然后在 TeamCity 中使用您的更改运行构建。 Commit Status Publisher 将会向您通报与您的拉取请求更改相关的构建状态：
它将向您展示检查是否为：
进行中
失败
成功
将鼠标悬停在提交状态上会显示构建摘要
点击构建状态图标或 详情链接，将在 TeamCity 中打开 构建结果页面。 此信息也可在您的拉取请求详情的 提交 选项卡中找到。
与上一页面类似，单击构建状态图标会在 TeamCity UI 中打开 构建结果页面：
