华为软开云4--玩转流水线

4.玩转流水线

提供可视化、可定制的自动交付流水线

1.新建和设置流水线

2.流水线执行和计划配置功能

提供可视化、可定制的自动交付流水线，帮助企业缩短交付周期，提升交付效率

产品优势

流程自定制
可按需定制流水线流程及任务，并可指定任务串行/并行执行

自动化
流水线按照用户定制的流程及任务自动执行

可视化
可随时查看流水线执行进度/结果/报告/日志

应用场景

流水线可应用于开发人员个人的日常持续构建，亦可应用于特性或者版本级持续交付

优势
分钟级交付
流水线将源码构建出包并部署发布，最快数分钟即可完成

多种触发机制
如特定分支有代码提交、定时执行、手工执行等各种流水线执行的触发方式

流水线级联
主流水线可以挂载子流水线，实现构建或者微服务依赖等复杂场景

功能描述

工作流编排
可按需定制自动化工作流程，配置阶段内任务为串行或并行执行，满足用户一键DevOps持续交付场景。

流水线并行执行
支持多流水线并行执行，并按需动态分配资源，显著提升资源利用效率及执行效率

流水线定时执行
用户可按周或按日指定流水线定时自动执行，并将结果通知给指定的用户，实现人休息而版本级交付不休息

流水线服务概述

更新时间： 2018-09-20 17:10
流水线（CloudPipeline）提供可视化、可定制的自动交付流水线，帮助企业缩短交付周期，提升交付效率。

流水线服务具有以下特性：

支持编译构建、代码检查、子流水线、部署、流水线控制五种任务类型。
流水线阶段中的任务支持串行执行与并行执行。
执行状态上报。
执行日志上报。
软件包下载。
单任务执行。
进度统计。
流水线参数化执行。
提供流水线执行历史记录。
子任务的查看功能。
流水线统计功能。
支持定时执行。
可视化自定制的自动化交付流水线。
安全可靠，资源隔离，网络隔离和安全组规则保护，远离病毒、木马骚扰，防DDoS攻击。
服务器统一维护。
支持根据业务需求进行弹性伸缩，可以根据业务需求自行定义弹性配置和策略。

功能列表

更新时间： 2018-09-20 17:10
流水线服务功能列表如表1所示。

表1 功能列表
特性
描述

流水线自定制
可根据用户项目需要，自定义流水线的阶段和任务。

流水线支持任务类型
支持编译构建、代码检查、子流水线、部署、流水线控制五种任务类型。

流水线定时自动执行
系统根据用户指定的时间，自动执行用户定义的流水线任务。

流水线任务构建包下载
用户可以选择相应任务的编译构建包下载使用。

流水线执行进度统计
统计流水线执行进度，方便用户查看执行进展。

流水线状态展示
展示整个流水线的状态，及其中任务的状态，并可查看日志和报告。

流水线执行历史
系统记录最近5次流水线的执行情况，供用户查看。

流水线消息通知
用户可根据需要设置事件类型的通知状态，包括是否发送服务动态和邮件通知。

流水线统计功能
对流水线的总数、成功率等进行统计，方便用户把握代码质量。

流水线单任务执行
根据用户需求，可选择流水线中的某一个或多个任务单独执行。

流水线任务构建日志
提供任务构建日志，便于用户查看构建的详细情况，进行问题定位及相应处理。

参数化执行流水线任务
流水线定义支持参数，在执行时由用户指定参数值，任务用指定值替换相应参数执行。

流水线任务串/并行执行
根据用户需求，可配置同一阶段内的任务串行执行或并行执行。

流水线子任务查看功能
可查看子任务的配置、执行详情。

应用场景

更新时间： 2018-09-20 17:10
流水线服务应用场景
应用：软件开发。
场景特点：软件开发中需要进行代码检查、编译打包、发布等多项活动，管理多个单独的活动比较复杂，增加管理成本。
适用场景：利用流水线技术将开发过程中的多个活动按需进行关联管理，或并行或串行，按需进行执行，提升交付效率。

快速上手流水线

更新时间： 2018-12-28 17:20
帮助用户，快速建立对流水线的整体印象。例如一家新公司，进行常规操作设置后，能够将流水线用起来。

操作流程
使用流水线编排调度执行各任务，只需三步即可快速完成流水线任务并查看结果，如图1所示

图1 快速上手流程

操作步骤
1.登录DevCloud首页，在顶部功能菜单区单击“服务 > 流水线”，进入流水线首页，如图2所示。
图2 流水线首页

2.单击“新建流水线”，添加阶段和任务，完成各项任务的编排；修改流水线参数，可关联后续任务进行参数化配置，如下图。

3.任务信息配置完成后，单击“保存”，流水线任务创建完成，进入流水线详情页面，如图3所示。
图3 流水线详情

