跳到主要内容

推送规则限制

推送规则限制

在研发管理流程中,建立一定的共识已经成为业界的标准实践,建立共识的好处就是减少沟通成本,固化团队的一些行为方式,让团队更加专注于业务的开发而不必在研发过程中花费过多的精力,降低团队的认知负荷。

基于以上的一些考量,Gitee 推出了推送规则限制功能,帮助团队在提交规范化上更加精进,减少人工介入的成本,通过推送规则的配置,团队可以灵活的配置符合团队文化的一些硬性限制,比如提交信息的格式、提交邮箱以及单文件大小的限制等等。

功能介绍

推送规则设置能够限制仓库提交的的一些属性,使整个提交更加规范化,易于管理,目前推送规则设置包含以下几个维度:

  • 指定是否只能推送自己的提交(提交邮箱必须与推送用户的注册邮箱保持一致)

  • 指定提交邮箱的后缀(比如只允许企业邮箱的提交如 @gitee.com)

  • 提交信息的正则验证(指定提交信息的格式,比如必须是 fix: #888 bug fixed

  • 限制单文件的大小(指定最大可提交的单文件大小,比如5M) 除此之外,还给出了特权用户的设置,可以配置仓库管理员是否受上述规则限制,覆盖一些特殊的使用场景。

    1.邮箱规则配置

邮箱规则设置主要有两种:只能推送自己的提交以及指定提交邮箱的后缀规则。

限制提交的推送者

勾选了只能推送自己的提交将会开启这个限制,开启之后,用户所推送的提交只能是自己的提交,判定是否是自己的提交的方式是提取提交的邮箱,然后与推送者的注册邮箱进行比对,如果一致则认为是推送者自己的提交,反之则不是,将会被拒绝:

指定提交邮箱的后缀

在一些公司的研发管理流程中,规定提交者必须使用公司的邮箱进行提交,一方面是可以很好的进行提交信息的统一,与公司内部的系统进行统一标准化,方便进行度量统计;另一方面是可以在一定程度上声明所提交的代码是公司的资产。

勾选了只允许指定邮箱域名后缀的提交将会开启这个限制,开启之后,用户所推送的提交必须是以指定的邮箱后缀为结尾,实例中给出的配置就必须以@gitee.com为结尾,如zoker@gitee.comadmin@gitee.com等。如果用户使用了非指定后缀的邮箱进行了提交,在推送的时候将会被拒绝:

2.提交信息内容校验

在开启提交信息内容校验后,可以根据自己需要配置对应的正则表达式,并且可以在表单后进行正则的验证。

如果您不知道如何选择合适的提交信息正则作为自己的团队规范,我们也提供了一些开源社区常用的正则表达式,您可以点击常用正则表达式推荐展开,然后点击使用选择对应的正则表达式:

输入图片说明

配置完成后,如果有不符合提交正则的提交存在,推送将会被拒绝:

3.限制单文件大小

在开启限制大文件大小选项之后,您需要指定仓库所允许的单文件的最大限制,需要注意的是,这个限制不能超过仓库所属配额的大小:

个人版/企业免费版企业标准版企业高级版企业尊享版
100MB100MB200MB300MB

配置完成后,如果提交中包含超过限制的文件,推送将会被拒绝:

输入图片说明

4.仓库管理员不受规则限制

如果勾选了仓库管理员不受上述规则限制,那么仓库的管理员角色推送的提交将会 跳过上述所有的检测 ,一般只有在特殊情况下才会开启使用。

匹配优先级 推送规则的配置将会严格按照设置从上到下的方式进行验证,并且如果一次推送中包含多个提交,有一个提交不符合规则,那么本次推送的提交将全部被拒绝。