Jenkins详细安装配置部署

一、安装jdk

二、安装jenkins

三、安装git

四、安装maven

五、Jenkins全局工具配置

六、SSH插件安装

七、SSH传输服务器设置

八、页面配置发布工程

九、目标发布服务器配置

十、构建项目

十一、构建前端web工程

十二、权限分配

简介

Jenkins是一个开源软件项目，是基于Java开发的一种持续集成工具。主要做的事情就是从git中拉取代码，根据配置信息打包；把打好的包传输到目标服务器，并可以执行一些shell脚本，使项目打包发布一键完成。

一、安装jdk

jenkins的安装需要依赖于jdk。

1.新的服务器需要支持文件上传和下载，安装rz（上传）sz（下载）

yum install lrzsz -y

2.使用命令rz上传linux下的jdk安装包到服务器，输入rz后会弹出一个选项框，选择对应的jdk安装包（最新版的jenkins需要jdk11以上），2022年7月2日起，jenkins新版本不再支持java8，仅支持java11和java17。

3.解压jdk安装包文件

tar -zxvf jdk*.tar.gz

4.到/usr/local目录下创建存放jkd的目录java:

cd /usr/localmkdir java

5.目录切到/usr/local/java下，把jdk的解压文件添加到此目录下

cd /usr/local/javamv /home/zhanglizeng/jdk-11/ .

6.在环境变量中配置jdk

打开配置文件：

vi /etc/profile

输入字符i开始进行编辑

向配置文件中添加jdk的安装目录：

export JAVA_HOME=/usr/local/java/jdk-11export PATH=$JAVA_HOME/bin:$PATHexport CLASSPATH=.:$JAVA_HOME/lib/tools.jar:$JAVA_HOME/lib/dt.jar

按esc退出编辑

输入：再输入wq（保存并退出），若是输入q!则退出不保存

7.让配置生效：

source /etc/profile

8.检验jdk是否安装成功：

java -version

二、安装jenkins

1.输入命令安装jenkins

sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo --no-check-certificatesudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.keyyum install jenkins

2.配置jenkins端口

vim /etc/sysconfig/jenkins

#监听端口JENKINS_PORT="8080"

3.配置权限，修改为root

vim /etc/sysconfig/jenkins

#修改配置JENKINS_USER="root"

修改目录权限

chown -R root:root /var/lib/jenkinschown -R root:root /var/cache/jenkinschown -R root:root /var/log/jenkins

编辑jenkins的配置文件：

vim /etc/init.d/jenkins

添加jdk的安装目录：

4.重启jenkins：

老版本的jenkins（jdk1.8及之前）：

#重启jenkinssystemctl restart jenkins#启动jenkinssystemctl start jenkins#查看jenkins状态systemctl status jenkins.service

新版本的jenkins（jdk大于等于11）：

先切到 Jenkins 脚本目录

cd /etc/init.d

再执行命令

#重启jenkins./jenkins restart#启动jenkins./jenkins start#查看jenkins状态./jenkins status

若是装的最新版的jenkins，而启动命令还是使用原来的方式，则会报启动失败

查看启动状态为失败，报的错误是：Failed to start Jenkins Continuous Integration Server

5.启动jenkins

老版本的jenkins（jdk1.8及之前）：

service jenkins start

新版本的jenkins（jdk大于等于11）：

先切到 Jenkins 脚本目录

cd /etc/init.d

./jenkins start

此时执行启动jenkins命令，还是显示启动失败，jdk还是引用的1.8，默认的加载usr/lib/jvm下的jdk

此时我们需要在usr/lib/jvm下安装对应的jkd11

yum install java-11-openjdk* -y

安装完成后需要改变下jdk的选中版本

alternatives --config java

列出可选的jdk版本，输入jdk11对应的序号即可

此时再启动jenkins成功

6.查看是否开启防火墙

systemctl status firewalld

若是为dead，则没有开启防火墙，需要开启防火墙：

systemctl start firewalld

再查看防火墙：

查看是否开放端口8080：

firewall-cmd --list-ports

没有开放，则加入

firewall-cmd --permanent --zone=public --add-port=8080/tcp

重启防火墙

systemctl reload firewalld

再次查看是否开放

7.访问jenkins服务

查看linux的ip地址：

ifconfig -a

访问jenkins地址 http::8080

执行命令查看密码：

cat /var/lib/jenkins/secrets/initialAdminPassword

复制密码输入到管理员密码，登录系统，插件安装选择推荐插件