4.单击全新执行，一键执行流水线。
执行完成后，展示执行结果，如图4所示。

图4 查看执行结果

基础操作

介绍流水线相关的基本操作：登录流水线、新建流水线、配置流水线、执行流水线和查看流水线。

登录流水线

更新时间： 2018-11-30 11:49
介绍登录流水线首页的操作步骤。

操作步骤
1.登录DevCloud首页，在顶部功能菜单区单击“服务 > 流水线”。
进入到“流水线”首页，如图1所示。

图1 流水线首页

2.查看流水线执行成功率和流水线任务个数。
3.查看与当前用户相关的流水线任务列表。
说明：
支持在搜索框中输入任务名称关键字进行搜索。

4.单击“新建流水线”可以新建流水线。
5.（可选）单击流水线名称可以查看流水线详情。
6.（可选）单击流水线归属项目名称可以进入到项目下的流水线页面。
7.（可选）在操作列可以执行、配置、复制、删除、关注流水线。

新建流水线

更新时间： 2018-11-30 11:49
介绍新建流水线的操作步骤。

操作步骤
1.登录流水线。
2.单击流水线首页“新建流水线”。
进入“新建流水线”页面，如图1所示。

说明：
流水线还可以从项目中进行创建，进入目标项目后，单击左侧导航“流水线 > 新建流水线”。

图1 新建流水线

表1 参数说明
参数项
说明

流水线名称
必选。流水线任务的名称。

归属项目
必选。选择流水线所属的项目。

说明：
归属项目下拉框中的选项为已经创建且当前用户具有权限的项目。
如果没有项目，请先新建项目。
说明：
新建流水线时可以为流水线添加阶段、为阶段添加任务、设置条件参数等。

3.设置完参数信息，单击“新建”。
进入流水线详情页面。

配置流水线

更新时间： 2018-11-30 11:49
介绍修改流水线的相关操作。

前提条件
项目经理、开发人员和创建者（项目创建者和流水线创建者）可以配置流水线。

操作步骤
1.登录流水线。
2.在流水线首页下方搜索目标流水线（如“PipelineTaks01”），单击操作列。
进入流水线配置页面，如图1所示，可根据需要修改流水线名称、为流水线添加阶段、为阶段添加任务、设置条件参数等。

图1 配置流水线

3.给流水线添加阶段。
单击，给流水线添加阶段；如果需要添加多个阶段，依次单击即可，如图2所示。

图2 添加阶段

添加阶段后，根据实际需要修改、删除阶段或继续添加阶段，操作说明如表1所示。

表1 阶段操作说明
操作项
说明

添加阶段
单击可以给流水线添加新的阶段。

修改阶段
单击，弹出“通用配置”区域，根据需要修改阶段名称、设置阶段执行方式（自动或手动）、设置任务执行模式（串行或并行），如图3所示
图3 通用配置

说明：
流水线阶段下任务的执行模式可以清晰分辨（串行或并行）。
执行方式为手动执行时，执行到该阶段时会弹出对话框，用户确认后才继续执行。默认为自动执行。

删除阶段
单击，根据删除提示确定删除阶段。

4.给流水线中的阶段添加任务。
阶段添加后，仅有一个“默认任务”；如果需要添加多个任务，请单击“添加任务”。添加好的任务显示在“任务列表”中。

任务添加后，请根据实际需要修改、删除或继续添加任务，操作说明如表2所示。

表2 任务操作说明
操作项
说明

添加任务
单击“添加任务” ，可以给流水线中的阶段添加新的任务。

插入任务
单击任务所在行的，可以在当前任务后面插入新任务。

修改任务
单击任务所在行的，弹出“任务详情”区域。

根据需要修改任务名称，选择任务类型（构建、子流水线、代码检查、部署或流水线控制）和需要调用的任务，如图4所示。

图4 任务详情

说明：
任务类型目前支持如下四种：
构建
与当前用户相关的所有编译构建任务。

子流水线
与当前用户相关的所有流水线。

子流水线只能调用一级，如果流水线任务中已经存在子流水线，则不能选择。

代码检查
与当前用户相关的所有代码检查任务。

部署
与当前用户相关的所有部署任务。

流水线控制
只有阶段为串行才能插入断点。执行到断点时会弹出对话框，用户确认后才继续执行。

请选择需要调用的任务
根据任务类型显示。如果没有选择到合适的任务，请根据界面提示进行创建。

如果调用的任务有参数，参数也会显示出来。
调用部署任务时，如果前面阶段构建任务和本阶段（串行）构建任务存在已构建的软件包，会以下拉列表形式显示。

删除任务
单击按钮，根据删除提示确定删除任务。

