SpringBoot 实战电商项目 mall（50k+star）地址：github.com/macrozheng/…

摘要之前写过一篇文章《再见 Jenkins ！几行脚本搞定自动化部署，这款神器有点厉害！》 ,讲的是使用 Gogs+Drone 来实现自动化部署。最近发现 Gitlab 的 CI/CD 功能也能实现自动化部署，用起来也挺简单！如果你使用的是 Gitlab 作为 Git 仓库的话，不妨试试它的 CI/CD 功能。本文还是以 SpringBoot 的自动化部署为例，实践下 Gitlab 的 CI/DI 功能，希望对大家有所帮助！安装

通过 Gitlab 的 CI/CD 功能实现自动化部署，我们需要安装 Gitlab、Gitlab Runner、Maven 这些服务。

安装 Gitlab

首先我们来安装下 Gitlab，对 Gitlab 安装和使用不了解的朋友可以参考下《10 分钟搭建自己的 Git 仓库》 。

使用如下命令运行 Gitlab 服务，这里需要注意的是添加了 hostname 属性，这样我们就可以通过域名来访问 Gitlab 了（为了避免一些不必要的麻烦），GITLAB_ROOT_PASSWORD 这个环境变量可以直接设置 Gitlab 中 root 账号的密码；

docker run --detach

--hostname git.macrozheng.com

--publish 10443:443 --publish 1080:80 --publish 1022:22

--name gitlab

--restart always

--volume /mydata/gitlab/config:/etc/gitlab

--volume /mydata/gitlab/logs:/var/log/gitlab

--volume /mydata/gitlab/data:/var/opt/gitlab

-e GITLAB_ROOT_PASSWORD=12345678

gitlab/gitlab-ce:latest 复制代码

我们需要通过 git.macrozheng.com 这个域名来访问 Gitlab，如果你没有域名的话，可以通过修改本机的 host 文件来实现；

192.168.7.134 git.macrozheng.com 复制代码

由于我们的 Gitlab 运行在 1080 端口上，我们想要不加端口来访问，可以使用 Nginx 来反向代理下，对 Nginx 不熟悉的朋友可以看下《Nginx 的这些妙用，你肯定有不知道的！》 ，在 Nginx 的配置文件夹中添加 git.conf 配置文件，内容如下：

