快捷導(dǎo)航

gitlab-runner結(jié)合docker部署項目全過程

更新時間：2026年05月13日 09:49:46 作者：Jurzis

本文介紹了使用GitLab和GitLab Runner自動化構(gòu)建Spring Boot項目的方法,搭建好GitLab和GitLab Runner后,在Spring Boot項目中創(chuàng)建.gitlab-ci.yml文件,配置腳本準(zhǔn)備Maven編譯項目、打包JAR包及運行JAR包,并在設(shè)置中配置CI/CD,這樣,點擊項目CI/CD即可自動化運行

前提

1.搭建好gitlab（直接拉下來安裝就好）

2.搭建好gitlab-runner（直接拉下來安裝就好）

3.安裝docker

使用gitlab創(chuàng)建一個springboot的工程

項目中會有一個.gitlab-ci.yml的文件

我根據(jù)我的要求更改文件如下：

variables:
  PROJECT_NAME: "ruoyi_test" #項目名稱，所有項目必須唯一  必填
  PORT: "8453" #運行在服務(wù)器的端口
  JAVA_OPTS: "-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5005" #jvm的參數(shù)，可不設(shè)置
  SPRING_OPTS: "" #spring的參數(shù)，可不設(shè)置
  JAR_PATH: "/ruoyi-admin"#打包jar的路徑 
  JAR_NAME: "ruoyi-admin.jar" #編譯出的jar文件名稱 必填
  PROJECT_PATH: "/project/ruoyi_admin" #項目運行的目錄 必填
stages:
- auto_deploy
- restart
build_and_start:
  stage: auto_deploy
  tags: 
  - local
  script:
  - echo "============上傳代碼============"
  - bash /home/gitlab-runner/script/prepare.sh "$PROJECT_NAME" "$JAR_NAME" "$PROJECT_PATH"
  - echo "============上傳代碼完畢，開始打包============"
  - bash /home/gitlab-runner/script/package.sh "$PROJECT_NAME" "$JAR_NAME" "$PROJECT_PATH" "$JAR_PATH"
  - echo "============打包完畢，開始運行============"
  - bash /home/gitlab-runner/script/run.sh "$JAR_NAME" "$PROJECT_PATH" "$PORT" "$JAVA_OPTS" "$SPRING_OPTS"
  when: manual
just_restart:
 stage: restart
 tags: 
 - local
 script:
 - bash /home/gitlab-runner/script/run.sh "$JAR_NAME" "$PROJECT_PATH" "$PORT" "$JAVA_OPTS" "$SPRING_OPTS"
 # 手動執(zhí)行
 when: manual

步驟

1.主要的邏輯都在腳本中，主要流程是，docker中使用maven鏡像，先從自己本地copy一份setting文件到/home/gitlab-runner/script目錄下（需要配置加速），方便maven打包更快。

2.prepare.sh腳本內(nèi)容，用于準(zhǔn)備maven編譯項目

#!/bin/bash
if [ -z "$1" ]; then 
  echo "未傳入項目名"
  exit 1
fi

if [ -z "$2" ]; then 
  echo "未傳入jar包名"
  exit 1
fi

if [ -z "$3" ]; then 
  echo "未傳入運行路徑"
  exit 1
fi

docker_name="$1"_maven
echo 即將創(chuàng)建docker-"$docker_name"
existflag=$(docker ps -a | grep "$docker_name")
echo $existflag
if [ -z "$existflag" ]; then
  docker run -itd --name $docker_name maven:3.6.0-jdk-8-alpine /bin/bash
else
  docker stop $docker_name
  docker rm $docker_name
  docker run -itd --name $docker_name maven:3.6.0-jdk-8-alpine /bin/bash
fi
docker cp /home/gitlab-runner/script/settings.xml "$docker_name":/usr/share/maven/conf/settings.xml;
docker cp ./ "$docker_name":/home/"$1";

2.package.sh腳本內(nèi)容，用戶編譯出jar包

#!/bin/bash

if [ -z "$1" ]; then 
  echo "未傳入項目名"
  exit 1
fi

if [ -z "$2" ]; then 
  echo "未傳入jar包名"
  exit 1
fi

if [ -z "$3" ]; then 
  echo "未傳入運行路徑"
  exit 1
fi
docker exec "$1"_maven bash -c "cd /home/$1; mvn clean; mvn package";
run_path=/ziyi"$3"
if [ ! -e $run_path ]; then
  mkdir -p $run_path
fi
docker cp "$1"_maven:/home/"$1""$4"/target/"$2" "$run_path"/"$2"
docker stop "$1"_maven
docker rm "$1"_maven

3.run.sh腳本內(nèi)容，用于執(zhí)行jar包。

#!/bin/bash

if [ -z "$1" ]; then 
  echo "未傳入jar包名"
  exit 1
fi

if [ -z "$2" ]; then 
  echo "未傳入運行路徑"
  exit 1
fi
if [ -e "/ziyi$2/pidfile.txt" ]; then
  process=$(ps aux | grep `cat "/ziyi$2/pidfile.txt"`)
  if [ ! -z process ]; then
    echo "關(guān)閉之前的"`cat "/ziyi$2/pidfile.txt"`
    kill -9 `cat "/ziyi$2/pidfile.txt"`
  fi
fi
echo "啟動-$2/$1-$4"
nohup java $4 -jar /ziyi$2/$1 --server.port=$3 $5 > /ziyi$2/logs.txt 2>&1 & echo $! > /ziyi$2/pidfile.txt

到這里點擊項目的CI/DI，項目就可以自動化運行了。（前提，需要在setting中設(shè)置一個ci/di，這個網(wǎng)上大部分教程都有）