更新时间:2025-07-24 GMT+08:00

配置项目级仓库设置

约束与限制

当用户角色为“项目经理”或者“项目管理员”,可以设置项目级仓库设置,权限配置请参考配置项目级的Repo权限

配置仓库设置

如果用户想对项目下的所有仓库设置相同的仓库设置,用户在代码托管首页,进入项目,选择“设置” > “仓库管理” > “仓库设置”。参见表格表1填写参数。

表1 仓库设置参数说明

参数

说明

取值样例

开启强制继承

非必填参数。如果勾选此参数,本项目下的所有代码组和代码仓库均使用以下参数的设置,且代码组和仓库下设置不可更改,请谨慎选择。

勾选“开启强制继承”

禁止Fork仓

非必填参数。勾选此选项,表示任何人不可以Fork该项目下的代码仓库。

勾选“禁止Fork仓”。配置此参数后,进入该项目下任意仓库,单击右上角“Fork”按钮,右上角弹框禁止fork。

MR预合并

非必填参数。勾选此选项,表示启用MR预合,服务端会自动生成MR预合并的代码,相比客户端使用命令做预合并操作更高效简洁、构建结果更准确,适用于对构建实时性要求严格的场景。

勾选“MR预合并”,使用示例请参考使用示例

分支名规则

非必填参数。填写规则后,所有分支名都必须匹配正则表达式,分支名规则不能超过500个字符。如果此字段不填写,则允许任何分支名。需要满足基本的Tag命名规则:

  • 不能超过500个字符。
  • 不支持以 - . refs/heads/ refs/remotes/ 开头,不支持空格 [ \ < ~ ^ : ? * ! ( ) ' " | 等特殊字符,不支持以. / .lock结尾。
  • 不能与已有分支或者Tag名重复。

“Branch_[a-zA-Z0-9_]+”,表示项目下所有分支名会以“Branch_”开头,可以匹配任意字符序列的字符串,包含大写或小写字母、数字或下划线。

Tag名规则

非必填参数。所有Tag名都必须匹配正则表达式。如果此字段不填写,则允许任何Tag名。需满足基本的Tag命名规则:

  • 不能超过500个字符。
  • 不支持以 - . refs/heads/ refs/remotes/ 开头,不支持空格 [ \ < ~ ^ : ? * ! ( ) ' " | 等特殊字符,不支持以. / .lock结尾。
  • 不能与已有分支或者Tag名重复。

“Tag_[a-zA-Z0-9_]+”,表示Tag名应该以“Tag_”开头,可以匹配任意字符序列的字符串,包含大写或小写字母、数字或下划线。

相关文档

  • 如果开发在新建分支时,报错“分支Test_Branch不匹配正则Branch_”,表示新建的分支名“Test_Branch”不符合匹配规则“Branch_”,请选择“设置” > “仓库管理” > “仓库设置”,查看最新的分支名匹配规则,根据匹配规则新建分支。
  • 如果开发在新建Tag时,报错“tag Test_Tag不匹配正则Tag_”,表示新建的Tag名“Test_Tag”不符合匹配规则“Tag_”,请选择“设置” > “仓库管理” > “仓库设置”,查看最新的Tag名匹配规则,根据匹配规则新建Tag。