Docker自动部署Apache Tomcat
jopen
10年前
本文是Docker的入门文章，推荐Java开发者阅读。文章详细介绍了如何用Docker来安装部署Tomcat。
介绍
本文会讲述：- 扩展Tomcat的官方Dockerfile
- 构建新的镜像
- 从修改过的新镜像启动容器
- 在容器里部署RESTful的Web服务并测试
Apache Tomcat
使用docker search可以查到最流行的（和官方的）Docker Tomcat容器：$ sudo docker search tomcat [sudo] password for craig: NAME DESCRIPTION STARS OFFICIAL AUTOMATED tomcat Apache Tomcat is an open source implementa... 103 [OK] tutum/tomcat Tomcat image - listens in port 8080. For t... 38 [OK] consol/tomcat-7.0 Tomcat 7.0.57, 8080, "admin/admin" 12 [OK] consol/tomcat-8.0 Tomcat 8.0.15, 8080, "admin/admin" 9 [OK] consol/tomcat-6.0 Tomcat 6.0.43, 8080, "admin/admin" 6 [OK] consol/tomcat-4.1 Tomcat 4.1.40, 8080, "admin/admin" 4 [OK] consol/tomcat-5.0 Tomcat 5.0.30, 8080, "admin/admin" 4 [OK] consol/tomcat-5.5 Tomcat 5.5.36, 8080, "admin/admin" 4 [OK] consol/tomcat-3.3 Tomcat 3.3.2, 8080, "admin/admin" 4 [OK] readytalk/tomcat-native Debian backed Tomcat + Tomcat Native Library 3 [OK] malderhout/tomcat Tomcat7 with OpenJDK7 on CentOS7 3 [OK] dordoka/tomcat Ubuntu 14.04, Oracle JDK 8 and Tomcat 8 ba... 3 [OK] meirwa/spring-boot-tomcat-mysql-app a sample spring-boot app using tomcat and ... 2 [OK] h2000/docker-tomcat-youtrack Dockerfile for youtrack to run under tomcat. 1 [OK] nicescale/tomcat Tomcat service for NiceScale. http://nices... 1 [OK] dmean/liferay-tomcat Debian + Liferay CE Tomcat 1 [OK] atomi/tomcat 0 [OK] mminke/apache-tomcat A Docker image which contains the Apache T... 0 [OK] ericogr/tomcat Tomcat 8.0.21, 8080, "docker/docker" 0 [OK] holmes/tomcat 0 [OK] paulkling/tomcat 0 [OK] dynamind/tomcat 0 [OK] fabric8/tomcat-8.0 runs Apache Tomcat 8.0 with jolokia enable... 0 [OK] learninglayers/tomcat 0 [OK] dmglab/tomcat CentOS 7 based tomcat installation 0 [OK]
官方网站描述了所支持的标签：
我正在用的是版本7，所以选择了tomcat:7。
我是使用Docker的新手（在写这边文章的时候），因此不想称此文是“最佳实践”。本文所写的是我认为好用的实践，如果有不同意见也请告诉我。对于每一 个想要启动的Docker容器，我都创建了自己的Dockerfile并且扩展了镜像。当然也完全可以不扩展镜像，而直接使用它。不过基于目标镜像构建我 们自己的镜像应该是能稳定扩展别人工作成果的更合适的方式。
本文示例中，创建了一个简单的Dockerfile，如下：
FROM tomcat:7-jre7 MAINTAINER "Craig Trim <craigtrim@gmail.com>"
用如下命令构建镜像：
$ sudo docker build -t craig/tomcat .
这样扩展的一个好处是简化了环境。最终，我要为Eclipse、MySQL和其它应用使用容器。我会给每个应用一个简化的命名空间和镜像名称。做项目的时 候，我推荐使用项目的代码名称作为容器的命名空间。我也简化了标签名称。这些都是很小的注意事项，不过又很重要。在大型项目中，有很多开发人员参与，这样 的方式就会很有帮助。通用的命名空间，简化的镜像名称和标签，会帮助项目成员更方便得使用官方项目镜像。
我的示例如下：
tomcat:7-jre7 ns/tomcat mysql:5.6.23 ns/mysql fgrehm/eclipse:v4.4.1 ns/eclipse
ns代表命名空间，每个项目成员都能理解。启动容器只需要记住项目代码名（命名空间）和应用名称即可。
运行Tomcat
如下命令会运行Tomcat，并将容器的8080端口暴露到宿主机器的8080端口：$ sudo docker run -p 8080:8080 craig/tomcat
如果还需要从这个镜像启动容器，只需要：
$ sudo docker run -p 8081:8080 craig/tomcat
测试tomcat已经启动：
扩展Dockerfile
我需要扩展Dockerfile，来实现Maven的自动部署。需要添加settings.xml，更新tomcat-user.xml文件。如下所示：tomcat-users.xml:
<?xml version='1.0' encoding='utf-8'?> <tomcat-users> <role rolename="manager-gui"/> <role rolename="manager-gui"/> <role rolename="manager-script"/> <user username="craig" password="password" roles="manager,manager-gui,manager-script" /> </tomcat-users>
settings.xml:
<?xml version="1.0" encoding="UTF-8"?> <settings> <servers> <server> <id>TomcatServer</id> <username>craig</username> <password>password</password> </server> </servers>
这些文件和Dockerfile放在同一个目录下。
Dockerfile更新为：
FROM tomcat:7-jre7 MAINTAINER "Craig Trim <craigtrim@gmail.com>" ADD settings.xml /usr/local/tomcat/conf/ ADD tomcat-users.xml /usr/local/tomcat/conf/
当镜像构建时，配置文件会被放置到正确目录下。从这个镜像启动的任意容器都会包含这些文件。
重构镜像
用之前的方法重新构建镜像：$ sudo docker build -t craig/tomcat . Sending build context to Docker daemon 5.632 kB Sending build context to Docker daemon Step 0 : FROM tomcat:7-jre7 ---> 77eb038c09d1 Step 1 : MAINTAINER "Craig Trim <craigtrim@gmail.com>" ---> Using cache ---> cadc51a3054c Step 2 : ADD settings.xml /usr/local/tomcat/conf/ ---> Using cache ---> 5009ba884f1f Step 3 : ADD tomcat-users.xml /usr/local/tomcat/conf/ ---> Using cache ---> 33917c541bb5 Successfully built 33917c541bb5
可以查看镜像历史：
$ sudo docker history craig/tomcat IMAGE CREATED CREATED BY SIZE 33917c541bb5 4 hours ago /bin/sh -c #(nop) ADD file:c1d08c42d5808537b4 1.761 kB 5009ba884f1f 4 hours ago /bin/sh -c #(nop) ADD file:5dd8f0f6d0cd64de3c 212 B cadc51a3054c 4 hours ago /bin/sh -c #(nop) MAINTAINER "Craig Trim <cra 0 B 77eb038c09d1 3 weeks ago /bin/sh -c #(nop) CMD [catalina.sh run] 0 B a96609fc8364 3 weeks ago /bin/sh -c #(nop) EXPOSE map[8080/tcp:{}] 0 B ca99125fbf51 3 weeks ago /bin/sh -c curl -SL "$TOMCAT_TGZ_URL" -o tomc 13.63 MB e7ca14a4280a 3 weeks ago /bin/sh -c #(nop) ENV TOMCAT_TGZ_URL=https:// 0 B eac866e259d8 3 weeks ago /bin/sh -c #(nop) ENV TOMCAT_VERSION=7.0.59 0 B d391d657b53a 3 weeks ago /bin/sh -c #(nop) ENV TOMCAT_MAJOR=7 0 B 7b323fd1e0d3 3 weeks ago /bin/sh -c gpg --keyserver pool.sks-keyserver 113.9 kB 4412b8a11fb6 3 weeks ago /bin/sh -c #(nop) WORKDIR /usr/local/tomcat 0 B b4ec9d590927 3 weeks ago /bin/sh -c mkdir -p "$CATALINA_HOME" 0 B 681b802059fe 3 weeks ago /bin/sh -c #(nop) ENV PATH=/usr/local/tomcat/ 0 B 11b245da4142 3 weeks ago /bin/sh -c #(nop) ENV CATALINA_HOME=/usr/loca 0 B 44faa7b2809f 3 weeks ago /bin/sh -c apt-get update && apt-get install 164.5 MB 42c3653e1b26 3 weeks ago /bin/sh -c #(nop) ENV JAVA_DEBIAN_VERSION=7u7 0 B 45ff981e92b4 3 weeks ago /bin/sh -c #(nop) ENV JAVA_VERSION=7u75 0 B 5e9b188bc82c 3 weeks ago /bin/sh -c apt-get update && apt-get install 676 kB 1073b544a1cb 3 weeks ago /bin/sh -c apt-get update && apt-get install 44.34 MB 50ec2d202fe8 3 weeks ago /bin/sh -c #(nop) CMD [/bin/bash] 0 B 3b3a4796eef1 3 weeks ago /bin/sh -c #(nop) ADD file:fb7c52fc8e65391715 122.8 MB 511136ea3c5a 21 months ago 0 B所做的变动是四小时之前发生的。现在可以从修改过的镜像启动容器，来测试自动化部署。
部署到Tomcat
这可能应该是另外一篇教程的主题，不过检验Tomcat安装是否成功的最佳方式就是部署一个WAR文件。我用Maven创建了一个简单的JavaEE项目，结构如下：$ tree . +-- pom.xml +-- src ¦ +-- main ¦ ¦ +-- java ¦ ¦ +-- com ¦ ¦ +-- trimc ¦ ¦ +-- blogger
如下插件（在pom.xml文件里）指定了部署信息，包括暴露的端口和用户名密码：
<plugin> <groupId>org.apache.tomcat.maven</groupId> <artifactId>tomcat7-maven-plugin</artifactId> <version>2.2</version> <configuration> <url>http://localhost:8080/manager/text</url> <server>TomcatServer</server> <path>/sample</path> <username>craig</username> <password>password</password> </configuration> </plugin>
使用Maven将其部署到Tomcat：
$ mvn tomcat7:deploy [INFO] Scanning for projects... [INFO] [INFO] ------------------------------------------------------------------------ [INFO] Building Test Runtime 1.0.0 [INFO] ------------------------------------------------------------------------ [INFO] *** SNIP *** [INFO] --- tomcat7-maven-plugin:2.2:deploy (default-cli) @ sandbox-web2 --- [INFO] Deploying war to http://localhost:8080/test Uploading: http://localhost:8080/manager/text/deploy?path=%2Ftest Uploaded: http://localhost:8080/manager/text/deploy?path=%2Ftest (1352 KB at 18512.6 KB/sec) [INFO] tomcatManager status code:200, ReasonPhrase:OK [INFO] OK - Deployed application at context path /test [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 3.495 s [INFO] Finished at: 2015-03-31T19:08:12-07:00 [INFO] Final Memory: 15M/506M [INFO] ------------------------------------------------------------------------
Tomcat日志显示如下：
Apr 01, 2015 2:08:12 AM com.sun.jersey.server.impl.application.WebApplicationImpl _initiate INFO: Initiating Jersey application, version 'Jersey: 1.9 09/02/2011 11:17 AM' Apr 01, 2015 2:08:12 AM org.apache.catalina.startup.HostConfig deployWAR INFO: Deployment of web application archive /usr/local/tomcat/webapps/test.war has finished in 826 ms
输出如下图：
结论
什么是至关重要的？我们不需要安装Tomcat，而是需要在Dockerfile定义，然后从镜像里启动容器。似乎看起来比下载Tomcat，解压，运行启动脚本要复杂一些。
这样做带来的好处包括：
- 不是所有应用都像Tomcat一样易于安装。
- 几乎所有应用在安装后都需要额外的配置。
Docker的作用有点类似Vagrant/Puppet/Chef/Ansible等。需要写一个脚本定义环境，之后build工具就可以自动 搭建出环境。在这里Docker的优势显而易见，那就是比虚拟机更为轻量。大多数情况下，就为了使用Tomcat而占用整个虚拟机会造成资源的浪费。而且 很多程序员是在笔记本上工作，也很难同时启动多个虚拟机。
这也就是Docker的第三个好处：可以从同一个镜像启动多个容器。启动多个容器所占用的资源比启动多个虚拟机要少得多，启动时间也非常快。
参考资料
1. REST Webapp示例2. WAR文件 在这里
3. Apache Tomcat Dockerfile
4. Maven：构建自动化工具
5. JAX-RS介绍(RESTFul Web服务的Java API)
原文链接：Docker and Apache Tomcat（翻译：崔婧雯 校对：李颖杰）
来自：http://dockerone.com/article/285