5.（可选）添加完流水线任务并设置好各任务后，根据需要添加流水线的执行参数。
单击“添加参数”添加执行参数；如果需要添加多个参数，继续单击“添加参数”。添加好的参数显示在“参数列表”中。单击按钮，弹出“通用配置”区域，根据需要设置参数信息，如图5所示。

图5 通用配置

说明：
“开始”名称不能修改。
在“参数列表”中设置参数名称以及默认值。
设置执行参数后，在执行流水线时，会弹出该执行参数，请根据需要设置执行参数的值。

参数类型分为字符类型、部署类型和枚举类型。
“字符类型”即普通的文本类型，用于文本类型的参数。
“部署类型”参数用于部署任务，包括“安装”、“升级”、“卸载”和“回滚”，根据需要在下拉列表中选择。
“枚举类型”参数可以自己设置参数的枚举值，多个枚举值以分号隔开，在执行和选择参数默认值的时候，该值以下拉列表的形式展示。
根据实际需要可以添加多个执行参数。
当参数在流水线执行时不需要动态修改，可以指定为静态参数。
6.设置完流水线各项操作后，单击“保存”。
进入“流水线”详情页面。

7.（可选）单击流水线名称链接，可以查看流水线。

执行流水线

更新时间： 2018-11-30 11:49
介绍执行流水线的操作步骤。

前提条件
流水线已建立并具有权限。
创建者、项目经理和开发人员可以执行流水线。

操作步骤
1.登录流水线。
2.在流水线首页下方搜索目标流水线。
3.将鼠标移至流水线所在行的，显示“开始执行”，单击弹出确认提示框，请根据需要确认阶段启动执行。
此时，“开始执行”按钮由“正在启动”显示为“停止执行”，执行完成后，恢复为“开始执行”。

说明：
单击“开始执行”按钮，如果流水线设置了执行参数，会弹出“设定参数并执行”提示框，根据需要设置执行参数值并确认阶段。

4.（可选）在执行过程中，单击“停止执行”按钮。
弹出确认停止执行提示框，单击“确定”。

5.（可选）查看流水线相关信息。
流水线相关信息如表1所示。

表1 流水线信息
参数项
说明

创建者
流水线的创建人。

归属项目
流水线所属的项目。单击归属项目的名称链接，可以进入到项目中的流水线页面。

最近执行时间
最近一次执行流水线的时间。

执行状态
有三种状态：
灰色
流水线从未执行或上一次执行被中止
绿色
上一次执行成功
红色
上一次执行失败

流程
流水线的阶段。

6.（可选）查看流水线详情。
单击流水线名称，进入流水线详情页面，可配置流水线、复制流水线、删除流水线、设置通知事件和设置执行计划等。

查看流水线

更新时间： 2018-11-30 11:49
介绍流水线详情页面的相关操作，包括查看仓库信息、日志、历史，下载软件包等。还可以执行流水线、配置流水线、复制流水线、删除流水线、设置通知事件和执行计划。

操作步骤
1.登录流水线。
在首页可以查看与当前用户相关的流水线。

2.输入名称关键字搜索目标流水线，单击流水线名称。
进入流水线详情页面，可以查看流水线任务基本信息、执行流水线、选择执行任务、查看仓库信息、下载软件包、查看日志等，如图1所示。

图1 任务详情

任务详情页面相关操作如表1所示。

表1 任务详情页面操作说明
操作项
说明

全新执行
执行新版本流水线。

继续执行
继续执行当前版本流水线。

下载
单击任务所在行的可以下载对应构建包，支持通过手机扫描下载构建包。
说明：
只有“构建”类型的任务才有下载按钮。
如果构建包有多个，则会显示“下载全部”，可以根据需要下载全部构建包。

查看仓库信息
单击任务所在行的可以查看仓库信息。

查看日志
单击任务所在行的可以查看对应日志。
说明：
只有“构建”和“部署”类型的任务才有查看日志按钮。

选择执行阶段/任务
单击阶段/任务所在区域的可以选择需要执行的阶段/任务。选中的阶段/任务才执行，不选中的阶段/任务不执行。

3.单击任务名称旁边的下拉菜单，可以查看最近5次历史执行记录。
说明：
用户可以重新执行流水线历史任务。

4.单击右上角“权限”，可以配置成员权限。
5.单击右上角“配置”可以配置流水线。
6.单击右上角“复制”可以复制该流水线。
7.单击右上角“删除”，弹出删除确认提示框。请根据实际情况确认删除。
说明：
项目经理或创建者（项目创建者和流水线创建者）可以删除流水线。

8.单击右上角“通知”。
设置事件类型的通知状态，包括是否发送服务动态与邮件通知，请根据实际情况单击（表示已开启）/（表示未开启）进行设置，如图2所示。

图2 消息通知

