Jenkins常见问题处理

时间:2024-10-14 15:41:58

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