server {listen 80; # 同时支持 HTTPserver_name git.macrozheng.com; #修改域名

location / {    proxy_pass   http://192.168.7.134:1080; # 设置代理服务访问地址    index  index.html index.htm;}
error_page   500 502 503 504  /50x.html;location = /50x.html {    root   /usr/share/nginx/html;}

}复制代码

之后我们就可以通过 git.macrozheng.com 这个域名来访问 Gitlab 了，输入账号密码 root:12345678 即可登录；

将我们的 SpringBoot 应用代码上传到 Gitlab 上去，这样 Gitlab 就准备完毕了！这里需要注意的是，如果你在启动 Gitlab 的时候没有指定 hostname 的话，你的项目 HTTP 访问地址会是容器的 ID，使用该地址会无法访问 Git 仓库！

安装 Gitlab Runner

Gitlab 只是个代码仓库，想要实现 CI/CD 还需安装 gitlab-runner，gitlab-runner 相当于 Gitlab 中任务的执行器，Gitlab 会在需要执行任务时调用它。

首先下载 gitlab-runner 的 Docker 镜像，选用 alpine-bleeding，这个版本非常小巧！

docker pull gitlab/gitlab-runner:alpine-bleeding 复制代码

使用如下命令运行 gitlab-runner；

docker run --name gitlab-runner --restart always

-v /var/run/docker.sock:/var/run/docker.sock

-v /mydata/gitlab-runner:/etc/gitlab-runner

-d gitlab/gitlab-runner:alpine-bleeding 复制代码

此时我们如果查看 gitlab-runner 的容器日志的话，会发现如下错误，config.toml 文件找不到，这个问题不必担心，当我们将 gitlab-runner 注册到 Gitlab 时，会自动生成该文件；

ERROR: Failed to load config stat /etc/gitlab-runner/config.toml: no such file or directory builds=0 复制代码

接下来我们需要把 gitlab-runner 注册到 Gitlab，打开 Project->Settings->CI/CD 功能，获取到 runner 注册需要使用的地址和 token；

接下来使用如下命令，进入 gitlab-runner 容器的内部；

docker exec -it gitlab-runner /bin/bash 复制代码

在容器内使用如下命令注册 runner；

gitlab-runner register 复制代码

注册时会出现交互界面，提示你输入注册地址、token、执行器类型等信息，ssh 执行器能远程执行 Linux 命令，非常好用，推荐使用这个！

注册完成后，我们可以发现 config.toml 文件已经生成，内容如下，以后想修改 runner 配置的时候，直接改这个文件就行了。

concurrent = 1check_interval = 0

[session_server]session_timeout = 1800

[[runners]]name = "docker-runner"url = "http://192.168.7.134:1080/"token = "c2kpV6tX6woL8TMxzBUN"executor = "ssh"[runners.custom_build_dir][runners.cache][runners.cache.s3][runners.cache.gcs][runners.cache.azure][runners.ssh]user = "root"password = "123456"host = "192.168.7.134"port = "22"复制代码

在 Gitlab 的 CI/CD 设置中，我们可以发现，有个 runner 成功注册了！

安装 Maven

SpringBoot 项目打包需要依赖 Maven，我们需要在服务器上先安装好它。

下载 Maven 的 Linux 安装包，下载地址：maven.apache.org/download.cg…

下载完成后使用如下命令解压到指定目录；

cd /mydatatar -zxvf apache-maven-3.8.1-bin.tar.gz 复制代码

修改/etc/profile 文件，添加环境变量配置：

export MAVEN_HOME=/mydata/apache-maven-3.8.1export PATH=$PATH:$MAVEN_HOME/bin 复制代码

通过查看 Maven 版本来测试是否安装成功。

mvn -v 复制代码 Maven home: /mydata/apache-maven-3.8.1Java version: 1.8.0_292, vendor: AdoptOpenJDK, runtime: /mydata/java/jdk1.8/jreDefault locale: en_US, platform encoding: UTF-8OS name: "linux", version: "3.10.0-957.el7.x86_64", arch: "amd64", family: "unix"复制代码安装 JDK

CentOS 上默认安装的是 JRE，使用 Maven 需要安装 JDK。

下载 JDK 8，下载地址：mirrors.tuna.tsinghua.edu.cn/AdoptOpenJD…

下载完成后将 JDK 解压到指定目录；

cd /mydata/javatar -zxvf OpenJDK8U-jdk_x64_linux_xxx.tar.gzmv OpenJDK8U-jdk_x64_linux_xxx.tar.gz jdk1.8 复制代码

在/etc/profile 文件中添加环境变量 JAVA_HOME。

vi /etc/profile

在 profile 文件中添加

export JAVA_HOME=/mydata/java/jdk1.8export PATH=$PATH:$JAVA_HOME/bin

使修改后的 profile 文件生效

. /etc/profile 复制代码使用

一切准备就绪，接下来通过 Gitlab 的 CI/CD 功能就可以实现 SpringBoot 应用的自动化部署了！

首先在项目的根目录下添加.gitlab-ci.yml 文件，定义了两个任务，一个任务会将应用代码打包成 Jar 包并复制到指定目录，另一个任务会通过运行脚本 run.sh 打包应用的 Docker 镜像并运行；

打包任务

build-job:stage: build

指定标签，只有具有该标签的 runner 才会执行

tags:- dockerscript:# 使用 Maven 打包- mvn clean package# 将 jar 包、Dockerfile、运行脚本复制到指定目录- cp target/mall-tiny-gitlab-1.0-SNAPSHOT.jar /mydata/build/mall-tiny-gitlab-1.0-SNAPSHOT.jar- cp Dockerfile /mydata/build/Dockerfile- cp run.sh /mydata/build/run.sh

部署任务

deploy-job:stage: deploytags:- dockerscript:# 进入指定目录并执行运行脚本- cd /mydata/build- chmod +x run.sh- ./run.sh 复制代码

这里值得一提的是，默认情况下 runner 只会执行具有相同标签的 Job，由于我们对 Job 和 runner 都设置了标签为 docker，所以我们这里是可以执行的。如果你没有设置标签的话，需要在 runner 的编辑界面设置下让 runner 可以执行没有标签的 Job；

由于我们的 gitlab-runner 采用的是 ssh 的执行器，它会登录到我们指定的服务器，执行我们在.gitlab-ci.yml 中定义的 script 命令，在此之前还会先从 Git 仓库中获取代码，所以我们还需修改下服务器上的 host 文件；

vim /etc/hosts192.168.7.134 git.macrozheng.com 复制代码

接下来就是要把脚本提交到 Git 仓库上去，提交后会在 Project->CI/CD->Pipelines 中发现正在执行的任务；

打开 Pipeline 的详情页面，可以发现我们定义的两个任务都已经执行成功了；

打开 Job 的详情界面，我们可以看到任务执行过程中输出的日志信息；

如果你想手动执行 Pipeline，而不是提交触发的话，可以在 Pipelines 页面点击 Run Pipeline 按钮即可；

运行成功后，可以通过如下地址访问项目：http://192.168.7.134:8088/swagger-ui/

总结如果你用 Gitlab 作为 Git 仓库的话，使用它的 CI/CD 功能来实现自动化部署确实很不错！安装一个轻量级 gitlab-runner，编写简单的.gitlab-ci.yml 脚本文件即可实现。其实我们之前以及介绍过很多种自动化部署方案，比如 Jenkins、Gogs+Drone、Gitlab CI/CD，我们可以发现一个共同点，这些方案都离不开 Linux 命令。 所以说要想玩转自动化部署，还是得先玩转 Linux 命令！参考资料