持续集成

流水线（CloudPipeline）提供可视化、可定制的持续交付流水线服务，实现缩短交付周期和提升交付质量的效果。

持续集成

前提条件

基于代码库部署：对应构建的应用已经创建了代码库。由于流水线中会涉及到部署，所以对应的镜像仓库和容器云集群等资源也需要提前开通。

基于镜像部署：需要开通镜像仓库和容器云集群资源。

流水线开通

初次使用流水线产品需要经过开通。点击立即开通，跳转应用市场购买开通。

流水线管理

流水线现在支持java和npm的构建及部署。

新增流水线

可以通过已有模版配置相应的任务（流水线），支持设置缓存、清除缓存，设置触发规则，自定义环境变量。

基本信息：选择应用、任务模版。

流水线配置：配置流水线任务，命名流水线。

缓存配置：选择缓存目录。

基于JAVA要勾选Maven、Gradle，基于Npm要勾选Npm。（流水线构建失败时，可以尝试重置缓存，重新运行流水线）

触发规则：目前支持两种触发规则

1.代码触发（仓库管理员）：勾选“代码更新时自动执行”

复制流水线绑定的应用

在代码托管页面搜索应用

选中WebHooks

当可以看见Push、TagPush、PullRequest三个事件时，“代码更新时自动执行”功能开启。

2.定时触发

点击添加，用户根据需求自定义定时规则。

环境变量：环境变量可以添加在任务配置中，使任务配置参数化。备注：要以${PIPLINE_ID}格式。

自定义环境变量设置以后，可以在当前流水线的多个任务配置中写入，用以设置相同的参数。可在新建流水线时，在所有任务中配置环境变量，也可以在已有的流水线配置中编辑更改环境变量。

环境变量示例

1.添加自定义环境变量

2.在任务中添加环境变量

3.运行后通过“执行变量”可查看添加的环境变量

自定义脚本构建流水线任务

在任务管理处，可以新增自定义任务。

在源码处编写groovy语法的脚本，以实现该任务的功能，其中参数化的部分可以使用环境变量（默认大写），也可以自定义参数。点击右侧的（识别代码中的参数）按钮可以获取所有的参数并在下方控件区域显示。

同时针对这些参数，可以在下方编辑不同的控件展示和效验方法。

“编码”与“container”对应的字段一致；

“镜像”里要包含命令里脚本运行需要的环境；

“镜像”来源于镜像仓库。

“源码”说明

例1:

container('maven') {
try{
 result = sh returnStdout: true ,script: 'curl -X POST  -H "X-Auth-Token: ${userToken}" -H "X-Auth-Project: ${PROJECT_ID}" -H "Content-Type: application/json" -H "Authorization: $GATEWAY_TOKEN" -d  "{\\"pipRecordId\\":\\"$PIP_RECORD_ID\\",\\"stageUid\\":\\"${STAGE_UID}\\" ,\\"taskUid\\":\\"${TASK_UID}\\" ,\\"status\\":\\"IN_PROGRESS\\"}"  ${GW_URL}/paas-pipeline/project/v1/pipeline/status'
        code = new JsonSlurper().parseText(result).code
 if(code != "0"){ 
  throw new Exception("failed");
 }
        sh '''${param1}'''
 result = sh returnStdout: true ,script: 'curl -X POST  -H "X-Auth-Token: ${userToken}" -H "X-Auth-Project: ${PROJECT_ID}" -H "Content-Type: application/json" -H "Authorization: $GATEWAY_TOKEN" -d  "{\\"pipRecordId\\":\\"$PIP_RECORD_ID\\",\\"stageUid\\":\\"${STAGE_UID}\\" ,\\"taskUid\\":\\"${TASK_UID}\\" ,\\"status\\":\\"SUCCESS\\"}"  ${GW_URL}/paas-pipeline/project/v1/pipeline/status'
        code = new JsonSlurper().parseText(result).code
 if(code != "0"){ 
  throw new Exception("failed");
 }
}catch(ex){
 echo "errMsg:"+ex
 result = sh returnStdout: true ,script: 'curl -X POST  -H "X-Auth-Token: ${userToken}" -H "X-Auth-Project: ${PROJECT_ID}" -H "Content-Type: application/json" -H "Authorization: $GATEWAY_TOKEN" -d  "{\\"pipRecordId\\":\\"$PIP_RECORD_ID\\",\\"stageUid\\":\\"${STAGE_UID}\\" ,\\"taskUid\\":\\"${TASK_UID}\\" ,\\"status\\":\\"FAILED\\"}"  ${GW_URL}/paas-pipeline/project/v1/pipeline/status'
 code = new JsonSlurper().parseText(result).code
 if(code != "0"){ 
  throw new Exception("failed");
 }
 throw ex
}
}

