当前位置：首页 > 编程日记 > 正文

IDEA集成Docker插件实现一键自动打包部署微服务项目

编程日记 2024-03-10 08:30:00

一. 前言

大家在自己玩微服务项目的时候，动辄十几个服务，每次修改逐一部署繁琐不说也会浪费越来越多时间，所以本篇整理通过一次性配置实现一键部署微服务，实现真正所谓的一劳永逸。

二. 配置服务器

1. Docker安装

服务器需要安装Docker，如未安装参考这篇文章安装即可 Docker实战 | 第一篇：Linux 安装 Docker

2. Docker开启远程访问

vim /usr/lib/systemd/system/docker.service 
# 在ExecStart=/usr/bin/dockerd追加 -H tcp://0.0.0.0:2375 -H unix://var/run/docker.sock

# 重新启动

systemctl daemon-reload 
systemctl restart docker

# 开放2375端口

 firewall-cmd --zone=public --add-port=2375/tcp --permanent firewall-cmd --reload

3. 远程访问测试

# 查看端口监听是否开启 
netstat -nlpt 
# curl测试是否生效 
curl http://127.0.0.1:2375/info

二. 配置IDEA

IDEA安装Docker插件,打开插件市场（File->Settings->Plugins）

安装Docker插件后，配置Docker远程链接

三. Maven插件构建Docker镜像

1. Maven构建Docker镜像方式

IDEA中基于maven构建docker镜像有两种方式，分别docker-maven-plugin和dockerfile-maven，都是出自Spotify公司之手。

进入项目 https://github.com/spotify/docker-maven-plugin

其中有个很显眼的提示：

docker-maven-plugin可以不用Dockerfile,纯粹通过pom.xml的配置自动生成Dockerfile来构建Docker镜像。

dockerfile-maven依赖Dockerfile文件，需放到项目根目录下，也就是和pom.xml同级。

显然官方推荐的是 dockerfile-maven 这种依赖Dockerfile的方式,但是在部署 youlai-mall 项目使用 docker-maven-plugin 只要配置好 pom.xml 便无需修改外置配置了，所以更为方便省心，下面就这两种方式如何实现镜像构造进行逐一说明。其中统一以 youlai-mall 的 youlai-gateway 网关模块进行构建。

2. docker-maven-plugin方式构造镜像

(1). 配置pom.xml

<plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId></plugin><plugin><groupId>com.spotify</groupId><artifactId>docker-maven-plugin</artifactId><version>1.2.2</version><executions><!--执行mvn package,即执行 mvn clean package docker:build--><execution><id>build-image</id><phase>package</phase><goals><goal>build</goal></goals></execution></executions><configuration><!-- 镜像名称 --><imageName>${project.artifactId}</imageName><!-- 指定标签 --><imageTags><imageTag>latest</imageTag></imageTags><!-- 基础镜像--><baseImage>openjdk:8-jdk-alpine</baseImage><!-- 切换到容器工作目录--><workdir>/ROOT</workdir><entryPoint>["java","-jar","${project.build.finalName}.jar"]</entryPoint><!-- 指定远程 Docker API地址  --><dockerHost>http://192.168.10.12:2375</dockerHost><!-- 复制 jar包到docker容器指定目录--><resources><resource><targetPath>/ROOT</targetPath><!-- 用于指定需要复制的根目录，${project.build.directory}表示target目录 --><directory>${project.build.directory}</directory><!-- 用于指定需要复制的文件，${project.build.finalName}.jar就是打包后的target目录下的jar包名称　--><include>${project.build.finalName}.jar</include></resource></resources></configuration></plugin>

(2). maven打包制作镜像

项目是聚合工程，先全局执行 mvn install -DskipTests=true 完成安装模块jar包到本地仓库，不然模块之间的依赖会报错。

切到文件夹 youlai-gateway 执行项目的打包 mvn package -DskipTests=true, 在 package 生命周期完成镜像的生AA

(3). idea创建和启动容器

(4). 容器启动测试

3. dockerfile-maven方式构造镜像

(1). 创建Dockerfile

按照dockerfile-maven插件的使用说明，创建Dockerfile放置到项目根目录下(pom.xml同级)

FROM openjdk:8-jdk-alpine
VOLUME /tmp
ARG JAR_FILE
ADD target/${JAR_FILE} /app.jar
EXPOSE 9999
ENTRYPOINT ["java","-jar","/app.jar"]

Dockerfile参考Spring官方，参考链接 https://spring.io/guides/gs/spring-boot-docker/

指令	说明
FROM openjdk:8-jdk-alpine	基础镜像JDK，无则自动拉取镜像
VOLUME /tmp	挂载容器/tmp目录至宿主机，SpringBoot使用内置Tomcat，默认工作目录/tmp；VOLUME不能指定挂载目录，默认挂载到宿主机/var/lib/docker目录。
ARG JAR_FILE	变量声明，对应pom.xml的JAR_FILE标签的变量
ADD target/${JAR_FILE} /app.jar	复制jar包至容器并重命名为app.jar
EXPOSE 9999	声明容器暴露端口，仅仅声明无实际作用
ENTRYPOINT ["java","-jar","/app.jar"]	设定容器启动时第一个运行的命令及其参数

(2). 配置pom.xml

<build><plugins><plugin><groupId>com.spotify</groupId><artifactId>dockerfile-maven-plugin</artifactId><version>1.4.13</version><executions><execution><id>default</id><goals><goal>build</goal><goal>push</goal></goals></execution></executions><configuration><repository>${project.artifactId}</repository><tag>latest</tag><buildArgs><JAR_FILE>${project.build.finalName}.jar</JAR_FILE></buildArgs></configuration></plugin></plugins>
</build>

(3). 设置环境变量

dockerfile-maven插件默认的DOCKER_HOST=localhost:2375,如果需要构建镜像到服务器，需要修改DOCKER_HOST系统环境变量

如果DOCKER_HOST不固定的也可以设置临时变量方便灵活切换
set DOCKER_HOST=tcp://192.168.1.111:2375

(4). idea创建和启动容器

和 docker-maven-plugin 一致，请参考上文。

四. 结语

本文旨在使用IDEA搭配Docker插件快速构建Docker镜像实现一键部署SpringBoot项目，其中讲到两种方式，虽然 docker-maven-plugin 已被官方抛弃，但是在我这里部署 youlai-mall 使用优于 dockerfile-maven , 因为 dockerfile-maven 除了配置 pom.xml 、编写 DockerFile 文件之外还要配置系统环境变量。如果你的服务器不只一台呢，环境变量如何处理，切来切去吗？所以这两种插件如何选择，真要看自己的使用场景，不能盲目的人云亦云。尤其会在下一篇介绍如何避免Docker远程2375端口暴露被挖矿做改动时更能体现 docker-maven-plugin的优势。

https://www.dkcj.cn/info/2938.html