DevOps之三--Jenkins + Gitblit +Maven快速构建 springboot 项目

导航

• DevOps之一--自动化CI、CD基础概念
• DevOps之二--Docker快速安装Jenkins
• DevOps之三--Jenkins + Gitblit +Maven快速构建 springboot 项目
• DevOps之四--Publish over SSH远程部署
• DevOps之五-- Gitblit 触发 Jenkins

Docker快速安装 jenkins 参考
Devops CI CD 流程总览如下：
拉取源代码 > 预处理 > 编译 > 构建 > 打包 > 镜像 > 发布

一、安装 Jenkins 插件

1. 点击“系统管理”，页面报错

image.png

2. 点击复制依赖插件名称，点击纠正->可选插件，文本框输入插件名称，然后直接安装

image.png

3.解决后效果

image.png

4.安装 Maven插件

• 如果插件安装较慢请参考DevOps之二 Docker快速安装Jenkins 目录 4、8 解决
  
  安装插件 1.png
  
  
  安装插件 2.png

二、Jenkins基础配置

1.全局环境配置

本文章记录的配置都是基于 Docker安装Jenkins实现的

1.1 系统管理 > 全局配置

image.png

1.2 JDK配置

• 查看容器名称

docker ps

• 进入 docker容器

docker exec -it -u root jenkins /bin/bash

• 容器内查找 JDK 根目录

whereis java

• 配置 JDK

  
  
  配置 JDK.png

1.3 Git配置

• 容器内查找 Git 根目录

whereis git

• 配置 Git

  
  
  配置 Git.png

1.4 Maven 配置

• 容器内查找 Maven 根目录

whereis maven

• 配置 Maven

  
  
  配置 Maven.png

1.5 【踩坑】容器内没有 maven

• 问题：由于使用 docker安装的 Jenkins,容器内包含了 JDK、Git 两个插件，没有包含 maven 插件，刚开始我配置的宿主机的 maven,一直报找不到 Maven错误：/usr/local/maven is not a directory on the Jenkins controller (but perhaps it exists on some agents)

  
  
  Maven 配置错误.png
• 解决方案1：在 docker容器内安装 Maven(记得安装完成后保存镜像)，由于容器内各种命令不能使用或需要更新，最终我放弃了这种方案。
• 解决方案 2：在宿主机安装 Maven,然后将宿主机 Maven跟目录和容器内目录做映射（推荐使用这种方案）

1.5.1 Docker宿主机文件和容器内路径映射

• 场景一：没有启动过 docker 容器
  解决方案：直接在启动时添加路径映射

docker run -itd -p 9080:8080 -p 9081:50000 -v /var/jenkins_home:/var/jenkins_home -v /etc/localtime:/etc/localtime -v /home/run/apache-maven-3.5.4:/usr/local/maven --name jenkinsTest  jenkins/jenkins:latest-jdk8

• 场景二：已经启动过 docker容器,并做过了一些配置，不想重新再配置一遍。
  解决方案：提交当前容器生成新的镜像，再次运行容器。

# 1.停止 docker 容器
docker stop jenkins
# 2.提交当前容器，生成新的镜像
docker commit jenkins  newJenkins:mytag
# 3.查看新镜像是否生成成功。
docker images
# 4.运行新的镜像，生成新的容器
docker run -itd -p 9080:8080 -p 9081:50000 -v /var/jenkins_home:/var/jenkins_home -v /etc/localtime:/etc/localtime -v /home/run/apache-maven-3.5.4:/usr/local/maven --name jenkinsTest  jenkins/jenkins:latest-jdk8

三、实现在 Jenkins 管理台手动构建项目

1. jenkins 首页 > 新建任务

新建任务.png

2.任务基础信息

• 输入任务名称

• 选择任务类型，为了测试简单方便，我这里选择的是 Maven

  
  
  任务基础信息.png

3.配置构建任务的详细参数

• 首页 > 任务名称 > 配置

  
  
  image.png

3.1 配置旧的构建缓存策略

• 一般保存 7 天或 5 个构建版本，满足任意条件则删除最老版本的构建

  
  
  缓存策略.png

3.2 源码管理

3.2.1 配置源码仓库地址

• 源码仓库地址.png

3.2.2 配置仓库账号密码

• 添加 > jenkins
  如果代码仓库账号密码没有问题，页面上的错误提示就消失了。有错误提示证明配置的有问题。

  
  
  新增账号密码.png
  
  
  使用账号密码.png

3.2.3 配置仓库分支

仓库分支.png

3.3 构建环境配置

• 一般如下配置

  
  
  构建环境.png

3.4 Root POM 配置【重点】

• 因为是基于 Maven 插件构建项目的，所以这里的 POM 路径必须配置正确。
  Jenkins在构建项目时,会在jenkins_home（参看上述 1.5.1启动时的映射） 目录下创建一个 workspace 工作目录，每个构建任务会在 workspace 创建一个对应名称的文件夹,这里的 Root POM 是以构建任务文件夹为根目录的.

  
  
  image.png

• 如果 Root POM 配置的devicelink/pom.xml，则读的是
  /var/jenkins_home/workspace/JenkinsBuild/devicelink/pom.xml,如果配置错误会提示找不到这个 pom.xml。

  
  
  Root POM.png

• 项目架构如下（多模块）：

  
  
  image.png

3.5 Post steps （构建成功后）

• Post steps.png

3.6 保存

4. 立即构建

• 立即构建.png

5. 查看构建日志

• 构建日志.png

6. 构建成功

• 构建成功.png

四、实现远程 Api触发构建项目

1. 首页 > 构建任务名称 > 配置 > 构建触发器

2. 开启远程 API 触发构建

• 远程触发构建.png

2.1 【踩坑】多模块项目构建子模块失败

• 问题：一个项目有多个模块，同时继承了一个父级 dependencies 模块，构建时选择的是子模块的 pom.xml ，构建报错 找不到父级模块的 pom.xml

• 解决方案：勾选 Schedule build when some upstream has no successful builds 选项

  
  
  解决方案.png

3. 开放匿名用户访问权限

• 首页 > 系统管理 > 全局安全配置

  
  
  开放 API构建权限.png

4. 远程调用 API 触发构建

http://url:host/job/JenkinsBuild/build?token=123456