Question

文档版本信息

属性	内容
文档名称	代码集成最佳实践
文档编号	001
文档版本	V0.1
版本日期	2020/02/07
文档状态	外部发布
制作人
审阅人

文档变更记录

版本编号	日期	作者	审核人	说明
V1.0	2020-02-07

---

法律声明

阿里云提醒您在阅读或使用本文档之前仔细阅读、充分理解本法律声明各条款的内容。如果您阅读或使用本文档，您的阅读或使用行为将被视为对本声明全部内容的认可。

1. 您应当通过阿里云网站或阿里云提供的其他授权通道下载、获取本文档，且仅能用于自身的合法合规的业务活动。本文档的内容视为阿里云的保密信息，您应当严格遵守保密义务；未经阿里云事先书面同意，您不得向任何第三方披露本手册内容或提供给任何第三方使用。
2. 未经阿里云事先书面许可，任何单位、公司或个人不得擅自摘抄、翻译、复制本文档内容的部分或全部，不得以任何方式或途径进行传播和宣传。
3. 由于产品版本升级、调整或其他原因，本文档内容有可能变更。阿里云保留在没有任何通知或者提示下对本文档的内容进行修改的权利，并在阿里云授权通道中不时发布更新后的用户文档。您应当实时关注用户文档的版本变更并通过阿里云授权渠道下载、获取最新版的用户文档。
4. 本文档仅作为用户使用阿里云产品及服务的参考性指引，阿里云以产品及服务的“现状”、“有缺陷”和“当前功能”的状态提供本文档。阿里云在现有技术的基础上尽最大努力提供相应的介绍及操作指引，但阿里云在此明确声明对本文档内容的准确性、完整性、适用性、可靠性等不作任何明示或暗示的保证。任何单位、公司或个人因为下载、使用或信赖本文档而发生任何差错或经济损失的，阿里云不承担任何法律责任。在任何情况下，阿里云均不对任何间接性、后果性、惩戒性、偶然性、特殊性或刑罚性的损害，包括用户使用或信赖本文档而遭受的利润损失，承担责任（即使阿里云已被告知该等损失的可能性）。
5. 阿里云文档中所有内容，包括但不限于图片、架构设计、页面布局、文字描述，均由阿里云和/或其关联公司依法拥有其知识产权，包括但不限于商标权、专利权、著作权、商业秘密等。非经阿里云和/或其关联公司书面同意，任何人不得擅自使用、修改、复制、公开传播、改变、散布、发行或公开发表阿里云网站、产品程序或内容。此外，未经阿里云事先书面同意，任何人不得为了任何营销、广告、促销或其他目的使用、公布或复制阿里云的名称（包括但不限于单独为或以组合形式包含“阿里云”、“Aliyun”、“万网”等阿里云和/或其关联公司品牌，上述品牌的附属标志及图案或任何类似公司名称、商号、商标、产品或服务名称、域名、图案标示、标志、标识或通过特定描述使第三方能够识别阿里云和/或其关联公司）。
6. 如若发现本文档存在任何错误，请与阿里云取得直接联系。

---

本文针对云效平台的三种集成场景进行了介绍，三者的难度从简易到高阶分别是：

• 一个集成环境，需求顺序集成
• 一个集成环境，需求合并集成
• 多个集成环境，按需集成

---

云效平台代码集成模块的最佳使用实践，可帮助客户解决开发测试完成后，不清楚下一步该“做什么”及“怎么做”的问题。

• 【一个集成环境，需求顺序集成】场景：适用于敏捷开发模式，追求需求的快速交付和吞吐量。
• 【一个集成环境，需求合并集成】场景：除可用于敏捷开发模式外，同样适用于传统的研发模式，按版本发布，将开发验证的需求都提交到待集成列表，再统一按版本集成交付。
• 【多个集成环境，按需集成】场景：适用面更加广阔，特别适合那些项目大、周期长的项目。若开发分支长期游离于主干，仅在最后集成，会带来大量的冲突和问题。但是，倘若大型项目每周、每月按需集成一次，更能保证项目的稳定健康。

【适用场景】

• 传统的瀑布研发模式
• 基于微服务的敏捷研发模式
• 远程多地协同的研发模式

【方案架构】

多项目集成时，同一集成区块（一次提交集成，生成一个集成区块）内相同应用的代码会自动合并。最佳实践流程仍是每个需求（开发任务）逐个进集成，逐个出集成，流程示意图如下：

【方案优势】

• 支持传统大项目（周期长）研发场景
• 支持敏捷项目研发场景
• 支持高并发多分支研发场景

---

在执行本文操作前，请完成以下准备工作：

• 所在公司已购买并开通云效项目管理、需求管理产品模块。
• 已注册云效账号并完成认证，可以登录云效平台。
• 完成云效产品培训并通过相关考试。
• 加入云效的钉钉答疑群（联系本公司云效接口负责人入群）。
• 项目可以进入集成环节。

---

• 本方案使用 Chrome 浏览器，需提前准备。
• 安装钉钉或企业微信。

---

5.1 一个集成环境，需求顺序集成

测试通过后，建议整个需求开发项目统一提交集成。使用一套集成环境，便于管理维护和节省成本，用自动化回归验证，来提高集成环境使用效率和吞吐量，云效平台支持一键操作。集成启动后，整个集成流水线会自动执行。初始使用云效时，推荐这种简单易用模式。

提交集成后， 直接使用默认的立即集成，不要选择【提交待集成】。 点击确定后，集成流水线便开始启动运行：拉发布集成代码 > 与主干冲突检查 > 编译构建 > 部署环境 > 调用自动化测试用例 > 手工验证卡点；集成通过后可以发布，最后一键代码合回主干。

5.2 一个集成环境，需求合并集成

该场景较为复杂，但所有的复杂操作均由平台后台实现，操作步骤与第一个场景类似。区别在于：需要把合并需求的项目都提交到待集成，而非立即集成，如下图： 点击确定后，可在提交待集成信息列表中查看到记录。对于需要合并集成的项目（需求），此处提供二次选择待合并集成的项目（需求）的功能。勾选项目后，点击提交集成按钮即可。 后续流程同前一场景，其他操作均在云效平台后台自动完成。

5.3 多个集成环境，按需集成

操作步骤与前两个场景类似。区别在于：无需整个项目提交集成，而是可以按需选择需要集成的应用，进行集成。例如，可以按照代码更改量、业务变化幅度、时间（周/月）等选择应用进行集成，提前发现解决代码或业务冲突。 多集成环境时，集成时可选择环境。 后续流程同场景一，云效平台后台会自动处理。

流水线