Docker自动部署Apache Tomcat

jopen 9年前

本文是Docker的入门文章,推荐Java开发者阅读。文章详细介绍了如何用Docker来安装部署Tomcat。

介绍

本文会讲述:
  1. 扩展Tomcat的官方Dockerfile
  2. 构建新的镜像
  3. 从修改过的新镜像启动容器
  4. 在容器里部署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]

官方网站描述了所支持的标签:
 Docker自动部署Apache Tomcat

我正在用的是版本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已经启动:
 Docker自动部署Apache 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

输出如下图:
 Docker自动部署Apache Tomcat

结论

什么是至关重要的?

我们不需要安装Tomcat,而是需要在Dockerfile定义,然后从镜像里启动容器。似乎看起来比下载Tomcat,解压,运行启动脚本要复杂一些。

这样做带来的好处包括:
  1. 不是所有应用都像Tomcat一样易于安装。
  2. 几乎所有应用在安装后都需要额外的配置。

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