Jenkins安装启动入门详解【避坑+安装包提供】

Jenkins学习笔记

参考资料：基于CentOS8+jdk1.8 安装jenkins-2.346.3-1.1.noarch.rpm_用yum的方式下载jenkins 2.346.1版本-CSDN博客；

注意点：安装Jenkins中有很多坑，软件版本尽量和此文保持一致

由于最好保持一致，如下笔记给出了具体的下载地址，受时间影响可能对应的版本不存在了，因此下面还给出了安装包的网盘链接。

百度网盘：链接: https://pan.baidu.com/s/1I0SsVY0W1M8gDTPZ4fttig?pwd=8888 提取码: 8888

01-Jenkins安装与部署入门

1.1-安装JDK

需要下载jdk的可上该网站OpenJDK Downloads | Download Java JDK 8, 11, 17, & 21 | OpenLogic；

选择服务器对应的位数的版本下载即可。

这里选择的jdk版本是openlogic-openjdk-8u422-b05-linux-x64.tar.gz，下载完成后，我们先将安装包上传到服务器中/usr/local/install-packge，将压缩包解压，如下命令

tar -zxvf openlogic-openjdk-8u422-b05-linux-x64.tar.gz

将jdk移动到/usr/local/software目录下，软件目录可按照自己喜好存放

mv openlogic-openjdk-8u422-b05-linux-x64 ../software/openlogic-openjdk-8u422-b05-linux-x64

下载完jdk后就开始配置jdk的环境变量，执行如下命令进入系统环境变量配置

vim /etc/profile

添加如下环境变量，JAVA_HOME后面的值为自己jdk的地址

export JAVA_HOME=/usr/local/software/openlogic-openjdk-8u422-b05-linux-x64
export CLASSPATH=:${JAVA_HOME}/jre/lib/rt.jar:${JAVA_HOME}/lib/dt.jar:${JAVA_HOME}/lib/tools.jar
export PATH=$PATH:${JAVA_HOME}/bin

设置后:wq保存退出

配置完成如图所示

添加环境变量后刷新配置

#刷新配置
source /etc/profile

#验证是否成功，正确出现之后说明jdk下载完成
java -version

执行java -verion后出现以下内容为配置成功

1.2-安装maven

这里给出maven的下载地址Index of /apache/maven/maven-3/3.8.8/source (tsinghua.edu.cn)；

如果过段时间后清华镜像里没有这个版本的maven了，这里给出网盘分享地址，

百度网盘：链接: https://pan.baidu.com/s/1I0SsVY0W1M8gDTPZ4fttig?pwd=8888 提取码: 8888

这里选择的maven版本是apache-maven-3.8.8-bin.tar.gz，同安装jdk一样，我们先将安装包上传到服务器中/usr/local/install-packge，将压缩包解压，如下命令

 #解压
 tar -zxvf apache-maven-3.8.8-bin.tar.gz
 
 #移动到自己指定的目录（可选）
 mv apache-maven-3.8.8 ../software/apache-maven-3.8.8

接下来对maven进行配置，我们先配置maven的配置文件，替换镜像以及本地仓库

进入我们安装好的maven的目录下

#进入maven安装目录
cd /usr/local/software/apache-maven-3.8.8

然后我们可以在这里建立一个文件夹用来当作本地的jar包的仓库

mkdir repository

创建完本地仓库路径后我们进入maven的配置文件进行编辑

vim /usr/local/software/apache-maven-3.8.8/conf/settings.xml

1.添加本地仓库地址，具体如下图

 #本地仓库地址
 <localRepository>/usr/local/software/apache-maven-3.8.8/repository</localRepository>

设置后:wq保存退出

2.添加阿里云镜像地址，具体如下图

<!--配置镜像仓库地址-->
    <mirror>  
       <id>alimaven</id>
       <name>aliyun maven</name>
       <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
       <mirrorOf>central</mirrorOf> 
    </mirror>

设置后:wq保存退出

设置完maven的配置文件后，接下来去配置maven的环境变量，进入如下文件编辑

vim /etc/profile