例2:

container('node') {
try{
 result = sh returnStdout: true ,script: 'curl -X POST  -H "X-Auth-Token: ${userToken}" -H "X-Auth-Project: ${PROJECT_ID}" -H "Content-Type: application/json" -H "Authorization: $GATEWAY_TOKEN" -d  "{\\"pipRecordId\\":\\"$PIP_RECORD_ID\\",\\"stageUid\\":\\"${STAGE_UID}\\" ,\\"taskUid\\":\\"${TASK_UID}\\" ,\\"status\\":\\"IN_PROGRESS\\"}"  ${GW_URL}/paas-pipeline/project/v1/pipeline/status'
       code = new JsonSlurper().parseText(result).code
 if(code != "0"){ 
  throw new Exception("failed");
 }
        sh '''cp /home/jenkins/agent/caches/${TENANT_CODE}/${PROJECT_CODE}/${DEPLOYMENT_CODE}/.npm/.npmrc /root
 echo "node_modules/" > .npmignore
 ${param1}'''
 result = sh returnStdout: true ,script: 'curl -X POST  -H "X-Auth-Token: ${userToken}" -H "X-Auth-Project: ${PROJECT_ID}" -H "Content-Type: application/json" -H "Authorization: $GATEWAY_TOKEN" -d  "{\\"pipRecordId\\":\\"$PIP_RECORD_ID\\",\\"stageUid\\":\\"${STAGE_UID}\\" ,\\"taskUid\\":\\"${TASK_UID}\\" ,\\"status\\":\\"SUCCESS\\"}"  ${GW_URL}/paas-pipeline/project/v1/pipeline/status'
        code = new JsonSlurper().parseText(result).code
 if(code != "0"){ 
  throw new Exception("failed");
 }
}catch(ex){
 echo "errMsg:"+ex
 result = sh returnStdout: true ,script: 'curl -X POST  -H "X-Auth-Token: ${userToken}" -H "X-Auth-Project: ${PROJECT_ID}" -H "Content-Type: application/json" -H "Authorization: $GATEWAY_TOKEN" -d  "{\\"pipRecordId\\":\\"$PIP_RECORD_ID\\",\\"stageUid\\":\\"${STAGE_UID}\\" ,\\"taskUid\\":\\"${TASK_UID}\\" ,\\"status\\":\\"FAILED\\"}"  ${GW_URL}/paas-pipeline/project/v1/pipeline/status'
 code = new JsonSlurper().parseText(result).code
 if(code != "0"){ 
  throw new Exception("failed");
 }
 throw ex
}
}

groovy脚本内容说明

