Push Rules

Push Rules

通过使用正则表达式拒绝基于提交内容，分支名称或文件详细信息的推送，来获得对哪些内容可以推送或不能推送到存储库的额外控制.

GitLab 已经提供了 ，但是在某些情况下，您需要一些特定的规则，例如，防止删除 Git 标签或对提交消息强制采用特殊格式.

推送规则本质上是预先接收的 Git 挂钩 ，可在用户友好的界面中轻松启用. 如果您是管理员或每个项目，它们是全局定义的，因此您可以根据需要将不同的规则应用于不同的项目.

每个推送规则都可以有自己的用例，但让我们考虑一些示例.

假设您对工作流程有以下要求：

  • 每个提交都应引用 Jira 问题，例如： Refactored css. Fixes JIRA-123.
  • 用户应该无法使用git push删除 Git 标签

您需要做的就是编写一个简单的正则表达式，要求在提交消息中提及一个 Jira 问题，例如JIRA\-\d+ .

假设您公司中有严格的分支机构名称政策，并且您希望分支机构以特定名称开头，因为您有不同的 GitLab CI / CD 作业（ feature ， hotfix ， docker ， 等）依赖于分支机构名称.

但是，您的开发人员并不总是记住该策略，因此他们可能会推送到各个分支，并且 CI 管道可能无法按预期工作. 通过在推送规则中全局限制分支名称，可以防止此类错误. 与您的推送规则不匹配的任何分支名称都将被拒绝.

请注意，不管指定的分支命名正则表达式（regex）如何，始终允许使用默认分支的名称. 通过这种方式配置 GitLab，因为合并通常将默认分支作为目标. 如果您还有其他目标分支，请将其包含在正则表达式中. （请参阅 ）.

默认分支还默认为受保护分支 ，这已经限制了用户直接推送.

通过使用更高级的服务器挂钩，可以创建自定义推送规则，而不是” 管理区域”>”推送规则”中可用的推送规则 .

有关更多信息，请参见 .

  1. 导航到项目的“设置”>”存储库”，然后展开” 推送规则”
  2. 设置所需的规则
  3. 单击” 保存推送规则”以使更改生效

以下选项可用.

提示： GitLab 对推送规则中的正则表达式使用RE2 语法 ，您可以在对其进行测试 .

in GitLab Starter 8.12.

诸如凭证文件，SSH 私钥之类的机密以及其他包含机密的文件绝不应提交给源代码控制. GitLab 允许您打开文件的预定义拒绝列表，该列表将不允许被推送到存储库，从而阻止这些提交到达远程存储库.

通过选中防止向 Git 提交机密复选框，当文件与从读取的正则表达式匹配时，GitLab 会阻止将其推送到存储库（在查看此文件时，请确保您处于与 GitLab 版本相同的正确分支）.

注意：已经提交的文件将不受此推送规则的限制.