配置分支保护

本页介绍了如何为 Secure Source Manager 代码库配置分支保护。

通过分支保护，代码库管理员可以设置规则来控制哪些人可以更改分支、哪些人需要批准或审核更改，以及在批准的更改可以合并到分支之前必须满足哪些条件。

如需详细了解分支保护规则，请参阅分支保护概览。

准备工作

  1. 创建 Secure Source Manager 实例。
  2. 创建 Secure Source Manager 代码库。

所需的角色

如需获得为 Secure Source Manager 代码库配置分支保护规则所需的权限，请让管理员向您授予以下 IAM 角色：

如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

如需了解如何授予 Secure Source Manager 角色，请参阅使用 IAM 进行访问权限控制和向用户授予实例访问权限。

创建分支保护规则

如需创建新的分支保护规则，请执行以下操作：

  1. 在 Secure Source Manager 网页界面中，选择要使用分支保护规则保护的代码库。
  2. 在代码库页面中，点击设置。
  3. 点击分支规则标签页。
  4. 点击添加分支规则。

  5. 在分支规则 ID 字段中，输入分支规则的名称。

    分支规则 ID 只能包含小写字母、数字和连字符。第一个字符必须是字母，最后一个字符必须是字母或数字。分支规则 ID 的长度上限为 63 个字符。

  6. 在分支过滤器字段中，输入您希望规则应用到的分支的名称；如果您希望规则应用到所有分支，请输入 .*。不支持完整的正则表达式匹配。

    已启用的分支规则过滤器必须在相应代码库中保持唯一。用户可以拥有多个已停用的分支规则过滤条件。例如，您不能在单个代码库中拥有两个启用了分支规则且分支过滤条件为 main 的分支规则。

    如果多个规则适用于某个分支，则以特定分支名称作为分支过滤条件的分支规则会替换通配符规则。例如，具有分支过滤条件 main 的分支规则会替换具有分支过滤条件 .* 的分支规则。规则不会合并。

  7. 在分支保护规则详情部分中，从以下选项中指定分支规则的要求：

    • 在合并之前需要拉取请求：如果启用，则会阻止直接向分支提交内容。必须先打开拉取请求，然后才能合并到受保护的分支。

    • 所需审核者数量：指定合并拉取请求所需的审核者批准数量。

    • 所需的审批人数量：指定合并拉取请求所需的审批人数量。

      审核者和审批者是具有特定 IAM 角色的用户。如需了解审核者和审批者所需的角色，请参阅分支保护概览。

    • 阻止合并过时的审核和审批：如果启用此选项，则在授予审核或审批权限后，如果向拉取请求推送了新的提交，则会移除相应审核或审批。

    • 在合并之前要求解决对话：如果启用此选项，则必须先解决所有代码注释和更改请求审核，然后才能进行合并。

    • 需要线性历史记录：如果启用，则无法合并会创建非线性 Git 历史记录的拉取请求。

    • 需要进行状态检查：如果启用此选项，必须成功完成所选的 build 状态检查，然后才能合并 pull 请求。您必须先在触发器文件中配置触发器，然后才能选择它们作为分支保护的状态检查。

  8. 如需保存分支规则，请点击提交。

系统会显示“分支规则”标签页，其中列出了您新建的分支规则。

修改分支保护规则

如需修改分支保护规则，请执行以下操作：

  1. 在 Secure Source Manager 网页界面中，选择包含要修改的分支保护规则的代码库。
  2. 在代码库页面中，点击设置。
  3. 点击分支规则标签页。
  4. 点击要修改的分支规则的名称。
  5. 修改分支保护规则。
  6. 点击更新。

分支保护规则已更新。

删除分支保护规则

如需删除分支保护规则，请执行以下操作：

  1. 在 Secure Source Manager 网页界面中，选择要移除分支规则的代码库。
  2. 在代码库页面中，点击设置。
  3. 点击分支规则标签页。
  4. 在要删除的规则所在的行中，点击删除图标 删除。
  5. 在移除分支规则确认界面中，点击是。

分支保护规则已删除。

后续步骤