Gitlab-runner+Docker自动部署SpringBoot项目


本文基于Gitlab CI/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,从而执行相应的脚本程序实现自动部署。

Gitlab-runner+Docker自动部署SpringBoot项目

3.GitlabRunner 安装和注册

3.1 安装

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

总结一共就2个步骤:

1.添加gitlab官方库:

For Debian/Ubuntu/Mint

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

For RHEL/CentOS/Fedora

curl -L https://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。

Gitlab-runner+Docker自动部署SpringBoot项目

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

Gitlab-runner+Docker自动部署SpringBoot项目

3.GitlabRunner注册:

基本命令:

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

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

Gitlab-runner+Docker自动部署SpringBoot项目

  1. Enter the GitLab instance URL (for example, https://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)

  1. Enter optional maintenance note for the runner:
    输入可选维护说明
  2. 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:

Gitlab-runner+Docker自动部署SpringBoot项目

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

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

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

3个文件位置图

Gitlab-runner+Docker自动部署SpringBoot项目

.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 "https://mirror.tuna.tsinghua.edu.cn/alpine/v3.4/mainn https://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分支,可以到已经在跑了

Gitlab-runner+Docker自动部署SpringBoot项目

点进去看,出现问题

Gitlab-runner+Docker自动部署SpringBoot项目

Gitlab-runner+Docker自动部署SpringBoot项目

这里提示我们的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后台,这里手动再执行一次:

Gitlab-runner+Docker自动部署SpringBoot项目
最新的一次已通过 passed:

Gitlab-runner+Docker自动部署SpringBoot项目

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

Gitlab-runner+Docker自动部署SpringBoot项目

Gitlab-runner+Docker自动部署SpringBoot项目

cd到 项目的docker目录,使用

docker-compose logs -ft 

测试接口:

Gitlab-runner+Docker自动部署SpringBoot项目

6.常见问题

问题1:自动化部署build报错:
Gitlab-runner+Docker自动部署SpringBoot项目
解决方法,执行命令:

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 
发表评论

相关文章