2023全网最细最全保姆级gitlab+Jenkins+maven自动化部署springboot项目教程

自动化部署springboot项目

0.简介

如果没有Linux基础请仔细看好每一个步骤,避免出错,从0到1带你搭建自动化部署环境,包括服务器安装,自动化部署所需各类软件安装配置,详细贴出每一步,不断步骤,让你一次搭建部署完成,希望这篇文章能给大家带来一定的帮助,话不多说开始整

1.自动化部署所需软件安装

1. jdk,分别为1.8和17,根据自身项目决定,如果项目已经使用17则可以只安装17
1.8是项目使用,17是Jenkins使用

2.git选择2.X

3.maven3.6

4.gitlab12.0.2

5.Jenkins选择2.389

6.服务器centos7

2.软件安装

2.0 CentOs安装

2.0.1 下载VM虚拟机

我直接电脑管家下载,也可以官网下载,懒的麻烦直接电脑管家下载,至于想永久免费使用,可以直接百度爸爸,这里不过多赘述,傻瓜式安装无限下一步即可

2.0.2 下载CentOs镜像

直接阿里云下载: https://mirrors.aliyun.com/centos/7.9.2009/isos/x86_64/
直接选择最小化镜像: CentOS-7-x86_64-Minimal-2009.iso

2.0.3 开始安装CentOs

打开VM软件

安装三个软件
net-tools以及wget
yum install net-tools -y  方便使用ifconfig 查看服务器ip
yum install wget -y  方便后续直接wget下载软件
yum install vim -y 文本编辑器

Linux连接工具,可以使用 xShell,我使用的是electerm

electerm下载地址: https://github.com/electerm/electerm/releases/tag/v1.25.41
 GitHub下载,对网络有一定要求
 下载完成傻瓜式安装,无限下一步即可

至此服务器准备完毕

2.1 安装jdk

配置jdk环境变量时,选择项目版本的jdk配置环境变量,注意jdk解压位置,路径别写错,更别写我的路径你的路径可能和我的不一样

1.下载jdk wget下载或直接下载ftps上传到服务器,此处直接下载后上传到服务器
没有安装wget直接使用 
yum install -y wget 安装确保服务器有网  wget 软件下载路径

2.解压jdk压缩包
创建一个目录存放jdk
mkdir /usr/local/java
将jdk解压到该目录
tar -zxvf jdk-8u202-linux-x64.tar.gz -C /usr/local/java/
tar -zxvf jdk-17_linux-x64_bin.tar.gz -C /usr/local/java/
进入jdk解压目录
cd /usr/local/java/
ll 指令查看当前目录下文件

3.配置环境变量,此处配置jdk8
vim /etc/profile

进入文件按 i 进入编辑模式

#文件末尾添加以下内容
export JAVA_HOME=/usr/local/java/jdk1.8.0_202
export PATH=$JAVA_HOME/bin:$PATH
export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar

编辑完按 esc 退出编辑模式 按 : 输入 wq  保存退出 

4.从新读取profile文件
source /etc/profile

2.2 安装git

0. 如果已安装git,此步骤可以直接跳过,如果想更换git版本也可以跟着一起从新安装
1.卸载git
yum remove git

2.安装依赖
yum install curl-devel expat-devel gettext-devel openssl-devel zlib-devel gcc perl-ExtUtils-MakeMaker -y

3.下载git,wget默认将文件下载在当前所处目录,或者直接下载tar包sftp传入Linux
cd ~ 进入当前用户家目录或者  cd /root ,即/root目录,因为当前登陆用户是root
wget https://mirrors.edge.kernel.org/pub/software/scm/git/git-2.9.3.tar.gz --no-check-certificate

4.解压到当前目录
tar -zxvf git-2.9.3.tar.gz 

5.配置安装路径
 cd git-2.9.3
 
./configure prefix=/usr/local/git/

6.编译安装
make && make install

7.配置环境变量
echo "export PATH=$PATH:/usr/local/git/bin" >> /etc/profile

刷新配置
source /etc/profile

或者

vi /etc/profile

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

source /etc/profile
 
