目錄一、概述二、前期準(zhǔn)備三、總體架構(gòu)圖四、環(huán)境搭建1、環(huán)境準(zhǔn)備（可選）2、Gitlab安裝3、安裝 Runner4、安裝應(yīng)用服務(wù)器環(huán)境五、創(chuàng)建 SpringBoot 項(xiàng)目1、使用Gitlab Spring 模板快速創(chuàng)建一個(gè) SpringBoot 項(xiàng)目；2、添加環(huán)境變量（登錄應(yīng)用服務(wù)器密碼）六、總結(jié)一、概述

本文主要記錄如何通過(guò)Gitlab CI/CD自動(dòng)部署SpringBoot項(xiàng)目jar包。

二、前期準(zhǔn)備

準(zhǔn)備三臺(tái) CentOS7服務(wù)器，分別部署以下服務(wù)：

序號(hào) 系統(tǒng) IP 服務(wù) 1 CentOS7 192.168.56.10 Gitlab 2 CentOS7 192.168.56.11 Runner （安裝Docker） 3 CentOS7 192.168.56.12 SpringBoot 項(xiàng)目 jar 包（安裝jdk、maven等）

上述服務(wù)也可以只用一臺(tái)CentOS7，將所有程序都部署在同一機(jī)器上，但是更建議分開(kāi)部署；

三、總體架構(gòu)圖

說(shuō)明：

Gitlab Server 用于部署Gitlab遠(yuǎn)程倉(cāng)庫(kù)，對(duì)CPU和內(nèi)存要求比較高，建議4核CPU，4GB以上內(nèi)存； Runner Server 用于部署執(zhí)行.gitlab-ci.yml 文件中定義的 stage（階段）；需要具有訪問(wèn) Gitlab 倉(cāng)庫(kù)的權(quán)限，可以下載代碼，通過(guò)注冊(cè)方式（gitlab-runner register）實(shí)現(xiàn)； Your Laptop Server 用戶部署你的應(yīng)用程序，這里就是SpringBoot的 jar 包，需要提前安裝 JDK 和 Maven 并配置好環(huán)境變量； 四、環(huán)境搭建1、環(huán)境準(zhǔn)備（可選）

三臺(tái)服務(wù)器執(zhí)行以下命令：

yum -y upgradeyum -y install wgetyum -y install vim2、Gitlab安裝

參考地址：https://about.gitlab.com/install/#centos-7https://www.jb51.net/article/188877.htm

（1）安裝并配置必要的依賴

sudo yum install -y curl policycoreutils-python openssh-serversudo systemctl enable sshdsudo systemctl start sshdsudo firewall-cmd --permanent --add-service=httpsudo firewall-cmd --permanent --add-service=httpssudo systemctl reload firewalld

（2）安裝郵件服務(wù)

sudo yum install postfixsudo systemctl enable postfixsudo systemctl start postfix

（3）添加 gitlab 鏡像

參考地址：https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7/

wget https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7/gitlab-ce-13.4.0-ce.0.el7.x86_64.rpm

（4）安裝 gitlab 安裝命令

rpm -i gitlab-ce-13.4.0-ce.0.el7.x86_64.rpm --nodeps --force

安裝成功后圖片：

（5）修改gitlab配置文件指定服務(wù)器ip和自定義端口

vim /etc/gitlab/gitlab.rb

（6）重置并啟動(dòng)GitLab

gitlab-ctl reconfiguregitlab-ctl restart

提示 'ok: run:'表示啟動(dòng)成功

（7）訪問(wèn) GitLab頁(yè)面

如果報(bào)502，等待一段時(shí)間后再刷新試試，一般1-2分鐘左右。

本文設(shè)置的賬號(hào)：root ，新密碼：11112222

3、安裝 Runner

參考官方文檔：https://docs.gitlab.com/runner/install/linux-manually.html#install-gitlab-runner-manually-on-gnulinux 中的 Using binary file Install

（1）下載一個(gè)二進(jìn)制文件

sudo curl -L --output /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-amd64

（2）修改執(zhí)行權(quán)限

sudo chmod a+x /usr/local/bin/gitlab-runner

（3）創(chuàng)建 GitLab CI 用戶

sudo useradd --comment ’GitLab Runner’ --create-home gitlab-runner --shell /bin/bash

（4）安裝并作為服務(wù)運(yùn)行

sudo gitlab-runner install --user=gitlab-runner --working-directory=/home/gitlab-runnersudo gitlab-runner start

如果遇到提示 sudo: gitlab-runner: command not found，切換到 root 用戶，可以去掉 sudo 執(zhí)行上面命令。

（5）注冊(cè) Runner

