如何使用Gitlab-runner和Docker自动化部署SpringBoot应用？

本文共计1827个文字，预计阅读时间需要8分钟。

基于Gitlab CI/CD及Docker快速实现项目的自动部署。

注意：本文内容较长，浏览需12分钟。

1. 环境需求以下服务器操作系统要求：- 服务器A：CentOS 7- 服务器B：Gitlab + Gitlab Runner + Docker + d

2. 安装Gitlab（1）安装必要的依赖sudo yum install -y curl openssh-server postfix

（2）添加Gitlab仓库curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash

（3）安装Gitlabsudo yum install -y gitlab-ce

（4）配置Gitlab编辑`/etc/gitlab/gitlab.rb`文件，配置Gitlab服务external_url 'http://gitlab.example.com'

（5）重启Gitlab服务sudo gitlab-ctl reconfigure

3. 安装Gitlab Runner（1）安装Gitlab Runner依赖sudo yum install -y git

（2）添加Gitlab Runner仓库curl https://packages.gitlab.com/install/repositories/runner/gitlab-ci-multi-runner/script.rpm.sh | sudo bash

（3）安装Gitlab Runnersudo yum install -y gitlab-ci-multi-runner

（4）配置Gitlab Runner编辑`/etc/gitlab-runner/gitlab-ci-multi-runner.toml`文件，配置Gitlab Runner服务[runners] [runners.my-runner] url='http://gitlab.example.com' token='your_token' executor='docker' [runners.my-runner.config] image='docker:stable'

（5）启动Gitlab Runnersudo gitlab-ci-multi-runner start

4. 安装Docker（1）安装必要的依赖sudo yum install -y yum-utils device-mapper-persistent-data lvm2

（2）添加Docker仓库sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

（3）安装Dockersudo yum install -y docker-ce

（4）启动Docker服务sudo systemctl start docker

（5）使Docker服务开机自启sudo systemctl enable docker

5. 部署项目（1）在Gitlab仓库中创建`.gitlab-ci.yml`文件，配置自动化部署流程stages: - deploy

deploy_job: stage: deploy script: - echo Deploying application... - docker-compose up -d

（2）推送代码到Gitlab仓库git push origin main

（3）Gitlab Runner会自动执行`.gitlab-ci.yml`文件中的部署任务，实现项目的自动部署。

至此，基于Gitlab CI/CD及Docker的自动化部署流程已配置完成。

本文基于GitlabCI/CD及Docker快速实现项目的自动部署。

注意：本文较长，浏览需要12分钟左右。

1.环境要求

以下服务器的操作系统均为Centos7

• 服务器A：Gitlab
• 服务器B：GitlabRunner、Docker、docker-compose、Java1.8、maven3.6.3、git

ps：这里可以把服务器B的GitlabRunner、Java1.8、maven3.6.3、git单独提出来，独立部署，需要java的原因是maven，maven用于打包。

应用服务器B就只需要docker和docker-compose就可以了，为了演示方便，这里放一起的。

相关服务搭建教程参照官方文档或其他第三方靠谱博客教程！

当前我的服务版本

• Gitlab：14.9
• GitlabRunner：14.10.0
• docker：20.10.14
• docker-compose：1.29.2
• Git：2.31.1 ，事先检查下Git是否最新版本，否则后面会出错。

2.主要流程

我们的主要流程就是通过Gitlab管理代码，然后利用Gitlab自带的Gitlab CI/CD功能与GitlabRunner进行注册绑定。

绑定成功后，每提交一次代码，都可以触发GitlabRunner，从而执行相应的脚本程序实现自动部署。

3.GitlabRunner 安装和注册 3.1 安装

官方文档安装教程：docs.gitlab.com/runner/install/linux-manually.html

总结一共就2个步骤： 1.添加gitlab官方库：

For Debian/Ubuntu/Mint

curl -L packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh | sudo bash

For RHEL/CentOS/Fedora

curl -L packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh | sudo bash 2.命令安装:

For Debian/Ubuntu/Mint

sudo apt-get install gitlab-ci-multi-runner

For RHEL/CentOS/Fedora

sudo yum -y install gitlab-ci-multi-runner 3.2 开始注册

1.打开Gitlab需要自动部署的仓库，选择Setting-》CI / CD -》Runners。

2.如下图，可以看到最关键的两个信息，这俩待会GitlabRunner注册的时候会用到.