加入如下配置，添加maven环境变量，注意：MAVEN_HOME的地址为自己安装maven的地址

export MAVEN_HOME=/usr/local/software/apache-maven-3.8.8
export PATH=$PATH:$MAVEN_HOME/bin

配置完成保存退出后，执行source /etc/profile，命令刷新配置

然后输入

#刷新配置
source /etc/profile

#查看配置是否成功
mvn -v

显示如下则为配置成功

1.3-git安装

选择下载git软件包，源码下载地址：https://github.com/git/git/releases，这里选择2.31.1版本，如果github访问不到，也可以通过网盘分享的安装包下载，网盘地址文章顶部有给出

下载完软件包后，同上述安装一样，我们先将安装包上传到服务器中/usr/local/install-packge，进入目录，输入如下命令进行解压

tar -zxvf git-2.31.1.tar.gz

同样将解压后的软件移动到/usr/local/software目录中（可选自己决定放到哪里）

mv git-2.31.1 /usr/local/software/git-2.31.1

然后进入到解压后的目录:/usr/local/software/git-2.31.1

 cd /usr/local/software/git-2.31.1/

接下来就是编译源码，但是在编译源码之前，我们需要先安装一下依赖：

yum install curl-devel expat-devel gettext-devel openssl-devel zlib-devel gcc perl-ExtUtils-MakeMaker

当这些依赖安装完成以后，系统自动为我们安装了git，此时我们要卸载掉旧版本的git：

yum -y remove git

接下来在源码所在的目录下编译源码：

make prefix=/usr/local/software/git all

然后将git安装到/usr/local/git目录下

make prefix=/usr/local/software/git install

执行完上述命令后，输入如下命令，

ll /usr/local/software

可以看到我们的git正确安装了

接下来就是对git进行环境变量的配置，同样进入以下目录

vim /etc/profile

添加如下配置

export PATH=$PATH:/usr/local/software/git/bin

同样使用source /etc/profile刷新配置，然后输入git --version，正确输入如下内容则说明安装配置完成。

1.4-Jenkins安装与启动

1.4.1-Jenkins下载

先下载jenkins2.346-1.1版本，进入自己存放安装包的目录，然后执行如下命令下载

wget https://repo.huaweicloud.com/jenkins/redhat-stable/jenkins-2.346.3-1.1.noarch.rpm

安装完成，接下来进行Jenkins的配置

1.4.2-Jenkins环境变量配置

首先给Jenkins配置环境变量，仍然是进入/etc/profile文件，添加如下环境变量，然后输入保存退出，输入 source /etc/profile刷新环境变量配置文件。

# /usr/local/jenkins就是新的工作空间路径
export JENKINS_HOME=/usr/local/jenkins

输入 source /etc/profile刷新环境变量配置文件

1.4.3-Jenkins基础应用配置

现在我们编辑Jenkins的配置文件，先进入文件中

vim /etc/sysconfig/jenkins

将Jenkins的JENKINS_HOME变量的值改为刚刚设置的工作路径/usr/local/jenkins，如下图所示

往下滑，找到JENKINS_USER，将“”中的内容变为 root，如下图所示

改到这里其实就已经足够了，Jenkins应用使用的是8080端口，为了防止与后期部署的应用的端口冲突，我们把Jenkins的启动端口改成8888【注意：这里改了影响我们后期访问Jenkins的地址，也可以选择不该，后期部署的应用避免使用8080端口就可以】

我们继续往下滑，找到JENKINS_PORT，将其端口改为8888，如下图所示

上述三个改完之后我们输入:wq保存退出

1.4.4-Jenkins使用的JDK配置

我们先找到我们自己安装的jdk的路径

which java

复制图中地址

然后编辑Jenkins的配置文件，【这里解释一下上面提到的/etc/sysconfig/jenkins和这里的/etc/init.d/jenkins文件的区别】

• /etc/sysconfig/jenkins：这是一个配置文件，用于设置Jenkins服务的运行时参数
• /etc/init.d/jenkins：这是一个初始化脚本，用于控制系统服务的启动、停止、重启和状态查询，这个文件可以设置Jenkins启动的参数

