研发迭代管理 - 金融分布式架构 SOFAStack

开发者在研发迭代中完成代码提交、代码扫描、集成测试、构建、部署、提交发布等操作。

在开始软件开发之前，需要先简单了解一下迭代类型及迭代流程。一个完整的迭代流程主要包括以下三大环节：

新建迭代。以标准迭代为例，迭代创建完成后进入开发阶段。迭代创建后，可查看迭代详情。
针对迭代关联的应用，完成应用的代码提交、配置变更、新建应用服务、触发 Pipeline 等操作。
推进迭代到下一阶段。若一个迭代下有多个应用，可以通过迭代整体推进把该迭代下的所有应用推进到下一阶段。当迭代推动到发布阶段并发布成功（详见生产发布说明），迭代完成。

在迭代过程中，可以修改迭代信息，还可以废弃迭代。

迭代类型

迭代类型可根据租户需求进行定制。通常情况下，在租户初始化时会定义 2 种迭代类型：标准迭代和紧急发布。

标准迭代：主要是用于常规的开发发布。标准迭代一般包含开发阶段、集成阶段、预发阶段、发布阶段四个阶段，采用分支开发主干发布的分支策略。
紧急发布：主要用于常规发布外的紧急发布。紧急发布包含开发阶段、预发阶段、发布阶段三个阶段，采用分支开发分支发布的分支策略。

迭代类型及包含的阶段都可以在研发流程配置中修改和定义。

新建迭代

通过以下任一入口新建迭代：
- 入口 1：在 持续交付 > 工作台 > 最近参与的迭代 区域，点击 新建迭代，选择迭代类型。
- 入口 2：进入 持续交付 > 研发迭代 > 我的迭代，点击 新建迭代，选择迭代类型。
在新建迭代页面，输入以下信息：
- 迭代名称：填写迭代名称。
- 关联应用：填写涉及的应用名，其中由”独立发布”应用创建的迭代可以不关联”发布窗口”就可以直接发布；由”日常发布”应用创建的迭代必须关联”发布窗口”才能发布。若无应用可选，可新建或导入应用。
- 对应分支（当选定应用后会出现）：对应开发阶段进行研发使用的项目分支。可以自定义分支名和分支拉流使用的 Tag。
- 添加应用：添加更多应用到迭代中。
- 关联项目(选填)：关联 项目协作 中的项目。关联项目之前，确保 项目协作 组件已开通。
- 关联需求/缺陷(选填)：关联项目中的工作项。
- 迭代负责人：默认为迭代创建者，可增加其他成员。
- 迭代成员：默认为迭代创建者，可增加其他成员。

搜索迭代

从左侧导航栏进入 持续交付 > 研发迭代 > 我的迭代，即可查看迭代列表。

迭代的搜索方式包括简易搜索和高级搜索两种。

简易搜索：可根据您是否为迭代创建人、是否为迭代成员、迭代是否已经完成以及迭代名称关键字进行搜索。
高级搜索：搜索条件如下图所示。

搜索结果包括迭代 ID、迭代名称、负责人、创建时间、关联发布、发布时间、关联项目、状态、阶段。

修改迭代信息

修改基本信息

从左侧导航栏点击 持续交付 > 研发迭代 > 我的迭代，在迭代列表中，点击迭代名称进入迭代详情页面。
点击顶部导航栏上的设置标签。
在设置页面修改迭代信息、添加迭代成员、添加删除应用等。

添加应用

可通过以下任一入口新增关联应用：

在迭代详情页面，点击顶部导航栏上的当前应用名 > 添加应用。
在迭代详情页面，点击顶部导航栏上的设置图标，点击设置页面 应用管理 栏中的 添加应用。

删除应用

在迭代详情页面，点击顶部导航栏上的设置图标，点击设置页面 应用管理 栏中的删除。

查看迭代详情

研发迭代创建完成后，在迭代列表中，点击迭代名称即可进入迭代内应用的研发活动页面。

提交代码变更

开发阶段代码提交有两种方式：

集中工作流方式（Push 模式）：所有修改都直接提交到目标分支上。首先克隆仓库，然后在本地的工作副本中编辑和提交修改，修改保存在本地。当修改完成后，将本地分支的修改推送到远程仓库，推送后触发 Pipeline。
分支工作流方式（MR 模式）：该模式以集中工作流为基础，不同的是为各个新功能分配一个专门的分支来开发。这样可以在把新功能集成到正式项目前，用 MR 的方式触发 Pipeline 完成代码审核及验证工作。

