BizWorks支持新增自定义流水线和添加三方流水线。在部署应用时,如果您可以找到满足条件的自定义流水线,则将无法使用默认流水线;如果您未找到满足条件的自定义流水线,则仍然可以使用默认流水线部署应用。本文介绍如何新增和管理中心应用自定义流水线,以及如何添加和管理中心应用的三方流水线。
前提条件
添加三方流水线的前提条件如下:
有可用的三方流水线连接。具体操作,请参见创建和管理三方流水线连接配置。
已经创建BizWorks可用的三方流水线。具体操作,请参见(云效公有云版本)创建基于代码部署的流水线。
新增自定义流水线
登录BizWorks,在选择平台下拉列表中选中微服务开发平台。
单击页面右上角图标或其文本框区域,在下拉列表中单击目标项目名称后,单击应用页签。在应用列表页面单击目标中心应用名称。
在目标中心应用左侧导航栏中,选择 。
在流水线管理页面的自定义流水线页签,单击新增自定义流水线。
在新增自定义流水线面板,完成流水线名称和流水线源(支持代码和镜像)设置,填写描述(选填)。
完成后单击保存。
保存成功后,您可以在自定义流水线页签查看所新增的自定义流水线。
说明新增自定义流水线的启用/停用开关默认为启用。
运行自定义流水线
在流水线管理页面的自定义流水线页签,单击目标自定义流水线右侧操作列下的立即运行。
在运行目标流水线配置面板,选择目标应用版本和代码分支,设置Commit ID(非必填,不填写时,使用分支的最新版本)后,单击开始运行。
重要当目标自定义流水线中存在部署步骤时,您不能直接运行该自定义流水线。
可选:查看运行记录。
在流水线管理页面的自定义流水线页签,单击目标自定义流水线右侧操作列下的查看运行记录。
在运行记录详情页面,您可以单击目标运行记录ID右侧操作列下的详情或日志。
在部署记录详情面板或流水线运行记录查看运行记录详情。
设计自定义流水线
在流水线管理页面的自定义流水线页签,单击目标自定义流水线右侧操作列下的设计流水线。
在目标自定义流水线设计器画布中,您可以参考以下步骤添加任务。
在目标位置单击图标。
说明您可以添加阶段节点的任务,或在阶段节点内添加任务。
在添加任务面板,如果您选择编译构建。
重要如果在新建自定义流水线步骤,流水线源选择镜像,则在添加任务对话框中,没有编译构建选项。关于如何新建自定义流水线,请参见新增自定义流水线。
在编辑构建面板,您可以修改任务名称和描述。
单击添加步骤,在添加面板,选择目标任务(支持NPM构建、Yam构建、Maven构建和制作镜像并推送至项目的镜像仓库)后,单击确定。
添加任务步骤后的图片示例如下。您可以对任务步骤中的相关参数进行修改或配置,例如,修改步骤名称、镜像名称和镜像Tag等。
相关参数说明请参见下表。
参数
说明
步骤名称
四种不同类型的任务步骤的步骤名称分别默认为:NPM构建、Yam构建、Maven构建、制作镜像并推送至项目的镜像仓库。
编码
默认生成,且不支持修改。
镜像名称
默认的镜像名称规则为:项目编码-应用编码-组件编码。
支持变量以占位符的方式使用,例如,${变量名}/1234。
镜像Tag
默认的镜像Tag为:年月日时分秒。
支持变量以占位符的方式使用,例如,${变量名}/1234。
工作目录
在此目录下执行
docker build
。支持变量以占位符的方式使用,例如,${变量名}/1234。
Dockerfile路径
支持变量以占位符的方式使用,例如,${变量名}/1234。
在添加任务面板,如果您选择部署。
在部署面板,您可以修改任务名称(默认为部署)和描述(默认为将制品部署到目标环境)。
单击添加步骤,您可以修改步骤名称(默认为部署到目标环境)、目标部署环境类型设置,在部署镜像下拉列表中,选择目标部署镜像。
重要一个流水线中最多只能有一个部署到目标环境的步骤。
在部署镜像下拉列表中如果不存在可选项,您需要先在编辑构建任务里添加制作镜像并推送至项目的镜像仓库任务步骤。具体操作,请参见添加任务。
单击确定。
在添加任务面板,如果您选择流水线控制。
在流水线控制面板,您可以修改任务名称(默认为流水线控制)和描述(默认为增加人工审批等控制)。
选择审批方式,支持会签和或签。
说明会签:需要所有人审批同意。
或签:只需一名审批人同意或拒绝即可。
选择审批人范围,支持指定成员和指定角色。
说明指定成员,可选择如下角色的成员:企业管理员、当前项目的项目负责人、当前应用的应用负责人、应用开发、应用运维。
指定角色,可选择如下角色:企业管理员、当前项目的项目负责人、当前应用的应用负责人、应用开发、应用运维。
在审批人下拉列表,选择目标审批人(支持多选)。
设置审批界面业务信息说明,准备一个默认的业务信息说明,通过变量方式设置审批页中的业务描述内容。
单击确定。
在添加任务面板,如果您选择执行命令。
在执行命令面板,您可以修改任务名称(默认为执行命令)和描述(默认为执行Shell命令等进行功能扩展)。
单击添加步骤,在执行Shell命令区域,您可以修改步骤名称(默认为执行Shell命令),在命令文本框中输入命令。
重要命令中您可以使用
${变量名}
的方式使用变量,变量会以占位符的方式在流水线运行时自动替换,例如:cd ${WORKDIR}
。流水线实例的最长运行时间为1天,超时后实例状态将会为失败。
在流水线实例运行日志会记录执行命令和执行结果,请谨慎使用敏感信息。
单击确定。
新增变量(自定义变量)。
单击流水线设计器页面左上角新增变量。
在新增变量对话框中,设置变量名称、默认值(选填)、描述(选填)和运行时设置。
说明如果您选中运行时设置,在部署中心应用实例时,选择自定义流水线后,则能够显示需要赋值的自定义变量,并且自定义变量的记录能够在实例操作记录、实例详情中出现,且能够参与到回滚中。
更多信息,请参见部署中心应用实例。
单击创建。
在流水线变量区域,您可以查看所创建的自定义变量。
您可以单击目标变量右侧图标、图标或图标,编辑、复制或删除自定义变量。
可选:编辑或删除目标任务节点。单击流水线中的目标任务节点后,单击图标或图标,编辑或删除该节点信息。
可选:编辑或删除目标阶段节点。单击流水线中的目标阶段节点的图标或图标,编辑或删除该阶段节点信息。
说明流水线源和代码准备阶段节点不支持编辑和删除。
完成流水线设计后,单击保存。
修改自定义流水线基础信息
在流水线管理页面的自定义流水线页签,单击目标自定义流水线右侧操作列下的 。
在修改基础信息面板,完成修改流水线名称和描述信息后,单击保存。
复制自定义流水线
在流水线管理页面的自定义流水线页签,选择目标自定义流水线右侧操作列下的 。
在复制面板,设置流水线名称,填写描述(选填),完成后单击保存。
删除自定义流水线
在流水线管理页面的自定义流水线页签,选择目标自定义流水线右侧操作列下的 。
删除后将无法在部署应用时使用该流水线。
添加三方流水线
在流水线管理页面的三方流水线页签,单击添加三方流水线。
在添加第三方流水线面板,完成相关参数设置。
在选择三方流水线连接配置下拉列表:
如果您选择添加三方流水线连接配置(页面会自动跳转至运维导航栏中的三方流水线集成页面),后续操作步骤,请参见创建和管理三方流水线连接配置。
如果您选择的目标流水线连接配置类型为阿里云云效或Jenkins。
单击选择流水线,在选择流水线对话框的流水线ID列表中选中目标流水线ID,单击确定。
如果您选择的目标流水线连接配置类型为阿里云大禹,您还需在选择应用下拉列表中选择目标应用。
单击选择流水线,在选择流水线对话框的流水线ID列表中选中目标流水线ID,单击确定。
设置使用此流水线的目标部署环境类型,填写流水线描述(非必填)。
使用此流水线的目标部署环境类型包括:测试环境、开发环境、预发环境、生成环境。
单击创建。
添加完成后,您可以在三方流水线管理页面查看所添加的流水线。
编辑三方流水线
在流水线管理页面的三方流水线页签,单击目标流水线名称或目标流水线名称右侧操作列下的编辑。
在编辑第三方流水线面板,完成相关配置项修改后,单击保存。
删除三方流水线
在流水线管理页面的三方流水线页签,单击目标流水线名称右侧操作列下的删除。
删除后将无法在部署应用时使用该流水线。
查看默认流水线的运行记录
在流水线管理页面的自定义流水线页签,单击目标自定义流水线右侧操作列下的查看运行记录。
在运行记录详情页面,您可以单击目标运行记录ID右侧操作列下的详情或日志。
在部署记录详情面板或流水线运行记录查看运行记录详情。
复制默认流水线为自定义流水线
在流水线管理页面的默认流水线页签,单击目标流水线名称右侧操作列下的复制为自定义流水线。
在复制为自定义流水线面板,完成相关配置项设置后,单击保存。
启用或停用默认流水线
在流水线管理页面的默认流水线页签,单击目标流水线名称右侧启用/停用列下的启停开关,启用或停用默认流水线。
查看镜像列表信息
在流水线管理页面,单击页面右上角的镜像列表。
在镜像列表详情页面,查看镜像列表信息。
该页面记录了流水线生成的应用镜像信息。您需要在设计自定义流水线时,在编辑构建任务里添加制作镜像并推送至项目的镜像仓库任务步骤才能保存相应镜像信息。具体操作,请参见添加任务。
说明镜像列表页面支持展示自定义流水线和默认流水线生成的镜像信息。