如何把 Java Web 应用放在 docker 容器中运行
本文适合 docker 零基础,且希望使用 docker 运行 Java Web 应用的人士。因为是傻瓜教程,这里没有使用 docker 的高级功能,本教程旨在用最简单方法实现目标。
安装 docker
Docker 的安装资源文件存放在Amazon,由于国内特殊的网络环境,安装时,会间歇性连接失败,所以直接从 docker 官网下载速度非常慢,建议使用国内的Daocloud提供的安装方案。
Ubuntu, Debian, Centos等大部分Linux用户可以通过以下脚本直接安装:
curl -sSL https://get.daocloud.io/docker | sh
如果安装不成功,可以选择使用二进制包安装方式。 下载二进制包。
其它系统:
Docker for Windows在Windows上运行Docker。系统要求,Windows10x64位,支持Hyper-V。
Docker for Mac在Mac上运行Docker。系统要求,OS X 10.10.3 或者更高版本,至少4G内存,4.3.30版本以前的VirtualBox会与Docker for Mac产生冲突,所以请卸载旧版本的VitrualBox。
如果您的电脑版本过旧,可以使用Docker Toolbox在Windows或者Mac上运行Docker。适用于Mac OS X 10.8+ 或者 Windows 7/8.1。
注意:Docker Toolbox 对 CPU 有要求,如果 CPU 只支持32位系统,则可能无法使用。所以推荐使用 Linux 、 Windows10 或 OS X 10.10.3以上版本。
在部署好 docker 环境的计算机的任意位置创建一个文件夹作为制作 docker 镜像的工作文件夹,下面我们就把这个文件夹称为workdir
将 Java Web 应用导出 war 包,将 war 包复制到workdir中。
编写 Dockerfile
在workdir中创建一个名为 Dockerfile 的文件,文件内容如下:
FROM tomcat:7.0
MAINTAINER admin <admin@domain.com>
ADD ./*.war /usr/local/tomcat/webapps/
EXPOSE 8080
根据实际情况,该文件可能要进行一些修改。
下面对该 Dockerfile 进行详解:
FROM行:
表示该应用的基础包。因为是 Java Web 的应用,我们这里使用了 tomcat 的基础包。如果你的 Java Web 应用对 tomcat 的版本或 JRE 的版本有特殊的要求,可以制定基于某个版本的 tomcat。所有的版本如下:
6.0.48-jre7, 6.0-jre7, 6-jre7, 6.0.48, 6.0, 6 (6/jre7/Dockerfile)
6.0.48-jre8, 6.0-jre8, 6-jre8 (6/jre8/Dockerfile)
7.0.73-jre7, 7.0-jre7, 7-jre7, 7.0.73, 7.0, 7 (7/jre7/Dockerfile)
7.0.73-jre7-alpine, 7.0-jre7-alpine, 7-jre7-alpine, 7.0.73-alpine, 7.0-alpine, 7-alpine (7/jre7-alpine/Dockerfile)
7.0.73-jre8, 7.0-jre8, 7-jre8 (7/jre8/Dockerfile)
7.0.73-jre8-alpine, 7.0-jre8-alpine, 7-jre8-alpine (7/jre8-alpine/Dockerfile)
8.0.39-jre7, 8.0-jre7, 8-jre7, jre7, 8.0.39, 8.0, 8, latest (8.0/jre7/Dockerfile)
8.0.39-jre7-alpine, 8.0-jre7-alpine, 8-jre7-alpine, jre7-alpine, 8.0.39-alpine, 8.0-alpine, 8-alpine, alpine (8.0/jre7-alpine/Dockerfile)
8.0.39-jre8, 8.0-jre8, 8-jre8, jre8 (8.0/jre8/Dockerfile)
8.0.39-jre8-alpine, 8.0-jre8-alpine, 8-jre8-alpine, jre8-alpine (8.0/jre8-alpine/Dockerfile)
8.5.9-jre8, 8.5-jre8, 8.5.9, 8.5 (8.5/jre8/Dockerfile)
8.5.9-jre8-alpine, 8.5-jre8-alpine, 8.5.9-alpine, 8.5-alpine (8.5/jre8-alpine/Dockerfile)
9.0.0.M15-jre8, 9.0.0-jre8, 9.0-jre8, 9-jre8, 9.0.0.M15, 9.0.0, 9.0, 9 (9.0/jre8/Dockerfile)
9.0.0.M15-jre8-alpine, 9.0.0-jre8-alpine, 9.0-jre8-alpine, 9-jre8-alpine, 9.0.0.M15-alpine, 9.0.0-alpine, 9.0-alpine, 9-alpine (9.0/jre8-alpine/Dockerfile)
将冒号后面的部分替换为要求的版本。
MAINTAINER行:
内容替换为制作镜像的作者(就是你)和联系方式。
ADD行:
该行的含义是把 war 包导入到镜像中的指定位置(也就是 tomcat 的 webapp 目录下)。该行如无意外一般不需要修改。
EXPOSE行:
该行意为将 tomcat 的端口暴露出来, tomcat 的默认端口为8080,该行一般不需要修改。
构建镜像
首先请确认你的当前目录是workdir,然后执行命令:
docker build -t <image name>:<tag> .
这里有两个参数。
<image name>:这个是你要制作的镜像的名称,这个名称要求是英文,不得有特殊字符,比如说可以叫:mywebsite
<tag>:这个是版本号,可以写为该 Web 项目的版本号,比如说:v0.1
注意,该命令的最后有一个., 这个表示 Dockerfile 所在的路径(更新:经评论中的朋友提醒,此处的路径应表述为 Dockerfile 要运行的context, 如上文所述,Dockerfile 和编译镜像所需的 war 包都在这个路径中),因为你的当前目录就是workdir,而 Dockerfile 在workdir里,所以这里只需要写.表示当前目录即可。
那么在这个例子中,这条命令就应该写成:
docker build -t mywebsite:v0.1 .
当看到Successfully built 01a82bc1cf37的字样时,说明镜像构建成功了,这时通过docker images命令可以看到刚才制作的镜像。
启动容器
最后一步是启动容器,启动命令为:
docker run -d -p <host port>:<container port> <image name>:<tag>
<host port>:这个是你暴露在宿主机上的端口,也就是最终用户访问的端口,比如说 8081。
<container port>:这个是容器内对应的端口,也就是我们上面写在 Dockerfile 中 EXPOSE 一行的端口号,此例中为 8080。
<image name>&<tag>参见上一节,此例中为:mywebsite:v0.1
所以这条命令在此例中应当写成:
docker run -d -p 8081:8080 mywebsite:v0.1
如果你的应用需要环境变量,则可以在 docker run 后面添加-e "<key1>=<value1>" -e "<key2>=<value2>" ...
至此,你的 Web 应用已经跑在 docker 容器里了,相应地你可以通过<host ip>:<host port>/访问 tomcat 和你的网站。