代码所有者
代码所有者机制需配合保护分支功能一起使用。在代码仓库中放置声明文件 CODEOWNERS
后,就可以声明此仓库内代码文件的所有者,通常为项目负责人。
当合并请求的目标分支为保护分支,且在请求中的改动文件涉及到声明文件中设定的路径或文件,合并请求详情中将列出对应的所有者与他们的评审状态。当文件路径中存在多个所有者时,各所有者均会受邀参与评审,其中任一位所有者通过代码评审即可。
如上图所示:CODEOWNER
文件内声明了 charts/repos/**
路径内文件的所有者是小 A 和 小 B。若针对保护分支提交了合并请求且涉及到 chars/repos/
路径下的文件变动将自动添加小 A 和 小 B 为此请求的评审者,其中一人通过评审即可。
亦支持使用持续集成插件自动添加评审者,点击了解详情。
在「保护分支」设置中勾选开启代码所有者评审后,管辖范围的代码变动需通过代码所有者的评审后方能合并。
声明文件地址
代码所有者的声明文件 CODEOWNERS
默认从以下位置逐层检索,文件名必须是大写格式,找到一个后就会停止搜寻。
- 根目录
-
docs/
目录
声明文件格式参考
声明文件是一个普通的文本文件,空行与 #
开始的行会被忽略,每行的格式为:
pattern email email email ...
pattern
指定了一个文件路径模式。email 为所有者邮箱,可以填写多个所有者,以空格分隔。
示例文件:
# 声明所有后缀名是 js 的文件
*.js yourname@coding.net
# 声明仓库根目录下 build/logs/ 目录内的文件(包括子目录)
/build/logs/ yourname@coding.net
# 声明所有 docs/ 文件夹内的文件(不包括子目录)
docs/* yourname@coding.net
# 声明所有根目录下 docs/ 文件夹内的文件(包括子目录)
/docs/ yourname@coding.net
问题反馈 >
2023-10-25最近更新
感谢反馈有用
感谢反馈没用
在阅读中是否遇到以下问题?*
您希望我们如何改进?*
如果您希望得到回复,请留下您的邮箱地址。