kiwicom/plzrebase

plzrebase镜像说明

镜像概述

plzrebase是针对GitLab CI设计的工具镜像，核心作用是监控代码分支的同步状态。当当前分支相对于指定基准分支落后过多时，会在CI流水线中返回失败结果，提示开发者及时进行分支合并或重base操作。

核心功能

1. 检测当前分支与基准分支的提交差距，超出阈值则触发失败
2. 支持自定义允许的最大落后提交数（默认50）
3. 可配置排除特定前缀的分支（如release、dev）
4. 集成Slack通知，可将提醒发送至指定频道

使用场景

适用于GitLab CI/CD流水线，可作为独立阶段加入构建或测试流程前，有效减少因分支长期脱节导致的合并冲突风险，提升团队协作效率。

配置说明

需在GitLab项目中设置以下Secret Variables：

• PLZREBASE_THRESHOLD：允许的最大落后提交数，默认值50
• PLZREBASE_BRANCH_TO_COMPARE：基准对比分支，默认值master
• PLZREBASE_BRANCH_PREFIX_EXCLUDE：需排除的分支前缀（逗号分隔，例如release,dev）
• PLZREBASE_SLACK_WEBHOOK_URL：Slack入站webhook地址
• PLZREBASE_SLACK_CHANNEL：通知发送的Slack频道，默认使用webhook配置的频道

部署示例

以下是GitLab CI配置中使用该镜像的示例：

yaml
stages:
  - build
  - test
  # ... 其他阶段

build:
  stage: build
  # ... 构建步骤配置

plzrebase:
  stage: build
  image: kiwicom/plzrebase
  script:
    - plzrebase