Jenkins操作手册

读者对象：生产环境管理及运维人员

Jenkins作用：项目自动化构建部署。

一、登陆

二、新增用户及设置权限

2.1：新增用户

点击Manager Jenkins → Manager Users → Create User

2.2：权限

点击Manager Jenkins → Manager And Assign Roles → Assign Roles

Global roles

Item roles

然后在下图中勾选需要配置的权限范围

点击Save

三、新项目配置流水线

3.1配置流水线

在项目cqyy-pipelines中写部署相关文件，可参考其他项目的配置。

项目地址：http://inca-zt-gitlab.cq-p.com.cn:7097/inca-cosp/cqyy-pipelines.git

branches：main

如：新增inca-cqyy-insider项目的流水线，可参照cqyy-channel配置，将cqyy-channel复制一份后，替换项目名称、git地址

流水线配置代码提交后，打开jenkins

3.2 jenkins配置

3.2.1 推荐方案

New Item

Enter an item name

输入完成后，点击Ok。

General

保存。

成功后就会开始部署项目。

3.2.2 单独配置

以上设置，jenkins默认是走流水线配置，还可以单独设置：

Tips:脚本中的dist 对应的是前端代码里面的outputDir

脚本中的web-cqyy-insider-test.sh对应的jenkins服务器里面的/opt/web-cqyy-insider-test.sh

3.3 常见问题：

3.3.1 编译失败

交由项目开发人员排查service的pom文件的JAR_FILE标签，将/target改为../target

然后重新构建即可。

。

3.3.2 权限不够

解决：登录jenkins服务器，chmod -R 777 /home/jenkins/web/test/web-test  

然后重新构建，部署成功。

3.3.3 镜像拉取失败

编译通过，部署失败

原因：git提交人的名字是汉字，应改为英文

3.3.4 自动部署

反之，如果不想在提交代码后自动部署对应的环境的项目，取消勾选 保存即可。

3.3.5 页面嵌套异常

解决：检查【菜单管理】、nginx配置、流水线配置。

经检查，发现流水线配置与nginx的路径配置不一致，调整流水线后，在nginx中的/data/web/child 移除cqyy-settle文件夹，重新构建，清除浏览器缓存即可。