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文件夹,重新构建,清除浏览器缓存即可。