安装进行中

插件安装完成以后将会创建管理员账户

安装完成

运行截图：

8.设置jenkins控制台中文显示

Manage Jenkins->Manage Plugins安装插件

安装插件 Locale plugin,Localization: Chinese (Simplified) , 如果失败就再安装一次，在可选插件中搜索，勾选，然后点击Install without restart，下面截图为已经安装好的状态

Manage Jeknins-》configure System设置显示语言，找到Locale设置为zh_CN，点击运用保存

重启Jenkins，浏览器中输入（http://域名/restart）http://192.168.153.130:8080/restart即可生效。

如果出现部分翻译，部分没翻译的现象，则删除插件。重启Jenkins（http://域名/restart），再次安装插件（第一次安装只有部分翻译了）

如果安装新的插件，重启了服务，又变成部分汉化了：

①将语言设定为zh_US，Jenkins切换为英文。
②调用restart重启Jenkins：http://域名/restart。
③再次语言设定为zh_CN，刷新即可，此次不能再重启

三、安装git

1.执行安装命令：

yum install git

2.查看安装git是否成功：

git --version

四、安装maven

1.上传maven安装包到linux服务器：rz

2.解压文件：

tar -zxvf apache-maven-3.6.3-bin.tar.gz

3.切到安装maven的目录：

cd /usr/local

创建目录maven：

mkdir maven

进入到maven目录：

cd maven

把解压的maven包移动到此目录下：

mv /home/zhanglizeng/apache-maven-3.6.3/ .

4.修改maven的setting.xml配置信息

进入目录：

cd/usr/local/maven/apache-maven-3.6.3/conf

编辑setting.xml配置文件：

vi settings.xml

①设置存放jar包的目录：

