推送规则限制

推送规则限制

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

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

功能介绍

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

• 指定是否只能推送自己的提交（提交邮箱必须与推送用户的注册邮箱保持一致）
• 指定提交邮箱的后缀（比如只允许企业邮箱的提交如 @gitee.com）
• 提交信息的正则验证（指定提交信息的格式，比如必须是 fix: #888 bug fixed）
• 限制单文件的大小（指定最大可提交的单文件大小，比如5M） 除此之外，还给出了特权用户的设置，可以配置仓库管理员是否受上述规则限制，覆盖一些特殊的使用场景。

1.邮箱规则配置

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

限制提交的推送者

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

指定提交邮箱的后缀

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

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

2.提交信息内容校验

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

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

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

3.限制单文件大小

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

个人版/企业免费版	企业标准版	企业高级版	企业尊享版
100MB	100MB	200MB	300MB

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

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

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

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