通过

为外部服务配置分支策略

  • 项目

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

分支策略是一项强大的功能，可通过对所有拉取请求建立要求来确保存储库中的高质量代码。 外部服务可以使用 PR 状态 API 将详细状态发布到 PR。 外部服务的分支策略为这些第三方服务提供了参与 PR 工作流和建立策略要求的能力。 本文将指导你完成为发布 PR 状态的服务配置分支策略的过程。 有关 PR 状态的详细信息，请参阅使用拉取请求状态自定义和扩展拉取请求工作流。

先决条件

  • Azure DevOps 中具有 Git 存储库的组织。 如果没有组织，请注册以在无限制的免费专用 Git 存储库中上传和共享代码。
  • 将状态发布到 PR 的服务。 请参阅创建拉取请求状态服务器。

配置分支策略

  1. 导航至“代码”>“分支”，找到要对其配置策略的分支（通常为 main 或 develop）。 在上下文菜单中，选择“分支策略”选项。

    从上下文菜单中选择“分支策略”

  2. 向下滚动以查找“状态检查”。 选择 + 按钮。

    选择“添加策略”按钮

  3. 从列表中选择要为其创建策略的服务。 如果之前已发布状态，则可以从列表中选取它；如果这是新策略，则可以键入策略的名称。

    从列表中选择策略

    • “策略要求”确定此策略是可选的策略还是必需的策略以完成向分支的拉取请求。
    • “授权标识”用于强制指定只有指定标识中的状态才会计入策略履行。
    • “重置条件”用于确定已发布状态何时不再有效。 如果发布的状态特定于最新代码（即生成），选中“发生新的更改时重置状态”以在源分支更改时重置状态。
    • （可选）设置一个路径筛选器。 详细了解分支策略中的路径筛选器。
    • 策略适用性确定此策略是在创建拉取请求后立即应用，还是仅在第一个状态发布到拉取请求后应用。
    • 通过默认显示名称，可指定策略的可选显示名称。

创建新的拉取请求

  1. 向在其中定义策略的分支创建新的拉取请求。 有关详细信息，请参阅创建拉取请求。

  2. 创建 PR 后，新策略将显示在“PR 详细信息”视图的“策略”部分中。 最初，在外部服务发布状态之前，策略将显示为“未设置”。

    策略状态显示在“策略”部分

    当服务已发布状态时，策略将相应地更新。 在策略批准 PR 之前，完成将被阻止。

    策略状态更新

    满足策略条件且服务发布 succeeded 状态时，PR 将得到批准并且完成将被取消阻止。

    策略状态已批准且完成已取消阻止

摘要

本文介绍了如何为外部服务配置分支策略。