②配置私服的serviers

 umapp-rsNexus umapp`Qihoo360!

③配置阿里云镜像

alimavenaliyun mavenhttp://maven.aliyun.com/nexus/content/groups/public/central

④配置maven私服nexus及激活的配置

 umappumapp-rsNexus umapphttp://xxx:port/nexus/content/repositories/umapp/umapp

5.创建存放jar包的目录repo，需要与setting.xml中配置的一致：

切到需要创建的目录下：

cd /usr/local/maven

创建目录：

mkdir repo

给目录赋读写权限：

chmod 777 repo

6.把maven安装信息配置进环境变量中

编辑环境变量：

vi /etc/profile

把maven信息加进去保存并退出（wq）：

export M2_HOME=/usr/local/maven/apache-maven-3.6.3export PATH=$M2_HOME/bin:$PATH

7.重新加载环境变量：

source /etc/profile

8.查看maven是否安装成功：

mvn -v

五、Jenkins全局工具配置

在jenkins首页依次进入系统管理>>全局工具配置：

1.jdk配置：输入jdk安装的目录

2.git配置：输入git的目录

3.maven配置：输入maven的目录

六、SSH插件安装

jenkins打完包需要上传到新的服务器上，此处使用ssh的方式上传，添加ssh插件。系统管理-》插件管理-》可选插件

所需插件如下:如果已经安装，无需再次安装SSH 、Maven Integration 、Git plugin、Publish Over SSH，Role-based 。

安装完成后新建工程时，构建环境选项才会出现SSH相关的选项

附加：截止到发稿前，新版本的jenkins不提供Publish Over SSH插件，从可选库里面检索不到，jenkins官网暂停了插件，原因是存在XSS和CSRF攻击，目前没有修复，但是我们使用内网部署，不存在这种情况，外网部署的情况需要慎重考虑。

可以手动添加Publish Over SSH插件到jenkins，需要的文件下载git地址：

https://github.com/zhangliqingyun/publishssh.git

目录切到：

/var/lib/jenkins/plugins

把这两个文件添加进行，解压赋值上对应的权限

添加完成后即可在已安装插件中显示，创建项目的时候可以直接使用，在配置ssh服务器的位置也显示

七、SSH传输服务器设置

点击系统管理-》系统配置，系统设置主要定义，Jenkins本身的一些配置，邮件、远程服务器管理、构建参数等，这里先配置远程主机，后面自动发布时会用到，找到Publish over SSH相关部分。

1.Jenkins SSH Key配置jenkins部署所在服务器的信息

　Passphrase：SSH的密码，使用用户名/密码登录时为用户名的密码，使用私钥登录时为私钥的密码，没有就留空

　Path to key：SSH私钥的文件路径

　Key：私钥

①在安装jenkins的服务器上执行命令生成私钥信息

ssh-keygen -t rsa

全部按回车执行不需要输入密码，执行完或会在目录/root/.ssh下生成私钥信息

②Passphrase内输入登录服务器的密码

③Path to key内输入私钥的文件地址：

/root/.ssh/id_rsa

④Key为id_rsa的文本内容，可以使用命令：sz id_rsa把文件下载下来，把文本内容粘贴进行

2.SSH Servers配置需要把打好的jar包上传到的服务器信息（发布业务系统的服务器）

点击新增添加ssh服务器，可以根据需要添加多台。

Name：SSH节点配置的名称，在Job中使用Publish over SSH插件时，此名称将出现在”SSH Server”中”Name”的下拉列表中。

Hostname: 主机IP

Username：主机用户名

Remote Derictory: 运程机器上真实存在的目录，并且”Username”指定的用户要有访问此目录的权限，插件将把文件传送到此目录下；

登录服务器创建目录：

mkdir u01

给u01目录赋权限：

chmod 775 u01

登录远程服务器使用秘密的方式，点击高级展开进行设置：

勾选使用秘密登录： Use password authentication, or use a different key，点击Change Password设置添加的用户登录服务器的密码

也可以不使用密码，免密登录的方式：把部署jenkins的rsa.pub文件拷贝到目标机器的authorized_keys下，到目标服务器下执行

viauthorized_keys

，把公钥内容粘贴进行，然后重启目标服务器的shh

systemctl restart sshd.service

点击Test Configuration按钮测试配置的服务器是否能正常链接：当出现Success表示链接正常

八、页面配置发布工程

1.创建视图，把工程放在视图中进行管理

2.在创建的视图中添加任务

3.输入任务名称，选择构建一个maven项目，勾选添加到当前视图进行创建

4.General选择丢弃旧的构建，输入保持构建的最大个数

5.源码管理选择Git的方式，添加项目的git地址

点击添加访问git地址的用户名和密码信息，此用户需要有权限访问git链接：

填写对应的用户名密码即可：

指定需要打包的分支：

6.构建环境

选择：Send files or execute commands over SSH after the build runs把打包好的jar文件发送后执行命令的方式

Name：目标主机名称，前面配置主机时有提到，在第七部分的第2点配置的，若是配置了多台，则此处为下拉选择。

Source files：需要传输的文件路径，jenkins默认打出来的jar包放在/var/lib/jenkins/workspace目录下，后面的目录umapp-cloud-service-todolist为创建任务的名称，此处只用填写项目打包后的结尾文件名即可，前缀默认会拼接

Remove prefix：移除文件前缀，当从jenkins服务器把jar文件通过ssh发送到目标服务器后，目标服务器存放jar的目录，需要去掉的前缀（源jenkins存放jar的目录为基础）

Remote directory：远程目录，此目录是基于前面第七部分的第2点配置ssh server时定义的目录(/u01)为根目录。按此配置，则目标服务器上需要存在/u01/builds的目录

7.build打出jar包

Root Pom：配置pom.xml的文件目录

Goals and options：配置maven执行的命令

-Pdev为激活dev配置，此处的配置对应项目properties或yml配置文件的active（激活配置）

–plxxx-service/xxx-service-xx：只打包xxx-service/xxx-service-xx这个项目，因为xxx-service目录下可能存在多个项目

-am：表示同时处理选定模块所依赖的模块，此处xxx-service-xxx可能会依赖于其他模块，使用am（also-make）把依赖的一并打包进来

九、目标发布服务器配置

1.首先确保jar文件操作的目录/u01存在（若不存在可以执行创建命令mkdir u01），并且有权限（若没有权限可以执行命令：chmod 775 u01），在上面第七部分第1点已经介绍创建过此目录

2.在u01目录下创建存放jar包的目录builds：

mkdir builds

并且赋权限：

chmod 775 builds

builds的命名对应第八部分的第6点Remote directory内容

3.在u01下创建存放执行文件的目录scripts：

mkdir scripts

并且赋权限：

chmod 775 scripts

scripts的命名对应第八部分的第6点Exec command的部分内容

4.在自己的电脑创建一个名为：umapp-cloud-devops.sh的linux执行文件，编辑好后上传到/u01/scripts目录下，文件命名对应第八部分的第6点Exec command的部分内容。

可执行文件接收4个参数，提供start启动的方法，重启restart的方法，停止stop的方法，删除备份del_bak的方法，备份bak的方法

#!/bin/bash # 操作名称optionName=$1# Jar项目名称appName=$2# 项目路径appDir=$3# 内存配置级别 0:256m 1:512m 2:1G 3:2G 4:4GMemConfLevel=$4# 创建项目目录appPath="/u01/project/umapp/$appDir"if [ ! -d "$appPath" ];thenmkdir $appPathfi # 帮助说明function usage(){echo "Usage: sh /u01/scripts/umapp-cloud-devops.sh [-optionName] [appName] [appDir] [MemConfLevel]"echo "Example: sh /u01/scripts/umapp-cloud-devops.sh restart umapp-cloud-auth-1.0.0 auth 0"echo "where options include:"echo " start启动app"echo " stop 停止app"echo " restart重启app"echo " status 查看状态"} if [ "$optionName" == "--help" ];thenusage;exit 1fi if [ "$optionName" == "" ];thenecho -e "\033[0;31m 未输入操作名 \033[0m"exit 1fi if [ "$appName" == "" ];thenecho -e "\033[0;31m 未输入应用名 \033[0m"exit 1fi if [ "$appDir" == "" ];thenecho -e "\033[0;31m 未输入项目路径 \033[0m"exit 1fi if [ "$MemConfLevel" == "" ];thenecho -e "\033[0;31m 未输入内存配置级别 \033[0m"exit 1fi # 统计运行应用数function getCount(){count=`ps -ef |grep java|grep "$appName.jar"|grep -v grep|wc -l`echo $count} # 获取pidfunction getPid(){pid=`ps -ef | grep "$appName.jar" | grep -v grep | awk '{print $2}'`echo $pid} # 启动应用function start(){source /etc/profile# 统计运行应用数count=`getCount`if [ $count != 0 ];thenecho "$appName is running..."elseecho "$appName is start..."# 拷贝并覆盖Jenkins生成在builds文件下的jar 到所属的项目路径下cp -rf /u01/builds/"$appName.jar" /u01/project/umapp/$appDir/chmod 775 -R /u01/project/umapp/$appDircd /u01/project/umapp/$appDirecho "begin config..."if [ "$MemConfLevel" = 0 ];thenXmsSize=256mMetaSize=125melif [ "$MemConfLevel" = 1 ];thenXmsSize=512mMetaSize=256melif [ "$MemConfLevel" = 2 ];thenXmsSize=1GMetaSize=512melif [ "$MemConfLevel" = 3 ];thenXmsSize=2GMetaSize=1Gelif [ "$MemConfLevel" = 4 ];thenXmsSize=4GMetaSize=2GfiJAVA_OPTS="-Xms${XmsSize} -Xmx${XmsSize} -XX:CompressedClassSpaceSize=${MetaSize} -XX:MetaspaceSize=${MetaSize} -XX:MaxMetaspaceSize=${MetaSize} -Xloggc:logs/gc.log"echo "before start..."nohup java -jar "$appName.jar" >$appName 2>&1 &echo "after start..."fi} # 停止应用function stop(){echo "stop $appName..."count=`getCount`if [ $count != 0 ];thenpid=`getPid`echo "stop $appName kill pid $pid"kill $pidsleep 2count=`getCount`if [ $count != 0 ];thenecho "stop $appName kill -9 pid $pid"kill -9 $pidfifi} # 备份应用function bak(){echo "bak start..."bakPath="/u01/bak/umapp/$appDir"if [ ! -d "$bakPath" ];thenmkdir $bakPathfibakName="/u01/project/umapp/$appDir/${appName}.jar"if [ -f "$bakName" ];thenmv -f $bakName $bakPath/${appName}_`date +%Y%m%d%H%M%S`.jarfi } # 删除过期的备份程序只保留最新3次的function del_bak{echo "del_bak start..."bak_DIR=/u01/bak/umapp/$appDirif [ -d $bak_DIR ]; thencd $bak_DIRbak_count=`ls -lthr | grep -v 'total' | grep"$appName" |wc -l`if (($bak_count > 3));thendel_count=`expr $bak_count - 3`ls -thr | grep -v 'total' | grep"$appName"| head -$del_count | xargs rm -rffifiecho "del_bak success..."}# 重启应用function restart(){stopdel_bakbakstartstatus} # 打印启动状态function status(){count=`getCount`if [ $count != 0 ];thenecho "$appName is success..."elseecho "$appName is not success..."fi} case $1 instart)start;;stop)stop;;restart)restart;;status)status;;--help)usage;;*)echo -e "请使用--help察看可用选项" ;;esac

5.创建可执行文件需要的目录

①umapp-cloud-devops.sh文件有一个存放jar包启动文件的目录project，把jar从/u01/builds下移动到/u01/project/umapp下，所以在/u01下创建对应的目录：

mkdir project

并且赋权限：

chmod 775 project

chmod 775 project

进入到project：

cd project/

再创建umapp目录：

mkdir umapp

并且赋权限：

chmod 775 umapp

②umapp-cloud-devops.sh文件有一个从/u01/project/umapp备份jar包到/u01/bak/umapp的操作，所以在/u01下创建对应的目录：

mkdir bak

并且赋权限：

chmod 775 bak

进入到bak：

cd bak/

再创建umapp目录：

mkdir umapp

并且赋权限：

chmod 775 umapp

6.配置系统启动需要的日志文件目录

根据项目配置的日志目录在/u01目录下创建日志目录：

mkdir logs

并且赋权限：

chmod 775 logs

十、构建项目

点击项目名称进入构建页面

点击立即构建

点击构建的序号查看构建情况

点击控制调输出查看构建情况

最后输出Finished: SUCCESS表示构建成功，从服务的注册中心nacos可以查看系统构建成功

十一、构建前端web工程

前面第八、九、十是构建的java maven项目，此处构建的是纯前端项目。

1.添加前端打包需要的插件，系统管理-》插件管理，添加NodeJs Plugin。

2.配置node全局工具，系统管理-》全局工具配置，找到NodeJs相关配置，选择NodeJs版本。

注意NodeJs的版本选择，需要跟安装jenkins的服务器对应，太高的NodeJs版本，需要的Glibc版本比较高，否则打包的时候会报找不到高版本的Glibc。

/lib64/libm.so.6: version `GLIBC_2.27‘ not found

