怎么把Java
应用打包成Docker镜像?对熟悉Docker
的同学这应该是一个很简单的问题,把项目打包成JAR
包然后在Dockerfile
里用ADD
命令把JAR
文件放到镜像里,启动命令设置执行这个JAR
文件即可。
比如一个使用Maven构建的Spring应用就可以用下面这个Dockerfile
构建镜像。
FROM openjdk:8-jre
ADD target/*.jar /application.jar
ENTRYPOINT ["java", "-jar","/application.jar"]
复制代码
上面这个Dockerfile很好理解,使用Maven构建的Java项目的目录结构统一是
project
│ pom.xml
└───src // 源文件目录
│ │
│ └───main
│ │
│ └───java
│
└───target // class和jar文件的目录
复制代码
用mvn clean package
打包后会把JAR
文件生成在target
目录里,通过java -jar
命令即可执行编译好的程序。
所以上面的Dockerfile里就进行了把JAR
从target
目录里添加到Docker镜像中以及将jar -jar /application.jar
设置成容器的启动命令这两部操作。
不过除了这种最原始的方法外我们还可以使用Maven
的一些插件,或者Docker
的多阶段打包功能来完成把Java
应用打包成Docker
镜像的动作。
Maven插件构建镜像
Spotify公司的dockerfile-maven-plugin
和Google公司出品的jib-maven-plugin
是两款比较有名的插件,下面简单介绍一下dockerfile-maven-plugin
的配置和使用。
其实使用方法很简单,我们在POM文件里引入这个plugin,并结合上面那个Dockerfile就能让插件帮助我们完成应用镜像的打包。
<groupId>com.example</groupId>
<artifactId>hello-spring</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>helloworld</name>
<plugin>
<groupId>com.spotify</groupId>
<artifactId>dockerfile-maven-plugin</artifactId>
<version>1.4.10</version>
<executions>
<execution>
<id>default</id>
<goals>
<goal>build</goal>
<goal>push</goal>
</goals>
</execution>
</executions>
<configuration>
<repository>${docker.registry.url}/${image.prefix}/${artifactId}</repository>
<tag>${project.version}</tag>
<buildArgs>
<JAR_FILE>${project.build.finalName}.jar</JAR_FILE>
</buildArgs>
</configuration>
</plugin>
复制代码
插件里使用的docker.registry.url
和image.prefix
是我单独为Docker
的镜像仓库设置的属性。
<properties>
<java.version>1.8</java.version>
<image.prefix>kevinyan001</image.prefix>
<docker.registry.url></private.registry.url>
</properties>
复制代码
这里可以随意设置成私有仓库的远程地址和镜像前缀,比如在阿里云的镜像服务上创建一个叫docker-demo
的空间,上面的属性就需要这样配置:
<properties>
<java.version>1.8</java.version>
<image.prefix>docker-demo</image.prefix>
<docker.registry.url>registry.cn-beijing.aliyuncs.com</docker.registry.url>
</properties>
复制代码
在POM文件里配置好插件后伴随着我们打包应用执行mvc clean package
操作时dockerfile-maven-plugin
就会自动根据我们的配置打包好一个叫做kevinyan001/hello-spring:0.0.1-SNAPSHOT
的Docker镜像。
dockerfile-maven-plugin
除了能帮助我们打包应用镜像外还可以让它帮助我们把镜像push到远端仓库,不过我觉得用处不大,感兴趣的同学可以去网上搜搜看这部分功能怎么配置。
用Docker的多阶段构建打包镜像
上面介绍了使用Maven
插件帮助我们打包Java
应用的镜像,其实我们还可以把mvn clean package
这一步也交给Docker
来完成。当然把Java应用的源码放在Docker
镜像里再编译打包在发布出去肯定是有问题的,我们知道在Dockerfile
里每个指令ADD
、RUN
这些都是在单独的层上进行,指令越多会造成镜像越大,而且包含Java
项目的源码也是一种风险。
不过好在后来Docker
支持了多阶段构建,允许我们在一个Dockerfile
里定义多个构建阶段,先拉起一个容器完成用于的构建,比如说我们可以在这个阶段里完成JAR
的打包,然后第二个阶段重新使用一个jre
镜像把上阶段打包好的JAR
文件拷贝到新的镜像里。
这一点在Go语言比较有优势,第一阶段编译好的二进制执行文件直接拷贝到一个最基础的
linux
镜像里就能让Go的应用在容器里运行。关于Go应用的多阶段打包,可以查看我以前的文章线上Go项目的Docker镜像应该怎么构建? 进行了解。
使用下面的Dockerfile
可以通过多阶段构建完成Java
应用的Docker
镜像打包。
# Dockerfile也可以不放在项目目录下,通过 -f 指定Dockerfile的位置,比如在项目根下执行以下命令
docker build -t <some tag> -f <dirPath/Dockerfile> .
FROM kevinyan001/aliyun-mvn:0.0.1 AS MAVEN_BUILD
COPY pom.xml /build/
COPY src /build/src
WORKDIR /build/
# mount anonymous host directory as .m2 storage for contianer
VOLUME /root/.m2
RUN mvn clean package -Dmaven.test.skip=true --quiet
FROM openjdk:8-jre
COPY --from=MAVEN_BUILD /build/target/*.jar /app/application.jar
ENTRYPOINT ["java", "-jar", "/app/application.jar"]
复制代码
上面我们用的这些Dockerfile也可以不用放在项目的根目录里,现在已经支持通过 -f
指定Dockerfile
的位置,比如在项目根下执行以下命令完成镜像的打包。
docker build -t kevinyan001/hello-spring:0.0.1 -f <dirPath/Dockerfile> .
复制代码
上面第一个镜像是我自己做的,因为Maven官方的镜像的远程仓库慢的一批,只能自己包装一下走阿里云的镜像源了。试了试速度也不快,主要是随随便便一个Spring
项目依赖就太多了。大家如果这块有什么加快Docker
构建速度的方法也可以留言一起讨论讨论。
不可否认用多阶段构建打出来的Go
镜像基本上是10M左右,但是Spring
的应用随随便便就是上百兆,这个对容器的构建速度、网络传输成本是有影响的,那么Spring
应用的镜像怎么瘦身呢,这个就留到以后的文章进行探讨了。