8.查看git版本
git --version

9.初始化git信息,此处配置的邮箱都是后续gitlab用户的邮箱
git config --global user.name "xkcyyds"
git config --global user.email "[email protected]"

生成秘钥,直接一路回车即可
ssh-keygen -t rsa -C "[email protected]"

查看公钥
cat ~/.ssh/id_rsa.pub

2.3 安装maven

1.下载maven
wget https://dlcdn.apache.org/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.tar.gz --no-check-certificate
该路径无效情况下可以直接去官网下载,或者拿到下载地址在服务器使用wget下载,目前我这个是有效的地址
--no-check-certificate用于去掉证书验证 因为https所以需要去掉

2.解压
创建目录
mkdir /usr/local/maven 存放maven
mkdir /usr/local/maven/repo 用于存放maven下载的依赖包
解压指定文件夹
tar -zxvf apache-maven-3.6.3-bin.tar.gz -C /usr/local/maven/

3.修改配置文件 设置本地仓库以及阿里云仓库以及指定jdk版本
vim /usr/local/maven/apache-maven-3.6.3/conf/settings.xml

<localRepository>/usr/local/maven/repolocalRepository>

<mirror>
        <id>alimavenid>
        <mirrorOf>centralmirrorOf>
        <name>aliyun mavenname>
        <url>http://maven.aliyun.com/nexus/content/repositories/central/url>
mirror>

<profile>
      <id>jdk-1.8id>
      <activation>
            <activeByDefault>trueactiveByDefault>
        <jdk>1.8jdk>
      activation>

      <properties>
        <maven.compiler.source>1.8maven.compiler.source>
            <maven.compiler.target>1.8maven.compiler.target>
            <maven.compiler.compilerVersion>1.8maven.compiler.compilerVersion>
      properties>
profile>

4.配置maven环境变量
vim /etc/profile

文件最后添加如下内容
export MAVEN_HOME=/usr/local/maven/apache-maven-3.6.3
export PATH=$MAVEN_HOME/bin:$PATH

5.刷新配置文件
source /etc/profile

查看maven版本,成功输出信息则maven环境变量配置成功
mvn --version

2.4 安装gitlab

1. 安装gitlab需要的组件
yum install -y curl policycoreutils openssh-server openssh-clients postfix policycoreutils-python

2. postfix启动邮件服务以及设置自启 根据需要选择是否开启 我没有开启 不开启可以跳到第三步
systemctl start postfix
systemctl enable postfix

当启动时报:
Job for postfix.service failed because the control process exited with error code. See "systemctl status postfix.service" and "journalctl -xe" for details.

2.1 先修改postfix中/etc/postfix/main.cf配置文件
inet_protocols = ipv4
inet_interfaces = all

postfix check 检测文件,检测报错则安装下面依赖

2.2 修改完毕后依然报错,此时需要安装依赖,MySQL5.5使用该方式,5.7使用下面的方式
wget http://www.percona.com/redir/downloads/Percona-XtraDB-Cluster/5.5.37-25.10/RPM/rhel6/x86_64/Percona-XtraDB-Cluster-shared-55-5.5.37-25.10.756.el6.x86_64.rpm

rpm -ivh Percona-XtraDB-Cluster-shared-55-5.5.37-25.10.756.el6.x86_64.rpm

从新启动依然报错则是因为数据库版本问题,5.7MySQL自带libmysqlclient.so.20,而我们需要的是libmysqlclient.so.18

2.3 下载安装mysql依赖
wget https://dev.mysql.com/get/Downloads/MySQL-5.7/mysql-community-libs-compat-5.7.25-1.el7.x86_64.rpm

rpm -ivh mysql-community

2.4再次启动可以成功

3. 下载gitlab
回到用户家目录 cd ~
下载软件
wget https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7/gitlab-ce-12.0.2-ce.0.el7.x86_64.rpm --no-check-certificate

不加--no-check-certificate 可能会导致下载失败

4. 本地yum安装
yum -y localinstall gitlab-ce-12.0.2-ce.0.el7.x86_64.rpm