接下来我们进入启动参数中进行配置，配置启动Jenkins使用的jdk

vim /etc/init.d/jenkins

找到 candidates=

# 设置成刚刚which java打印出来的路径
/usr/local/test/jdk1.8.0_151/bin/java

如图所示，【值得注意的是，如果你candidates=中靠前的Java路径存在，你得把他注释掉，或者把你之前的jdk卸载干净，不然这里到时候会有问题，使用的不是我们1.1中安装的openjdk】

改完之后，输入:wq保存退出

配置完成后，我们刷新一下配置，准备启动Jenkins

输入如下刷新指令

systemctl daemon-reload

这里还有一个防火墙的问题

• 如果是个人服务器或者本地，直接把防火墙关掉就行
• 如果是公司的服务器，得设置防火墙的端口访问，这里不再举例说明，具体可以自己搜索防火墙相关问题

防火墙关闭指令

# 关闭防火墙
systemctl stop firewalld

1.4.5-Jenkins启动

因为我们使用的是rpm包安装模式安装的jenkins2.346，是无法使用systemctl start jenkins命令启动的

我们先进入Jenkins启动文件的目录

cd /etc/init.d

下面列举出Jenkins的启动与关闭指令

• 启动：./jenkins start
• 停止：./jenkins stop
• 重启：./jenkins restart

我们现在来启动Jenkins，输入如下启动命令

./jenkins start

此时发现，Jenkins还是不能正确运行，报了一个文件不存在的错误，如下图所示

此时我们要创建一下这个目录，输入如下指令

mkdir -p /usr/local/jenkins

此时，我们再输入./jenkins start启动Jenkins，就成功了，如下界面

在我们浏览器中输入Jenkins所在服务器的地址和端口号就可以访问了，http://10.10.10.1:8888/【每个人ip的不同，但是因为端口我们在上边设置了8888，所以我们的端口号都是8888，如果没设置的就默认是8080】，访问可以看到如图

这个密码，就是我们启动的时候打印在控制台的这串数字

1.4.6-插件的配置【注意！踩坑】

我们输入刚刚的密码后进入到如下界面，【！！注意！！，先别点进去】

我们在url地址栏加上如下uri：/pluginManager/advanced往下翻找到如下内容

https://mirror.tuna.tsinghua.edu.cn/jenkins/updates/dynamic-stable-2.346.1/update-center.json

然后点击Submit按钮

【踩坑点】这里是设置Jenkins插件的镜像源，由于版本的问题，这里要配置相对应的Jenkins版本的插件镜像，不然下载插件会有很多问题。如果jenkins不是2.346版本的，可以进入清华镜像源：https://mirror.tuna.tsinghua.edu.cn/jenkins/updates/，找到对应的版本的update-center.json文件，然后再将url复制过来就可以

提交之后，点击Available，然后点击Check now

点击之后发现还有问题，问题如图所示

接下来我们进入到服务器中，输入如下指令进入配置文件

vim /etc/sysconfig/jenkins

找到JENKINS_JAVA_OPTIONS=配置，将其内容改为

JENKINS_JAVA_OPTIONS="-Dhudson.model.DownloadService.noSignatureCheck=true -Djava.awt.headless=true"

如图所示，修改成功输入:wq保存退出

然后将Jenkins服务停掉，重启新启动服务

# 关闭服务
./jenkins stop

# 查看服务是否关闭
ps -ef|grep jenkins

#开启服务
./jenkins start

注意，这里有个【坑】，重启服务的指令不能正常使用，也不知道原因。还有个【坑】，输入关闭服务指令后，查看一下是否以及关闭，如果还没关闭成功又启动就会启动不成功，输入ps -ef|grep jenkins指令后，如下界面表示以及关闭

这时我们就可以使用启动服务的命令了

在重新启动后，我们访问这个页面，点击安装推荐的插件

耐心等待下载完成，然后我们来创建一个用户

然后就是无脑下一步了

点击保存并完成

点击开始使用

至此，我们的Jenkins的安装和启动就完成了！