更新时间:2024-06-28 GMT+08:00

变更与流水线

微服务中,用户可以创建流水线资源,并将其设置为变更流水线,用于与微服务下变更资源进行联动。与普通流水线相比,变更流水线具有以下特点:

  • 单个微服务下仅允许存在一条基于变更触发的流水线。
  • 变更流水线基于变更触发,运行时会自动创建集成分支,并在运行成功后将集成分支内容合并至主干分支。
  • 变更流水线运行成功后会自动更新发布的变更状态。
  • 变更流水线仅支持单实例运行。
  • 变更流水线不支持事件触发或定时任务触发。

新建变更流水线

  1. 进入微服务
  2. 在微服务列表页单击微服务名称,进入微服务“概览”页面。
  3. 切换到“流水线”页签,进入微服务流水线列表页面。
  4. 单击“新建流水线”,进入“新建流水线 ”页面,填写基本信息,相关参数说明如表1所示。
    表1 参数说明

    参数项

    说明

    所属项目

    微服务所属项目,不可修改。

    名称

    流水线的名称,默认根据当前时间生成。

    代码源

    微服务下流水线仅支持Repo代码源。

    代码仓

    微服务关联的代码仓库,不可修改。

    默认分支

    微服务关联的默认分支,不可修改。

    Repo HTTPS授权

    配置授权扩展点以提升代码库操作权限,主要用于微服务变更流水线和部分仓库操作插件。

    别名

    输入别名,则会生成该仓库对应的相关系统参数(可在参数设置页面查看),否则不会生成。

    基于变更触发

    开启“基于变更触发”开关的流水线即为变更流水线,在微服务流水线列表中,变更流水线会被标识为

    说明:

    单个微服务下仅允许存在一条基于变更触发的流水线。

    描述

    流水线的描述。

  5. 填写完所有参数,单击“下一步”,进入“选择模板”页面,请根据需要选择对应模板,在模板基础上快速新建任务;也可以选择“空白模板”,即不使用模板,直接新建。
  6. 选择模板后,单击“确定”,然后单击“保存”。

执行变更流水线

  1. 进入微服务
  2. 在微服务列表页单击微服务名称,进入微服务“概览”页面。
  3. 切换到“流水线”页签,进入微服务下流水线列表页面。
  4. 找到变更流水线,单击流水线名称,进入流水线“执行历史”页面。
  5. 单击右上角“执行”,弹出“执行配置”侧滑框,进行如下配置。

    • 变更列表:变更列表展示阶段状态为“待发布”和“发布中”的变更,运行变更流水线时需要选择一个或多个变更。
    • 运行参数配置:如果流水线配置了运行时参数,请根据需要设置参数值并保存,可参考参数使用
    • 执行阶段配置:流水线支持选择任务执行,可以选择一个或多个,默认执行全部任务。
    • 执行描述:填写本次运行的调试信息。
  6. 配置完成后,单击“执行”,进入变更流水线执行详情页面。

    变更流水线运行时会默认添加“合并集成分支”和“合并主干”阶段。

    • 合并集成分支:变更流水线会自动从主干分支拉出一条新分支,并将本次运行变更的所有特性分支集成到该新分支,然后通过这条集成分支来运行流水线。
    • 合并主干:将集成分支合并回主干分支。

查看执行结果

执行完成后,可查看流水线执行结果。

变更流水线执行成功时,会将本次运行选择的所有变更状态改为“已发布”状态。

  • 单击流水线名称,进入“流水线详情”页面
    • 单击流水线源卡片的“查看更多”,弹出运行变更侧滑框,展示本次流水线运行时选择的变更信息。
    • 单击列表内“变更标题”可以跳转到变更详情页面。
  • 单击“发布列表”页签,切换到“发布列表”页面
    • 发布列表页面展示所有阶段状态为“待发布”和“发布中”的变更。
    • 列表支持在搜索栏中输入变更名称关键字进行搜索。
    • 单击“操作”列,弹出“退出发布”对话框,单击“确认”会将变更退出变更流水线的发布列表,变更状态重置为“开发中”。

    阶段状态为“发布中”的变更,如果变更流水线正在运行,则需要等待变更流水线运行完成或停止变更流水线后才可以退出发布。