參考地址：https://docs.gitlab.com/runner/register/index.html執(zhí)行 gitlab-runner register 命令：

[root@localhost bin]# gitlab-runner registerRuntime platform arch=amd64 os=linux pid=21527 revision=4e1f20da version=13.4.0Running in system-mode.Please enter the gitlab-ci coordinator URL (e.g. https://gitlab.com/):http://192.168.56.10/Please enter the gitlab-ci token for this runner:PwF1sZPX_zsB-xChSKjHPlease enter the gitlab-ci description for this runner:[localhost.localdomain]: test ci cd descPlease enter the gitlab-ci tags for this runner (comma separated):my-tag,other-tagRegistering runner... succeeded runner=PwF1sZPXPlease enter the executor: ssh, virtualbox, parallels, shell, docker-ssh, docker+machine, docker-ssh+machine, kubernetes, custom, docker:dockerPlease enter the default Docker image (e.g. ruby:2.6):maven:3.3.9-jdk-8Runner registered successfully. Feel free to start it, but if it’s running already the config should be automatically reloaded!

注：這里選擇的docker方式，所以服務(wù)器上還需要額外多安裝docker參考：https://zhuanlan.zhihu.com/p/54147784

#!/bin/bash# 移除掉舊的版本sudo yum remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-selinux docker-engine-selinux docker-engine# 刪除所有舊的數(shù)據(jù)sudo rm -rf /var/lib/docker# 安裝依賴包sudo yum install -y yum-utils device-mapper-persistent-data lvm2# 添加源，使用了阿里云鏡像sudo yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo# 配置緩存sudo yum makecache fast# 安裝最新穩(wěn)定版本的dockersudo yum install -y docker-ce# 配置鏡像加速器sudo mkdir -p /etc/dockersudo tee /etc/docker/daemon.json <<-’EOF’{ 'registry-mirrors': ['http://hub-mirror.c.163.com']}EOF# 啟動(dòng)docker引擎并設(shè)置開(kāi)機(jī)啟動(dòng)sudo systemctl start dockersudo systemctl enable docker# 配置當(dāng)前用戶對(duì)docker的執(zhí)行權(quán)限sudo groupadd dockersudo gpasswd -a ${USER} dockersudo systemctl restart docker

這里注冊(cè)一個(gè)全局共享的 Runner（管理員權(quán)限，復(fù)制服務(wù)器地址和 Token），所有項(xiàng)目都可以使用，或者也可以注冊(cè)項(xiàng)目級(jí)別單獨(dú)的 Runner （進(jìn)入項(xiàng)目 Runner 設(shè)置頁(yè)面，復(fù)制地址和 Token）。

注冊(cè)成功后，Runner 列表可以查看到注冊(cè)的 Runner

勾選：Run untagged jobs Indicates whether this runner can pick jobs without tags

4、安裝應(yīng)用服務(wù)器環(huán)境

（1）允許用戶遠(yuǎn)程登錄（可選）

vi /etc/ssh/sshd_config修改：PasswordAuthentication yes PermitRootLogin yes重啟服務(wù)：service sshd restart

（2）安裝JDK1.8

（1）下載地址：http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html（2）解壓

tar -zxvf jdk-8u161-linux-x64.tar.gz重命名：mv jdk1.8.0_161 java1.8

（3）配置環(huán)境變量

vi /etc/profile添加以下內(nèi)容：export JAVA_HOME=/usr/local/java1.8export PATH=$JAVA_HOME/bin:$PATHexport CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar保存退出source /etc/profilejava -version

（3） 安裝 Maven3.3.9

（1）下載地址：http://maven.apache.org/download.cgi（2）解壓

tar -zxvf apache-maven-3.3.9-bin.tar.gz 重命名：mv apache-maven-3.3.9 maven-3.3.9

（3）配置環(huán)境變量

vi /etc/profile添加以下內(nèi)容：export MAVEN_HOME=/usr/local/maven-3.3.9export PATH=$MAVEN_HOME/bin:$PATH保存退出source /etc/profilemvn -v五、創(chuàng)建 SpringBoot 項(xiàng)目1、使用Gitlab Spring 模板快速創(chuàng)建一個(gè) SpringBoot 項(xiàng)目；

如果報(bào)錯(cuò)，刪除pom.xml中的這行