在开发阶段，平台默认支持的是 Push 模式，如果要改成 MR 模式，则需要在应用元数据中设置（仅应用负责人和架构师有权限修改）。如果应用开启了 锁定项目分支，新建迭代拉流后，系统会自动锁项目分支，阻止直接 Push 代码到项目分支。

在进入集成阶段以后，平台提供的是 MR 模式，如果要修改主干代码，只能通过 MR 模式向主干提交。操作步骤如下：

在页面上方的常用操作栏中点击 提交 MR。
在新建 MR 页面，输入以下信息：
- 源分支：要发布到远程的个人开发分支。
- 目标分支：不可变更。
- 标题：输入 MR 标题。
- 描述：输入 MR 描述。
- 需要评审：若选择是，还需要填写评审人、评审通过票数。

提交配置变更

点击 配置变更。当完成配置变更后，请按需手动触发 Pipeline。

新建应用服务和申请部署资源

可通过新建或导入应用服务，申请不同研发环境的部署资源，通过手动触发 Pipeline 将最新的代码部署完成后测试。操作步骤如下：

在迭代详情页上方的常用操作栏中，点击 新建应用服务。
在新建应用服务页面，输入以下信息：
- 环境（必填）：对应代码部署环境，包括开发、集成等线下环境。
- 服务器信息（必填）：填写应用、技术栈版本等信息，选择可用服务器，然后点击新建。
  说明：
  - 如果未申请部署资源、pipeline 执行到部署组件时，会自动跳过。
  - 在 持续交付 中新建应用服务就是把 运维管理 中创建好的部署资源分配给应用的过程。
  - 如果已经在 运维管理 中完成开发、测试部署资源的创建并已分配给应用，可通过 研发环境 > 应用服务 > 导入应用服务 将应用服务和部署资源自助导入 持续交付 组件。持续交付 暂不支持创建AKS容器应用服务，只能自助导入。
  - 持续交付 组件中只能管理开发、测试等线下环境的应用服务，预发、生产等线上环境的应用服务管理请在 运维管理 组件中操作。

部署

在迭代详情页上方的常用操作栏中，点击 触发 Pipeline > 部署当前环境，即可触发编译部署 Pipeline 流水线运行。

推进迭代

阶段推进

迭代一般会配置几个阶段，以默认的标准迭代为例，有开发阶段 > 集成阶段 > 预发布阶段 > 发布阶段，通过点击操作栏中的 完成某操作阶段（如 完成开发阶段）完成阶段推进。

在迭代的推进过程中，研发效能平台会展示出当前迭代的基本信息供推进时做决策。展现的内容包括：

质量门禁（代码质量检查，如果有质量数据未达标，标红提示加签审批）。
审批（审批流程状态检查）。
质量数据展示。

阶段推进2

迭代整体推进

点击页面顶部的 迭代推进 标签，进入迭代推进视图。此视图的作用是方便迭代管理员和项目经理等角色进行迭代整体推进。如果需要单独推进某应用的阶段，请按上一章节操作。

迭代推进 视图顶部会显示迭代当前阶段。如果有多个应用，此处显示的是进度最慢的那个应用的所处阶段。

迭代推进视图展示以下内容：

应用信息列表，显示应用及所处阶段，处于当前阶段的应用阶段为蓝色，不处于当前阶段的应用阶段为灰色。默认选择全部应用，点击应用列表可切换当前的应用相关信息。
当前阶段检查的所有卡点概要信息，必须在相关阶段检查卡点都完成后才可整体推进阶段。
当前阶段检查的卡点的具体内容，包含所有待办任务、质量信息、以及其它阻塞迭代推进的事项。

当阶段检查卡点全部完成后，即可进行迭代整体推进，点击 批量推进阶段 按钮即可。迭代当前阶段下的所有应用都将会被推进到迭代的下一阶段，如当前阶段是开发阶段，此阶段的相关应用都会被推进到集成阶段。

完结和废弃迭代

当迭代推进到发布阶段并发布成功，即表示迭代完成。当有应用推进到发布阶段，迭代则不能废弃。

如果代码已经合并到了主干，那么废弃迭代之后，系统不会自动从主干扣除代码，这些代码会在下次发布时一并发布掉。所以，如果废弃迭代的同时也不需要已经合并到主干的代码，需要自行对代码进行处理。

在迭代详情页面的顶部操作栏中，点击设置 > 废弃迭代。