说明：
默认服务动态通知都发送，邮件通知都不发送。

9.单击右上角“计划”。
进入“流水线定时执行”页面，可以根据实际情况设置执行计划。

执行计划类型分为：

手工执行
即不设置定时时间，根据实际情况进行手动构建。

每日定时执行
设置每天的某一时间进行定时构建，格式为HH:MM，如每天八点，则填写08:00。

每周定时执行
设置每周某天的某一时间进行定时构建。构建日期为周一至周日，选中构建日期（如“周一”）后，再填写构建时间，“HH:MM”（如“08:00”）。

权限管理

更新时间： 2018-11-30 11:49
介绍流水线权限管理相关操作。

1.单击流水线名称，进入“流水线详情”页面，如图1所示。
图1 流水线详情

2.单击右上角“权限”，进入流水线权限-角色权限配置页面，如图2所示。
单击（表示有权限）/ （表示没权限），可以控制用户权限，即指定用户对流水线的操作（查看、执行、修改、删除）。
图2 角色权限

切换到 “人员权限配置”页签，可以单独为某个用户设置权限，如图3所示。
图3 人员权限配置

说明：
项目创建者、流水线创建者和项目经理权限不能更改。
人员权限优先于角色权限。

如何配置执行参数

更新时间： 2018-11-30 11:49
通过配置执行参数，用户可以根据自定义的条件参数执行任务，目前主要分为两种：编译构建参数和流水线参数

说明：
配置执行参数后，在执行构建任务时，会弹出执行参数，可根据需要为参数赋值，否则使用参数默认值。
执行参数引用形式为ParameterName，如{ParameterName}，如ParameterName，如{Branch}，其中“Branch”为已经添加的执行参数名。

编译构建参数
构建任务参数目前主要应用于两个场景：指定分支和配置构建包信息。

场景一指定分支
1.进入构建任务“参数设置”页面，单击“添加执行参数”，默认为分支信息添加“codeBranch”参数，并设置好默认值，如图1所示。
图1 添加执行参数

2.在“源码选择”页面将“分支”信息配置成引用参数形式，如图2所示。
图2 配置引用参数

说明：
其中“codeBranch”为第一步已经添加的执行参数，且需与参数名保持一致。

3.构建任务时根据需要为执行参数赋值，自定义构建不同分支，如图3所示。
图3 自定义分支信息

说明：
执行参数值默认为添加参数时为参数设置的默认值，可根据需要进行修改。

场景二配置构建包信息
1.进入构建任务“参数设置”页面，单击“添加执行参数”，为构建包信息添加参数并设置好默认值，如图4所示。
图4 添加执行参数

2.在“构建步骤”页面，添加“上传软件到发布仓”步骤，将相应构建包信息（如：版本号）配置成引用参数形式，如图5所示。
图5 配置引用参数

说明：
其中“Version”为第一步已经添加的执行参数，且需与参数名保持一致。

3.构建任务时根据需要为执行参数赋值，自定义构建包信息，如图6所示。
图6 自定义构建包信息

说明：
执行参数值默认为添加参数时为参数设置的默认值，可根据需要进行修改。

流水线参数
流水线的参数，主要用于子任务，以构建任务为例。
1.进入流水线配置页面，单击“开始”节点所在区的进入通用配置页面，单击“添加参数”，为流水线添加参数并设置好默认值，如图4所示。
图7 添加执行参数

说明：
流水线参数分为字符类型、部署类型和枚举类型。
“字符类型”即普通的文本类型，用于文本类型的参数。
“部署类型”参数用于部署任务，可通过下拉列表选择默认值。
“枚举类型”可以自己设置参数的枚举值，多个枚举值以分号隔开，在执行和选择参数默认值的时候，该值以下拉列表的形式展示。
当参数在流水线执行时不需要动态修改，可以指定为静态参数。
2.单击任务所在行的，进入任务详情页面，并将任务参数配置成引用参数形式，如图8所示。
图8 配置引用参数

说明：
其中“Param_1”为第一步已经添加的参数，且需与参数名保持一致。

3.执行流水线时根据需要为执行参数赋值，自定义构建子任务信息，如图9所示。
图9 自定义子任务信息

说明：
执行参数值默认为添加参数时为参数设置的默认值，可根据需要进行修改。

Web项目 on DevCloud（流水线）

更新时间： 2018-12-28 17:20
背景信息
通过一个简单的研发场景，讲解DevCloud的各模块功能，操作在项目各生命周期中的应用，帮助大家了解Java项目如何在DevCloud上面运行。

本章主要介绍DevCloud流水线的配置和使用。

操作过程
具体操作请参见视频指导
Java on DevCloud-8：流水线

项目经理抱怨：要加班很晚部署项目
解放运维的力量