5. 配置gitlab访问地址 http://192.168.56.137为你自身服务器ip, 查看ip指令 ifconfig
sed -i "/^external_url/cexternal_url 'http://192.168.56.137'" /etc/gitlab/gitlab.rb

6. 修改gitlab访问端口,默认端口可能其他服务占用,可以自己指定访问端口
vim /etc/gitlab/gitlab.rb
修改 nginx['listen_port'] = 6868 (指定端口)

重置:gitlab-ctl reconfigure 重置会有点慢,耐心等一下

重置以后该文件监听端口也会改变,未改变需要手动改变一下
vim /var/opt/gitlab/nginx/conf/gitlab-http.conf
listen *: 6868 (指定端口是上面的端口)

gitlab-ctl restart 重启

gitlab-ctl tail 指令可以查看gitlab启动信息

7.访问
关闭防火墙或者放行端口6868,为了方便此处直接关闭防火墙
阿里云服务器需要登陆管理界面添加规则放行6868端口,此处不做演示
systemctl stop firewalld
查看防火墙状态
systemctl status firewalld
ip:port
http://192.168.56.137:6868/

访问成功以后需要先设置密码
设置完密码后使用root账号加刚刚设置的密码登陆

2.4.1 配置gitlab以及项目创建

进入目录后直接右键打开git bash界面

拉取仓库,注意地址后一定跟上端口否则拉取不了
git clone http://192.168.56.137:6868/root/demo.git

8. 配置邮件报警 可以不配置 根据情况自己选择 我没有配置,需要配置的需要进行步骤2操作
vim /etc/gitlab/gitlab.rb  57行以后

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = 'smtp.qq.com'
# SMTP 服务器
gitlab_rails['smtp_port'] = 465 
# SMTP 服务器端口号
gitlab_rails['smtp_user_name'] = '[email protected]'
# 邮件账号
gitlab_rails['smtp_password'] = '' 
# 邮件授权码
gitlab_rails['smtp_authentication'] = 'login'
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = true
gitlab_rails['gitlab_email_from'] = '[email protected]'
阿里云服务器访问gitlab的502问题,阿里云服务器默认开启交换分区
开启交换分区即可

dd if=/dev/zero of=/mnt/swap bs=512 count=8388616

mkswap /mnt/swap

vim /etc/sysctl.conf
修改vm.swappiness = 60 默认数值是0

swapon /mnt/swap

echo "/data/swap swap swap defaults 0 0" >> /etc/fstab

cat /proc/swaps 查看是否成功挂载

free 再次查看交换分区是否开启成功

2.5 安装Jenkins

0.rpm包下载位置,请注意版本,版本太低会导致后续安装不了插件
此处选择的版本没有问题,但是需要jdk11及以上,所以上述安装了两个jdk版本
https://mirrors.jenkins-ci.org/redhat/

1.下载Jenkins的RPM包,速度根据自身有快慢
wget https://mirrors.jenkins-ci.org/redhat/jenkins-2.389-1.1.noarch.rpm --no-check-certificate
2.安装
rpm -ivh jenkins-2.389-1.1.noarch.rpm

3.修改配置
vim /etc/sysconfig/jenkins

JENKINS_USER="root" #这里改为root
JENKINS_PORT="9898" #配置访问端口

4.关闭防火墙或者开启8088端口

5.配置jdk
vim /etc/init.d/jenkins 
在 candidates 内容最后添加本地安装jdk,必须11版本以上,该处选择17版本
该路径是你自己安装jdk的路径,如果路径和我一样可以直接复制
/usr/local/java/jdk-17.0.7

6.从新读取配置文件
systemctl daemon-reload

7.启动Jenkins
systemctl start jenkins

从新启动Jenkins指令:
systemctl restart jenkins


配置完启动不起来,报如下错误:
Job for jenkins.service failed because the control process exited with 
error code. See "systemctl status jenkins.service" and "journalctl -xe" for details.

可以不使用systemctl的方式去启动暂停Jenkins，直接用Jenkins自带的服务启动
其实systemctl最终也是执行的这个命令
cd /etc/init.d
# 从新启动
./jenkins restart
# 停止
./jenkins stop
# 状态
./jenkins status

