Jenkins

1、Jenkins是什么？

Jenkins 是一款开源 CI/CD 软件，用于自动化各种任务，包括构建、测试和部署软件。

Jenkins 支持各种运行方式，可通过系统包、Docker 或者一个独立的 Java 程序。

Jenkins + Docker Compose持续集成流程：

官方文档：https://www.jenkins.io/zh/doc/

学习教程【尚硅谷】: https://www.bilibili.com/video/BV1bS4y1471A?p=1&vd_source=523286d09af90fc35a40df46c3742b63

2、JenKins 安装

2.1 安装需求

机器要求：

• 256 MB 内存，建议至少有 2GB 空闲内存，否则使用过程可能会卡死（亲测）
• 10 GB 的硬盘空间（用于 JenKins 和 Docker 镜像）

需要安装以下软件：

• JDK（仅安装 JRE 是不行的）
• Maven
• Docker
• Git

2.2 Java JDK安装

Oracle JDK 官方下载：http://www.oracle.com/technetwork/java/javase/downloads/index.html

上传到服务器，解压：

tar -zxvf jdk-17_linux-x64_bin.tar.gz

# 配置环境变量
vim /etc/profile

# 在文本结尾加上下面内容
# set oracle jdk environment
export JAVA_HOME=/usr/soft/java/jdk-17.0.10  ## 这里要注意目录要换成自己解压的jdk 目录
export JRE_HOME=${JAVA_HOME}/jre
export CLASSPATH=.:${JAVA_HOME}/lib:${JRE_HOME}/lib
export PATH=${JAVA_HOME}/bin:$PATH

# 更新环境配置
source /etc/profile

# 查看 Java 版本
java -version

2.3 Maven 安装

下载 maven 包：https://maven.apache.org/download.cgi

# 配置环境变量
vim /etc/profile

# 在文本结尾加上下面内容
# set maven
export MAVEN_HOME=/usr/soft/maven/apache-maven-3.9.6
export CLASSPATH=${MAVEN_HOME}/lib:$CLASSPATH
export PATH=${MAVEN_HOME}/bin:$PATH

# 更新环境配置
source /etc/profile

# 查看 Maven 版本
mvn -v

找到 xx/maven/apache-maven-3.9.6/conf/settings.xml :

# 编辑 settings.xml 文件
vim settings.xml

# 更换镜像
<mirror>
    <id>aliyunmaven</id>
    <mirrorOf>*</mirrorOf>
    <name>阿里云公共仓库</name>
    <url>https://maven.aliyun.com/repository/public</url>
</mirror>

2.3 JenKins 安装配置

安装包下载地址：https://www.jenkins.io/zh/download/

将 jenkins.war 上传到服务器，并使用 java 命令启动（默认在 8080 端口启动）：

nohup java -jar jenkins.war --httpPort=8180 &

访问 ip:8180 进入 JenKins 控制台，将控制台的初始化密码填进去：

等待插件安装（插件安装失败可能的原因是推荐插件的版本需要更高版本的 jenkins 才能安装，我这里用的是当前最新的版本因此没有遇到插件安装失败的情况，前面用老版本测试是会安装失败的。所以要么换高版本的 jenkins，要么忽略这部分安装失败的插件，等 jenkins 安装完成后去里面的插件商店下载低版本的插件）：

创建管理员用户：

安装完成：

2.4 Maven Plugin 安装

进入 插件 管理页面：

检查是否安装了 Maven Plugin 插件，如果没有需要在 Available plugin 进行安装:

3、Git

想要获取远程仓库的信息或者代码，需要配置 Git 的相关凭证，确保 Jenkins 所在服务器能够连接上 Github/Gitee 并拉取项目源码:

3.1 Git 安装

下面安装过程以 Ubuntu 服务器为例。

# Git 安装
sudo apt-get install git
# 更新操作
sudo apt-get update
# 安装完成后，执行
git
# 有信息输出，表示安装完成

3.2 Git 配置

# Git 用户名
git config --global user.name 'yangzhenyu322'
# Git 邮箱
git config --global user.email '2807975464@qq.com'
# 生成 ssh 密钥
ssh-keygen -t rsa -C '2807975464@qq.com'

# 密钥会生成在 ~/.ssh 目录下
cd ~/.ssh
# 查看生成的密钥（id_rsa 是密钥，用于远程连接 Github/Gitee 仓库；id_rsa.pub 是公钥，需要上传到 Github/Gitee 设置中）
ls
# 查看公钥
cat id_rsa.pub

将公钥上传到 Github/Gitee 设置中：

测试 ssh 连接：

ssh -T -v git@github.com

连接成功结果：

3.3 JenKins Git 凭证添加

4、构建 Maven 项目

如果你的项目是 Spring Boot 或者 Spring Cloud 项目，那么构建一个 maven 项目可以极大的简化你的 CI/CD 过程。这里我以自己的 Spring Cloud 项目作为演示。

配置Git仓库信息（ps: URL 尽量别用 https，否则可能会出现连接超时的问题，用 git@XXX/XX.git 无需翻墙也能正常拉取项目代码）：

配置 maven:

然后填写 maven 名称，并取消勾选 Install automatically，在填写 maven 安装目录:

配置根目录的 pom 文件：

回到主页面，执行一次项目构建：

项目的第一次构建会比较慢，它需要时间去拉取依赖，后面再次构建会比较快，构建成功结果如下：

当然，可以会出现构建失败的情况，这时候你需要根据控制台的报错信息在网上搜索解决办法。

5、打包后执行操作

前面我们成功在 Jenkins 服务器从 Github 拉取代码下来并打包完成了，下面需要将项目启动的文件（包含刚才打好的 Jar 包）通过 SSH 远程上传到项目运行的目标服务器，并执行项目自动命令。

5.1 SSH 连接目标服务器

安装 publish Over SSH 插件：用于把打好的包发到远端服务器，同时需要配置和远端服务器的免密登录

去 系统配置 中最下方的 Publish over SSH 新增 SSH Servers 配置，添加一台目标服务器：


测试 SSH 连接是否成功:

5.2 项目配置

设置项目构建后的操作：

可以发现 SSH 服务已经填入我们刚才设置的目标服务器：

然后配置所需要上传的项目文件、项目启动脚本等：

重新执行项目构建：

可以看到已经成功将项目部署到远程服务器了。

ssh 连接远程服务器，进入 /usr/soft/jenkins/app/mingink 目录下，查看文件：

cd /usr/soft/jenkins/app/mingink
ls -al
docker ps -a

可以看到文件已经成功上传到目标服务器的指定目录下，并成功启动 Web 项目。

6、Git 钩子自动构建项目

假如你希望当项目代码 push 到远程仓库后，自动触发 Jenkins 的构建任务重新部署项目，那么就往下走。（ps: 这种方式适用于开发和测试环境，企业中生产环境更多是通过控制台手动或定时触发 JenKins 构建任务）

安装 Generic Webhook Trgger 插件，重启 Jenkins 后生效：

配置项目中的构造触发器：

然后通过访问 http://ip:8180/generic-webhook-trigger/invoke?token=jV2eIyBZzAD0JmEZ0JjR 这个 URL 就可以触发 Jenkins 的构建任务了。

在 Github -> 项目 -> Settings -> Webhooks 下，Add webhook：

之后修改项目，提交一次 git push，到 Github 合并请求：

这时候在 Jenkins 控制台你会发现已经自动触发了构建任务：

可以看到，当代码提交到 Github 仓库，就触发了构建任务。

注意：如果希望当 Pull Request 触发自动构建任务时，可以在 webhook -> Let me select individual events. -> 选择 Pull Request 更改触发条件