可以通过命令查看服务器Glibc的版本信息

strings /lib64/libc.so.6 |grep GLIBC

此处我们选择nodeJS-14.17.6。

3.创建一个任务，新建任务-》构建一个自由风格的软件项目

4.General选择丢弃旧的构建，输入保持构建的最大个数

5.源码管理选择Git的方式，添加项目的git地址

点击添加访问git地址的用户名和密码信息，此用户需要有权限访问git链接：

填写对应的用户名密码即可：

指定需要打包的分支：

6.构建环境选择Provide Node & npm bin/ folder to PATH，选择在全局配置中配置的nodejs

7.构建步骤选择执行shell（Execute shell）

配置bulid构建的脚本

#查看环境pathecho $PATH#打印node版本node -v#打印npm版本npm -v#安装镜像文件，镜像文件的地址具体根据前端使用的库进行配置npm install yarn --registry=http://registry.npm.xxx.org/#开始构建npm run build#进入构建完的dist目录cd dist#移除上次打的压缩包rm -rf dist.tar.gz#把dist目录下的文件全部打成压缩包tar -zcvf dist.tar.gz *cd ../

8.构建后操作，选择通过ssh传输到目标服务器：Send build artifacts over SSH

Name：目标主机名称，前面配置主机时有提到，在第七部分的第2点配置的，若是配置了多台，则此处为下拉选择。

Source files：需要传输的文件路径，jenkins默认打出来的jar包放在/var/lib/jenkins/workspace目录下，后面的目录test-doravis为创建任务的名称，此处只用填写项目打包后的结尾文件名即可，前缀默认会拼接

Remove prefix：移除文件前缀，当从jenkins服务器把tar.gz文件通过ssh发送到目标服务器后，目标服务器存放tar.gz的目录，需要去掉的前缀（源jenkins存放tar.gz的目录为基础）

Remote directory：远程目录，此目录是基于前面第七部分的第2点配置ssh server时定义的目录(/u01)为根目录。按此配置，则目标服务器上需要存在/u01/project的目录

Exec command：配置传输到目标服务器后执行的命令

#进入存放tar.gz文件的目录cd /u01/project#移除存放前端文件的目录rm -rf webProject#创建存放前端文件的目录mkdir webProject#解压tar.gz文件，并放到上面创建的目录下tar -zxvf dist.tar.gz -C webProject#移除tar.gz文件rm -rf dist.tar.gz

9.保存配置，立即构建，构建成功后，在目标服务器存在此dist文件