如上，sh''' ''' 中的内容为用户自定义编写内容（如例2中的sh '''cp /home/jenkins/agent/caches/${TENANT_CODE}/${PROJECT_CODE}/${DEPLOYMENT_CODE}/.npm/.npmrc /root echo "node_modules/" > .npmignore ${param1}'''）
container('node') { try{ result = sh returnStdout: true ,script: 'curl -X POST -H "X-Auth-Token: ${userToken}" -H "X-Auth-Project: ${PROJECT_ID}" -H "Content-Type: application/json" -H "Authorization: $GATEWAY_TOKEN" -d "{\"pipRecordId\":\"$PIP_RECORD_ID\",\"stageUid\":\"${STAGE_UID}\" ,\"taskUid\":\"${TASK_UID}\" ,\"status\":\"IN_PROGRESS\"}" ${GW_URL}/paas-pipeline/project/v1/pipeline/status'
```
   code = new JsonSlurper().parseText(result).code
```
if(code != "0"){ throw new Exception("failed"); }

以上为脚本开始状态的回调，需写在自定义命令前（不需要修改，可直接复制）
result = sh returnStdout: true ,script: 'curl -X POST -H "X-Auth-Token: ${userToken}" -H "X-Auth-Project: ${PROJECT_ID}" -H "Content-Type: application/json" -H "Authorization: $GATEWAY_TOKEN" -d "{\"pipRecordId\":\"$PIP_RECORD_ID\",\"stageUid\":\"${STAGE_UID}\" ,\"taskUid\":\"${TASK_UID}\" ,\"status\":\"SUCCESS\"}" ${GW_URL}/paas-pipeline/project/v1/pipeline/status'
```
code = new JsonSlurper().parseText(result).code
```
if(code != "0"){ throw new Exception("failed"); } }catch(ex){ echo "errMsg:"+ex result = sh returnStdout: true ,script: 'curl -X POST -H "X-Auth-Token: ${userToken}" -H "X-Auth-Project: ${PROJECT_ID}" -H "Content-Type: application/json" -H "Authorization: $GATEWAY_TOKEN" -d "{\"pipRecordId\":\"$PIP_RECORD_ID\",\"stageUid\":\"${STAGE_UID}\" ,\"taskUid\":\"${TASK_UID}\" ,\"status\":\"FAILED\"}" ${GW_URL}/paas-pipeline/project/v1/pipeline/status' code = new JsonSlurper().parseText(result).code if(code != "0"){ throw new Exception("failed"); } throw ex } }

以上为结束状态的回调及异常处理，写在自定义命令后（不需要修改，可直接复制）

串行与并行

流水线支持配置串行任务与并行任务。

运行流水线

流水线详情

左侧为执行历史，点击可以查看执行历史的配置。

点击详细日志，可以查看运行日志，点击每个阶段的右上角可以查看每个阶段的日志。执行历史编号是递增的，每执行一次生成一个记录；

点击执行变量可以查看流水线运行时有哪些变量赋值；

点击每个阶段的任务，可以查看历史任务的配置详情；

重新执行

重新执行有两类，一类是整条流水线重新执行，另一类是点击阶段的右上角，是从当前阶段开始重新执行。

任务配置

当前支持的任务：

获取源码
JAVA构建
node.js构建
Maven单元测试
JAVA制品上传
npm制品上传
镜像构建
容器部署
条件执行
代码扫描

用户可根据自己的需求配置对应的任务。

获取源码

用户可针对该应用，选择对应的仓库和分支。

仓库：选择发布单元仓库地址。

分之：选择对应的分支。

JAVA构建

任务名称：输入任务名称。

jdk版本：选择jdk版本（目前只支持 java1.8 版本）。

构建命令：默认命令如图，用户可根据自身需求修改命令。

node.js构建

任务名称：输入任务名称。

构建：默认命令如图，用户可根据自身需求修改命令。

node-version：选择node-version版本（目前只支持12.22.1版本）。

Maven单元测试

任务名称：输入任务名称。

是否执行：勾选任务是否执行。

前提条件：

pom配置jacoco：

本地跑单元测试命令，本地代码存放目录不要带有中文 mvn clean install -Dmaven.test.failure.ignore=true 在本地 target/site 目录中生成测试测试报告，打开index.html文件可以查看详情 请确保可以正确生成测试报告，并且观察日志，跑本地单元测试时没有启动应用，否则自行调整至成功！！！目录结构大致如下：

python单元测试

当前暂时无法支持python语言的单元测试

python语言本地生成代码覆盖率报告的操作如下：

引用pytest和coverage模块 pip install pytest coverage 运行单元测试并生成报告的命令pytest tests/ --cov={项目指定目录} --cov-report=html --cov-report=term-missing 在本地根目录中会生成对应的报告目录如下：报告内容为：