Docker 学习 | 第八篇：Docker + Jenkins单机部署Spring Boot项目

Posted 2022-12-15 _wangjianfeng

Docker 学习 | 第八篇：Docker + Jenkins单机部署Spring Boot项目

前言

最近学了一段时间的jenkins以及Docker之后，自己进行了一些自动持续集成的相关实践。

在这里记录一下。

环境

本文所需环境如下：

• CentOs 7系统
• 已安装Docker
• 已安装配置完毕jenkins。包括全局工具配置中的JDK、Git、Maven

实现思路

通过在项目根目录下面维护一个Dockerfile以及一个shell脚本来完成以下工作：

• 构建项目
• 停止旧版本容器
• 移除旧版本容器
• 移除旧版本镜像
• 使用Dockerfile构建新的镜像
• 运行新的容器

Dockerfile内容

在项目根目录有一个Dockerfile文件：

# 以 java8镜像为基础构建
FROM java:8-jre

# 描述信息
MAINTAINER wangjianfeng <[e-mail]>

# 声明变量代表jar包的名字和端口号
ARG jarname
ARG port

# 添加当前目录下的jar文件到容器中的目录下
COPY ./target/$jarname /app/

# 指定容器内部时间
COPY /localtime /etc/localtime

# 指定容器内部时区
RUN echo "Asia/Shanghai" > /etc/timezone

# 声明暴露的端口
EXPOSE $port

# 声明启动容器的执行命令
ENTRYPOINT ["java","-Xmx200m", "-jar"]

通过上面的注释可以理解大概的意思。

通过传进来的参数指定应用程序的端口号，以及jar包的文件名，以便于将jar包复制到镜像中。

额外的配置了容器的时区以及时间(使用本机的)，最后声明了容器启动的命令。

Shell脚本内容

在项目根目录中有一个start.sh文件：

set +e

# 本脚本负责构建，移除旧的docker镜像，使用Dockfile构建镜像，创建容器
# 脚本接受2个参数，第一个为工作目录 第二个为profile

# 项目名称
name="xxxxxx"

# 项目版本
version="1.0"

# 工作目录为第一个参数
log_dir=$1;

# 环境为第二个参数
profile=$2

# 端口
port=8115

#jar包的文件名
jar_name=$name"-"$version".jar"

# 容器名字
container_name=$profile"-"$name

# 镜像名字
image_name=$profile"-"$name":v"$version

echo "Build Project......"

# 构建
mvn clean package -D maven.test.skip=true

runningContainer=`docker ps -a | grep $name`

# 检查容器是否在运行,停止容器,移除容器,删除镜像
if [ -n "$runningContainer" ]; then
    echo "Stop container "$container_name
    docker stop $container_name
    echo "Remove container "$container_name
    docker rm $container_name
    echo "Remove image "$image_name
    docker rmi $image_name
fi

echo "Build container from Dockerfile."

# 拷贝当前时间到工作目录，便于docker构建
cp /usr/share/zoneinfo/Asia/Shanghai ./localtime

# 构建
docker build --build-arg jarname=$jar_name --build-arg port=$port -t $image_name .

#删除文件
rm -f ./localtime

echo "Run the container for image name:"$image_name

# 运行容器指定暴露的端口和挂载的目录
docker run -d --name $container_name --net=host -v $log_dir/logs:/logs $image_name /app/$jar_name --spring.profiles.active=$profile

# 移除无用的镜像
if [ ! -n "$(docker images -f "dangling=true" -q)" ]; then
    docker rmi $(docker images -f "dangling=true" -q);
else
    echo "Not exists unused Images.";
fi;

该脚本声明了项目名称以及版本号，同时接受两个参数来指定log的目录以及SpringBoot项目的profiles。

上面代码也挺简单，就是指定了一些基本参数之后，停止容器，然后删除容器，移除镜像。

接着拷贝本机时间到当前目录，然后执行Dockerfile的构建。

构建的时候会传进去两个参数，分别为jar包名称以及log的目录。(这里要根据项目不同的日志配置修改哦。我的日志默认是打在容器的/logs目录,所以就挂载该目录)

构建镜像完毕之后，移除时间文件，然后直接启动容器，把相应的目录挂载到容器，容器的网络模式我这里为了方便直接使用host模式，在镜像名字后面跟着的是运行容器的参数。因为我声明的运行命令为：

ENTRYPOINT ["java","-Xmx200m", "-jar"]

所以最终容器运行的命令会变成：

java -Xmx200m -jar /app/$jar_name --spring.profiles.active=$profile

配置jenkins

配置jenkins也非常简单，只需要在构建栏添加Execute shell,然后填入一下内容:

chmod 777 start.sh
./start.sh /var/log/xxxx staging

上面命令会修改start.sh的文件权限，然后执行它，后面两个参数分别代表log文件的目录，以及SpringBoot的profiles参数。

这样配置起来整个流程就能工作了。

总结

本文记录了使用jenkins配合Docker持续集成SpringBoot项目的一些实践。