3.GitlabRunner注册:

基本命令：

• 注册：gitlab-runner register
• 查看已注册Runner：gitlab-runner list
• 取消所有注册：gitlab-runner unregister --all-runners

回到服务器B，执行命令gitlab-runner register 注册流程详解：

1. Enter the GitLab instance URL (for example, gitlab.com/):
   输入gitlab的服务URL
2. Enter the registration token:
   输入令牌,参考上图
3. Enter a description for the runner:
   输入Runner描述
4. Enter tags for the runner (comma-separated)

给这个gitlab-runner输入一个标记，这个tag非常重要，在后续的使用过程中需要使用这个tag来指定gitlab-runner（yml文件，job通过设置tags标签选用指定的Runner)

5. Enter optional maintenance note for the runner:
   输入可选维护说明
6. Enter an executor: docker+machine, docker-ssh+machine, custom, docker-windows, docker-ssh, ssh, kubernetes, docker, parallels, shell, virtualbox:

回车结束，安装gitlab-runner文件夹下会自动生成config.

回到gitlab后台Runner设置处，刷新页面就可以看到新增的一个Runner:

4.制作脚本! 重要!!!

当提交代码后，我们应该怎么用Shell脚本来控制构建和部署呢？Gitlab为我们提供好了一个模版，就是在仓库根目录下创建名为：.gitlab-ci.yml文件

这里以一个springboot项目为例子，在原项目基础上增加了3个文件（.gitlab-ci.yml 、Dockerfile 、docker-compose.yml），下面展示了文件的位置和内容，内容根据你的需求修改就行了，需要熟悉Dockerfile 和 docker-compose.yml的一些基础文件结构及语法：

3个文件位置图

.gitlab-ci.yml

stages: - build - deploy_dev - clean # 打包镜像 build: stage: build only: - dev script: - $MAVEN_HOME/bin/mvn clean package '-Dmaven.test.skip=true' - cp ./XXX/target/XXX.jar docker/ - cd docker - docker build -t dev/XXX:v1.0.0 . tags: - maven # 部署开发服务器 deploy_dev: stage: deploy_dev only: - dev script: - cd docker - docker-compose down - docker-compose up -d tags: - maven #清理虚悬镜像 clean: stage: clean only: - dev script: - docker rmi $(docker images -q -f dangling=true) tags: - maven

在根目录中创建Docker文件夹，

创建Dockerfile：

#FROM java:8 #java:8这个镜像体积有643MB,打包镜像后体积太大了,不建议使用 # openjdk:8-jre-alpine 体积最小,只有85MB FROM openjdk:8-jre-alpine # 以下2个RUN解决 java验证码接口报错的问题, RUN echo -e "mirror.tuna.tsinghua.edu.cn/alpine/v3.4/main\n\ mirror.tuna.tsinghua.edu.cn/alpine/v3.4/community" > /etc/apk/repositories RUN apk --update add curl bash ttf-dejavu && \ rm -rf /var/cache/apk/* COPY . /opt/app WORKDIR /opt/app

创建docker-compose.yml ：

version: '3.1' services: education-course: container_name: dev-XXX-server restart: always image: dev/XXX:v1.0.0 network_mode: "host" volumes: - /opt/XXX-server/logs:/XXX/logs command: java -jar -Xms1024m -Xmx1024m -Duser.timezone=GMT+08 xxx.jar --spring.profiles.active=dev 5.测试

本地idea提交一次代码到dev分支，可以到已经在跑了

点进去看，出现问题

这里提示我们的git版本太低了

当前git版本：

[root@localhost local]# git --version git version 1.8.3.1

升级最新版git后:

[root@localhost yum.repos.d]# git --version git version 2.24.4

回到gitlab后台，这里手动再执行一次：

最新的一次已通过 passed：

查看日志的方法，进第一个build查看日志，获取项目的路径（大家有更好的方法可以告诉下我）

cd到 项目的docker目录，使用

docker-compose logs -ft

测试接口：

6.常见问题

问题1：自动化部署build报错：

解决方法，执行命令：

sudo chmod 777 /var/run/docker.sock

问题2：docker apline temporary error (try again later) 错误
没有dns导致的

在本机系统上创建daemon文件添加dns，然后重启docker

vim /etc/docker/daemon.json { "dns": ["8.8.8.8"] } sudo service docker restart