Docker多步构建更小的Java镜像

译者按: 最新版Docker将支持多步构建(Multi-stage build)，这样使用单个Dockerfile就能够定义多个中间镜像用于构建，测试以及发布等多个步骤，而且有效减少最终镜像的大小。

原文: Creating Smaller Java Image using Docker Multi-stage Build

译者: Fundebug

为了保证可读性，本文采用意译而非直译。

Github仓库: arun-gupta/docker-java-multistage

DockerCon 2017中与Java开发者直接相关的内容有:

• Docker多步构建(Docker Multi-stage build)
• Oracle JRE in Docker Store

这篇博客介绍了为何须要Docker多步构建(Docker Multi-stage build)，而且经过一个示例展现了如何构建更小的Java镜像。

为何须要多步构建?

为Java应用构建Docker镜像意味着编译源代码以及打包目标代码。开发者一般会使用Maven或者Gradle来构建JAR或WAR文件。若使用Maven镜像做为基础镜像来构建Java应用，则须要下载全部Maven依赖。下载的JAR包数目由pm.xml决定，有可能会很是多。这样的话，生成的Docker镜像中将留下太多多余的文件。

下面为示例Dockerfile:

FROM maven:3.5-jdk-8
 
COPY src /usr/src/myapp/src
COPY pom.xml /usr/src/myapp
RUN mvn -f /usr/src/myapp/pom.xml clean package
 
ENV WILDFLY_VERSION 10.1.0.Final
ENV WILDFLY_HOME /usr
 
RUN cd $WILDFLY_HOME && curl http://download.jboss.org/wildfly/$WILDFLY_VERSION/wildfly-$WILDFLY_VERSION.tar.gz | tar zx && mv $WILDFLY_HOME/wildfly-$WILDFLY_VERSION $WILDFLY_HOME/wildfly
 
RUN cp /usr/src/myapp/target/people-1.0-SNAPSHOT.war $WILDFLY_HOME/wildfly/standalone/deployments/people.war
 
EXPOSE 8080
 
CMD ["/usr/wildfly/bin/standalone.sh", "-b", "0.0.0.0"]

由Dockerfile可知:

• maven:3.5-jdk-8 是基础镜像
• 将源代码拷贝到镜像中
• Maven用于构建应用
• 下载并安装WildFly
• 将生成的.war文件拷贝到WildFly的deployments目录
• 启动WildFly

这个Dockefile存在这些问题：

• 使用Maven做为基础镜像的话，还须要安装和配置WildFly。
• 构建应用时须要下载不少Maven依赖，它们会继续留在镜像中，可是运行应用时并不须要它们。这致使了镜像过大。
• 修改WildFly版本则须要修改Dockerfile，并从新构建镜像。若是直接使用WildFly镜像做为基础镜像，状况会简单不少。
• 打包应用以前，须要进行单元测试，那么，测试的依赖也须要留在生成的镜像中，这实际上是不必的。

固然，也能够采用其余方式构建Docker镜像。好比，能够将Dockerfile拆分为两个。第一个Dockerfile以Maven镜像为基础镜像，用于构建应用，并将构建好的.war文件经过数据卷(volume)复制到共享的目录；第二个Dockerfile以WildFly镜像做为基础镜像，从数据卷将.war文件拷贝出来就行了。这个方法也是有问题的，由于须要维护多个Dockerfile，而且经过数据卷拷贝文件也不方便。

什么是Docker多步构建？

多步构建(multi-stage build)容许在Dockerfile中使用多个FROM指令。两个FROM指令之间的全部指令会生产一个中间镜像，最后一个FROM指令以后的指令将生成最终镜像。中间镜像中的文件能够经过COPY --from=<image-number>指令拷贝，其中image-number为镜像编号，0为第一个基础镜像。没有被拷贝的文件都不会存在于最终生成的镜像，这样能够减少镜像大小。

FROM指令可使用as <stage-name>来指定步骤名称(stage name):

FROM maven:3.5-jdk-8 as BUILD

这样的话，COPY指令的--from选项可使用步骤名称代替镜像编号。

下面为示例Dockerfile:

FROM maven:3.5-jdk-8 as BUILD
 
COPY src /usr/src/myapp/src
COPY pom.xml /usr/src/myapp
RUN mvn -f /usr/src/myapp/pom.xml clean package
 
FROM jboss/wildfly:10.1.0.Final
 
COPY --from=BUILD /usr/src/myapp/target/people-1.0-SNAPSHOT.war /opt/jboss/wildfly/standalone/deployments/people.war

由Dockerfile可知:

• 一共有两个FROM指令，所以为两步构建。
• maven:3.5-jdk-8 是第一步构建的基础镜像。这一步用于构建应用的WAR文件。这一步的名称为build。
• jboss/wildfly:10.1.0.Final 是第二步构建的基础镜像。第一步构建的WAR文件经过COPY --from指令拷贝到WildFly的deloyments目录。

Docker多步构建有什么好处？

• 仅须要一个Dockerfile来定义整个构建过程。这样，不须要定义多个Dockerfile，也不须要使用数据卷来拷贝文件。
• 能够为最终镜像选择合适的基础镜像，来知足生产环境的需求，这样能够有效减少最终镜像的大小。另外，构建步骤的多余文件都被丢弃了。
• 使用官方的WildFly镜像做为生产镜像的基础镜像，而不是手动安装和配置WildFly。这样，WildFly升级时将很是方便。

**注：**Docker多步构建正在开发中，尚未正式发布。能够经过 curl -fsSL https://test.docker.com/ | sh命令安装最新的测试版Docker试用多步构建。

使用第一个Dockerfile构建的镜像为816MB，而使用多步构建的话，镜像只有584MB。

docker-java-multistage $ docker images
REPOSITORY                          TAG                 IMAGE ID            CREATED             SIZE
people                              multistage          d36a4b82ad87        59 seconds ago      584MB
people                              singlestage         13dbcf8f54f6        5 minutes ago       816MB

可知，使用多步构建能够有效减少镜像大小。

查看PR #31257，有更加详细的讨论。

欢迎加入咱们Fundebug的Docker技术交流群: 305097057。

版权声明:

转载时请注明做者Fundebug以及本文地址：

https://blog.fundebug.com/2017/05/02/about-docker-sock/