9.访问
ip:port
192.168.56.137:9898

访问报如下错误:
AWT is not properly configured on this server. Perhaps you need to run 
your container with “-Djava.awt.headless=true”? See also: 
https://jenkins.io/redirect/troubleshooting/java.awt.headless

解决方案:
yum install -y dejavu-sans-fonts
yum install -y fontconfig
yum install -y xorg-x11-server-Xvfb

从新读取配置文件
systemctl daemon-reload

从新启动,确保在 /etc/init.d  执行该指令 从新启动后再次刷新访问
./jenkins restart

10.查看Jenkins密码
cat /var/lib/jenkins/secrets/initialAdminPassword

11.修改插件下载地址
sed -i 's/https:\/\/updates.jenkins.io\/download/http:\/\/mirrors.tuna.tsinghua.edu.cn\/jenkins/g' /var/lib/jenkins/updates/default.json && sed -i 's/http:\/\/www.google.com/https:\/\/www.baidu.com/g' /var/lib/jenkins/updates/default.json

12.进入 Manage Jenkins -> Manage Plugin -> Advanced 最下面有 Update Site 设置为：
https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json

13.重启Jenkins
ip:8088/restart

14.汉化Jenkins
Manage Jenkins -> Manage Plugin -> available
输入 Localization: Chinese (Simplified)
点击:install without restart

15.安装自动化部署所需插件
// git插件
Git client
// gitlab插件
GitLab
// ssh插件
SSH Credentials
// maven插件
Maven Integration

直接点击 安装完成后… 几个字即可

http的git地址一定加上端口

注意修改jar包的名称,可以直接将该脚本放在服务器,使用 bash /root/脚本名称 该处直接运行脚本

jarPath=/var/lib/jenkins/workspace/demo/target/ 是Jenkins构建后jar生成的位置
脚本这里自己注意修改一下

#!/bin/bash
workPath=/usr/local/project/test/
jarPath=/var/lib/jenkins/workspace/test/target/
jarName=test-0.0.1-SNAPSHOT.jar
mkdir -vp $workPath
echo "==========创建工作空间=========="
chmod 755 $workPath
pid=`ps -ef | grep test-0.0.1-SNAPSHOT.jar | grep -v grep | awk '{print $2}'`
if [ -n "$pid" ]
then
   kill -9 $pid
   echo "==========杀死存在进程=========="
fi
echo $workPath$jarName
echo $jarPath$jarName
if [ -e $workPath$jarName ]; then
   echo "==========启动文件存在, 执行删除启动文件=========="
   rm -rf $workPath$jarName
else
   echo "==========启动文件不存在=========="
fi
if [ -e $jarPath$jarName ]; then
   cp $jarPath$jarName $workPath
   echo "==========目标文件存在, 执行拷贝启动文件=========="
else
   echo "==========目标文件不存在=========="
fi
cd $workPath
export BUILD_ID=dontKillMe
echo "==========执行启动demo服务=========="
nohup java -jar test-0.0.1-SNAPSHOT.jar  > test-logs.log 2>&1 &
echo "==========启动成功demo服务=========="

16.如何卸载Jenkins
rpm -e jenkins
rpm -ql jenkins
find / -iname jenkins | xargs -n 1000 rm -rf

17.升级Jenkins
17.0关闭Jenkins服务
systemctl stop jenkins
systemctl status jenkins 

17.1下载war包 
https://mirrors.tuna.tsinghua.edu.cn/jenkins/war

17.2查找服务器Jenkinswar位置
find / -name jenkins.war

17.3进入war所在位置
cd /usr/lib/jenkins/

17.4将war移动到其他目录
mkdir /root/jenkins

17.5将下载的war包放入该文件
mv /root/jenkins.war ./

17.6启动服务
systemctl start jenkins

17.7注意Jenkins版本与jdk对应版本,否则启动失败

我码的累你看的也累,一键三连支持一下,谢谢大家了,不好的地方也欢迎大家指出,码字不易转载请注明出处