報(bào)這個(gè)錯(cuò)的話：[FATAL] Non-resolvable parent POM for com.example:demo:0.0.1-SNAPSHOT: Could not transfer artifact org.springframework.boot:spring-boot-starter-parent:pom:2.0.1.RELEASE from/to central (https://repo.maven.apache.org/maven2): Connect to repo.maven.apache.org:443 [repo.maven.apache.org/151.101.40.215] failed: Connection timed out (Connection timed out) and ‘parent.relativePath’ points at wrong local POM @ line 14, column 10

修改版本1.5.9.RELEASE

2、添加環(huán)境變量（登錄應(yīng)用服務(wù)器密碼）

注： 其中 ssh_password 這個(gè)添加到環(huán)境變量中，取消勾選 Protect Branch （僅保護(hù)分支）；修改和添加都是默認(rèn)勾選，需要取消，否則，其他分支不能讀取到該變量；

先在應(yīng)用服務(wù)器上創(chuàng)建一個(gè)目錄，用于上傳存放項(xiàng)目 jar 包：

mkdir gitlab-project

添加 .gitlab-ci.yml 文件時(shí)，可以先再 CI/CD Pipeline 中 的 CI Lint 中檢驗(yàn) .gitlab-ci.yml 文件格式

# 定義一些變量, 下面各階段會(huì)使用variables: server_ip: 192.168.56.12 jar_name: demo-0.0.1-SNAPSHOT.jar java_path: /usr/local/java1.8/bin upload_path: /usr/local/gitlab-project# 定義執(zhí)行的各個(gè)階段及順序stages: - build - upload - deploy# 使用 maven 鏡像打包項(xiàng)目maven-build: stage: build image: maven:3.5.0-jdk-8 script: - mvn package -B -Dmaven.test.skip=true cache: key: m2-repo paths: - .m2/repository artifacts: paths: - target/$jar_name# 上傳生成的 jar 包到你的應(yīng)用服務(wù)器，這里使用 ictu/sshpass 這個(gè)鏡像，是為了使用 sshpass 命令upload-jar: stage: upload image: ictu/sshpass script: - ls -l target/ - sshpass -p $ssh_password scp -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no target/$jar_name root@$server_ip:$upload_path/$jar_name# 啟動(dòng) SpringBoot jar包deploy-test: stage: deploy image: ictu/sshpass script: - sshpass -p $ssh_password ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no root@$server_ip 'nohup $java_path/java -jar $upload_path/$jar_name >/dev/null 2>&1 &'

這里使用了DockerHub上面的一個(gè)公共鏡像（ictu/sshpass），主要是想使用啟動(dòng)自帶的sshpass命令執(zhí)行scp和ssh命令。如果一切順利的話，就會(huì)自動(dòng)觸發(fā) CI/CD ；失敗的話查看報(bào)錯(cuò)信息，可使用 Debug 模式執(zhí)行調(diào)試命令 。

[root@localhost gitlab-project]# jps22119 Jps22073 demo-0.0.1-SNAPSHOT.jar[root@localhost gitlab-project]# curl localhost:8080Spring is here!

可能遇到的問(wèn)題總結(jié)：

權(quán)限問(wèn)題：可以先使用 root 用戶看看是不是權(quán)限問(wèn)題導(dǎo)致，如果是的話，提升執(zhí)行用戶的權(quán)限；并發(fā)問(wèn)題：這里沒(méi)有修改 Runner 的并發(fā)數(shù)，可以修改同時(shí)可以進(jìn)行的任務(wù)并發(fā)數(shù)；其他問(wèn)題：讀取不到配置的環(huán)境變量，取消勾選僅保護(hù)分支的選項(xiàng)； 未執(zhí)行job：沒(méi)有勾選未配置 tags 也執(zhí)行選項(xiàng)；六、總結(jié)

使用GitLab自帶的CICD功能部署SpringBoot項(xiàng)目非常方便，前期環(huán)境搭建可能需要花一點(diǎn)時(shí)間學(xué)習(xí)，但是后期部署項(xiàng)目可以省去很多人為操作失誤，對(duì)于小型團(tuán)隊(duì)來(lái)說(shuō)，Gitlab自帶的CICD功能比Jenkins更加簡(jiǎn)單，總體思想步驟是:

搭建GitLab服務(wù)；搭建GitLab Runner服務(wù)；搭建應(yīng)用服務(wù)；編寫(xiě)gitlab-ci.yml;對(duì)于SpringBoot項(xiàng)目來(lái)說(shuō)，一般分為：（1）maven 打包；（2）上傳jar包；（3）啟動(dòng)jar包；

到此這篇關(guān)于Gitlab CI-CD自動(dòng)化部署SpringBoot項(xiàng)目的方法步驟的文章就介紹到這了,更多相關(guān)Gitlab CI-CD自動(dòng)化部署SpringBoot 內(nèi)容請(qǐng)搜索好吧啦網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持好吧啦網(wǎng)！