使用 GitLab/GitHub/Gerrit + Zadig 实现主干开发主干发布（含字节飞书实践）

一个完整的产品交付过程涉及到分支策略、团队的协作流程、基础设施建设等方方面面，有些团队交付效率之所以低下，往往是因为其中的某个环节出了短板，高效的协作需要结合项目所处的阶段、产品交付的频率、团队成员的习惯和素养等来制定适合自己团队的方案。

在团队日常协作过程中，选择一个合适的分支策略尤为重要，在此基础上团队角色之间的协作过程才可以被定义和执行，生产过程才能高效运转，从而产品功能才可高质量交付。

主流的分支策略有：

• 主干开发，主干发布

• 主干开发，分支发布

• 分支开发，主干发布

• GitFlow

• ...

本文主要介绍“主干开发、主干发布”分支策略在 Zadig 上的实践过程。以下实践过程主要以 Gerrit 代码源为例，其他类型代码源比如 GitLab、GitHub、Gitee 同样适用。

开发代码直接提交到主干分支，经过测试验证后，使用主干分支进行打版上线。

主干开发、主干发布

优势：

• 分支管理简单

• 开发易上手，操作简单，不易出错

• 代码合并冲突少

• 适合高频交付

  
  

成功关键点：

• 主干分支时刻保持可发布的状态，开发自测阶段/CR 过程/主干分支验证过程需要严格把控

• 未开发完成的功能代码，不能带入将要发布的版本里或者实现功能开关，将未完成的功能隐藏

本地开发&自测 -> 提交 Pull Request  到 主干分支（main） -> 代码审查 & 合并代码 -> 手动验证功能/补充自动化测试用例 ->  基于主干分支交付版本

团队协作流程

团队协作分工

早期飞书的使用场景，其中一个团队有上百个微服务，服务定义使用原生的 K8s YAML 方式，使用 Gerrit 作为代码管理和人工审核工具来实现主干开发主干发布。具体过程如下：

1.提交代码变更：修改代码，提交 MR ，生成 change-id

2.人工审查：添加/通知代码审查人；审查人可以多次 submit 审查，通过一个 transection 提交，通过审查，可以打分 -2 到 2；

3.机器审查：非阻塞式自动触发 Zadig 工作流执行验证：构建->部署->测试；

4.主干反馈：工作流跑完后会发送 IM 通知，并执行 Gerrit 打分校验结果 score +1-1

5.基于主干发布上线

上述过程 3 依赖测试环境，容易造成环境资源的浪费和审查过程等待的情况，飞书团队选择使用 Zadig Webhook 动态分配空闲环境^[1] 的能力，既可以合理利用环境资源又不阻塞机器审查过程。

服务配置提取出不同的环境变量来 区分集成环境^[2] ，根据人员的配置情况，创建 4 个同构环境，日常开发只需要提交代码并创建 Gerrit change，自动触发工作流做代码的构建部署和自动化测试。

动态分配空闲环境实践

飞书后续采用 GitLab 管理代码，关于 GitLab 的分支模型和更多实践可参考文档：字节跳动飞书为什么选择 Zadig 实现主干开发、主干发布 | 博客^[3]。

1.项目基本搭建过程

参考教程：如何使用 Gerrit + Zadig 实现产品级持续交付^[4]

2.更多配置

1. 按需创建多个环境，具体参考：配置多套环境 | Zadig 文档^[5]

2. 工作流配置 Webhook 触发器：环境的负载均衡 | Zadig 文档^[6]

3. 工作流配置 IM 通知：工作流 | Zadig 文档^[7]

4. 多个服务共享构建：构建 | Zadig 文档^[8]

开发工程师

1.代码提交并自动验证：提交代码 -> 在 Gerrit 上创建 Change  -> 自动触发 Zadig 工作流的执行（构建 -> 动态选择空闲环境进行部署 -> 自动化测试 ）

2.人工代码审查：Reviewer 使用 Gerrit 作为代码审查工具并打分，根据打分结果来判断代码是否可以合并

测试开发工程师

发布工程师

项目/企业管理人员

后续将推出更多分支策略以及团队协作流程相关实践专题文章，敬请期待...

GitHub: https://github.com/koderover/zadig，欢迎大家前来围观。

扫描以下二维码，添加 KodeRover / Zadig 小伙伴，备注 【姓名-公司-城市】，即可加入我们的「Zadig 开源吐槽群」

参考链接：

[1] https://docs.koderover.com/zadig/env/loadbalance/

[2] https://docs.koderover.com/zadig/env/multi-env/#%E6%95%B0%E6%8D%AE%E5%BA%93%E9%9A%94%E7%A6%BB

[3] https://www.koderover.com/blog/casestudy-lark/

[4] https://www.koderover.com/tutorials/codelabs/Gerrit/index.html?index=..%2F..index#0

[5] https://docs.koderover.com/zadig/env/multi-env/

[6] https://docs.koderover.com/zadig/env/loadbalance/

[7] https://docs.koderover.com/zadig/project/workflow/#im-%E7%8A%B6%E6%80%81%E9%80%9A%E7%9F%A5

[8] https://docs.koderover.com/zadig/project/build/#zadig-%E5%85%B1%E4%BA%AB%E6%9E%84%E5%BB%BA

[9] https://docs.koderover.com/zadig/project/test/

[10] https://docs.koderover.com/zadig/stat/overview/

[11] https://docs.koderover.com/zadig/stat/insight/