本文基于Gitlab CI/CD及Docker快速實(shí)現(xiàn)項(xiàng)目的自動(dòng)部署。

注意：本文較長(zhǎng)，瀏覽需要12分鐘左右。

1.環(huán)境要求

以下服務(wù)器的操作系統(tǒng)均為Centos7

• 服務(wù)器A：Gitlab
• 服務(wù)器B：GitlabRunner、Docker、docker-compose、Java1.8、maven3.6.3、git

ps：這里可以把服務(wù)器B的GitlabRunner、Java1.8、maven3.6.3、git單獨(dú)提出來(lái)，獨(dú)立部署，需要java的原因是maven，maven用于打包。

應(yīng)用服務(wù)器B就只需要docker和docker-compose就可以了，為了演示方便，這里放一起的。

相關(guān)服務(wù)搭建教程參照官方文檔或其他第三方靠譜博客教程！

當(dāng)前我的服務(wù)版本

• Gitlab：14.9
• GitlabRunner：14.10.0
• docker：20.10.14
• docker-compose：1.29.2
• Git：2.31.1 ，事先檢查下Git是否最新版本，否則后面會(huì)出錯(cuò)。

2.主要流程

我們的主要流程就是通過(guò)Gitlab管理代碼，然后利用Gitlab自帶的Gitlab CI/CD功能與GitlabRunner進(jìn)行注冊(cè)綁定。

綁定成功后，每提交一次代碼，都可以觸發(fā)GitlabRunner，從而執(zhí)行相應(yīng)的腳本程序?qū)崿F(xiàn)自動(dòng)部署。

3.GitlabRunner 安裝和注冊(cè)

3.1 安裝

官方文檔安裝教程：https://docs.gitlab.com/runner/install/linux-manually.html

總結(jié)一共就2個(gè)步驟：

1.添加gitlab官方庫(kù)：

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 開(kāi)始注冊(cè)

1.打開(kāi)Gitlab需要自動(dòng)部署的倉(cāng)庫(kù)，選擇Setting-》CI / CD -》Runners。

2.如下圖，可以看到最關(guān)鍵的兩個(gè)信息，這倆待會(huì)GitlabRunner注冊(cè)的時(shí)候會(huì)用到.

3.GitlabRunner注冊(cè):

基本命令：

• 注冊(cè)：gitlab-runner register
• 查看已注冊(cè)Runner：gitlab-runner list
• 取消所有注冊(cè)：gitlab-runner unregister --all-runners

回到服務(wù)器B，執(zhí)行命令gitlab-runner register 注冊(cè)流程詳解：

• Enter the GitLab instance URL (for example, https://gitlab.com/):
  輸入gitlab的服務(wù)URL
• Enter the registration token:
  輸入令牌,參考上圖
• Enter a description for the runner:
  輸入Runner描述
• Enter tags for the runner (comma-separated)

給這個(gè)gitlab-runner輸入一個(gè)標(biāo)記，這個(gè)tag非常重要，在后續(xù)的使用過(guò)程中需要使用這個(gè)tag來(lái)指定gitlab-runner（yml文件，job通過(guò)設(shè)置tags標(biāo)簽選用指定的Runner)

• Enter optional maintenance note for the runner:
  輸入可選維護(hù)說(shuō)明
• Enter an executor: docker+machine, docker-ssh+machine, custom, docker-windows, docker-ssh, ssh, kubernetes, docker, parallels, shell, virtualbox:

回車結(jié)束，安裝gitlab-runner文件夾下會(huì)自動(dòng)生成config.

回到gitlab后臺(tái)Runner設(shè)置處，刷新頁(yè)面就可以看到新增的一個(gè)Runner:

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

當(dāng)提交代碼后，我們應(yīng)該怎么用Shell腳本來(lái)控制構(gòu)建和部署呢？Gitlab為我們提供好了一個(gè)模版，就是在倉(cāng)庫(kù)根目錄下創(chuàng)建名為：.gitlab-ci.yml 文件

這里以一個(gè)springboot項(xiàng)目為例子，在原項(xiàng)目基礎(chǔ)上增加了3個(gè)文件（.gitlab-ci.yml 、Dockerfile 、docker-compose.yml），下面展示了文件的位置和內(nèi)容，內(nèi)容根據(jù)你的需求修改就行了，需要熟悉Dockerfile 和 docker-compose.yml的一些基礎(chǔ)文件結(jié)構(gòu)及語(yǔ)法：

3個(gè)文件位置圖

.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
# 部署開(kāi)發(fā)服務(wù)器
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

在根目錄中創(chuàng)建Docker文件夾，

創(chuàng)建Dockerfile：

#FROM java:8 #java:8這個(gè)鏡像體積有643MB,打包鏡像后體積太大了,不建議使用
# openjdk:8-jre-alpine 體積最小,只有85MB
FROM openjdk:8-jre-alpine
# 以下2個(gè)RUN解決 java驗(yàn)證碼接口報(bào)錯(cuò)的問(wèn)題,
RUN echo -e "https://mirror.tuna.tsinghua.edu.cn/alpine/v3.4/main\n\
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

創(chuàng)建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.測(cè)試

本地idea提交一次代碼到dev分支，可以到已經(jīng)在跑了

點(diǎn)進(jìn)去看，出現(xiàn)問(wèn)題

這里提示我們的git版本太低了

當(dāng)前git版本：

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

升級(jí)最新版git后:

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

回到gitlab后臺(tái)，這里手動(dòng)再執(zhí)行一次：

最新的一次已通過(guò) passed：

查看日志的方法，進(jìn)第一個(gè)build查看日志，獲取項(xiàng)目的路徑（大家有更好的方法可以告訴下我）

cd到 項(xiàng)目的docker目錄，使用

docker-compose logs -ft

測(cè)試接口：

6.常見(jiàn)問(wèn)題

問(wèn)題1：自動(dòng)化部署build報(bào)錯(cuò)：

解決方法，執(zhí)行命令：

sudo chmod 777 /var/run/docker.sock

問(wèn)題2：docker apline temporary error (try again later) 錯(cuò)誤
沒(méi)有dns導(dǎo)致的

在本機(jī)系統(tǒng)上創(chuàng)建daemon文件添加dns，然后重啟docker

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

到此這篇關(guān)于Gitlab-runner+Docker自動(dòng)部署SpringBoot項(xiàng)目的文章就介紹到這了,更多相關(guān)Docker自動(dòng)部署SpringBoot項(xiàng)目?jī)?nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論