乐趣区

实战docker编写Dockerfile定制tomcat镜像实现web应用在线部署

jiezi

最初在 tomcat 上部署 web 应用的方式，是通过 maven 的 maven-compiler-plugin 插件先打成 war 包，再将 war 包复制到 tomcat 的 webapps 目录下，后来用上了 tomcat7-maven-plugin 插件，可以直接在 maven 上编译，打包，部署一次性完成，这个方法的关键是在 tomcat 上创建一个用户账号，然后 maven 插件用此账号和密码来执行在线部署。
本次实践中，我们要动手制作一个镜像，这个镜像 run 起来后是个 tomcat server，这个 server 支持 maven 插件在线部署 war 应用。
首先是创建 maven 工程，这是一个 spring mvc 的工程，并且 pom 文件中使用了 tomcat7-maven-plugin 插件，工程里面的代码很简单，只有一个 controller，返回 hello 页面，具体的代码可以在我的 git 下载，地址是：https://github.com/zq2599/blo…，您也可以指执行命令 <font color=”blue”>git clone git@github.com:zq2599/blog_demos.git</font> 来获得，下载后整个文件夹下有多个工程，本次实战用到的是 <font color=”blue”>loadbalancedemo</font>，如下图下图红框所示，建议用 intellJ Idea 以 maven 工程的形式导入：

![这里写图片描述](https://image-static.segmentfault.com/279/116/279116141-5d675bc0a25b8_articlex)

打开工程中的 pom.xml 文件，可以看到最底部的 plugin 节点的值：

<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>tomcat7</server>
<path>/${project.artifactId}</path>
<update>true</update>
</configuration>
</plugin>

代码方面就先到这里，接下来我们开始制作 docker 镜像文件了，让我们先把准备工作做好：

  1. 创建一个空文件夹，例如 image_tomcat；
  2. 去 tomcat 官网下载 tomcat 安装包，解压后，将 conf 文件夹下的 server.xml 和 tomcat-users.xml 这两个文件复制到前面新建的 image_tomcat 目录下面；
  3. 修改 server.xml 文件，如下图，在 port 等于 8080 的 Connector 节点增加属性 URIEncoding=”UTF-8″，如下图：

这个改动的用处是将 get 请求中的参数做 UTF- 8 编码，这样我们就能在浏览器的地址栏直接输入中文参数了，改动后节点变成了：

<Connector port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443"
               URIEncoding="UTF-8" />
  1. 修改 tomcat-users.xml 文件，在 tomcat-users 节点中增加内容：
<role rolename="manager-gui"/>
  <role rolename="manager-script"/>
  <user username="account001" password="password001" roles="manager-gui,manager-script"/>

修改后的效果如下图，红框中是新增的内容：

有了这些配置，就能用 account001 账号在对应的 tomcat 上进行在线部署操作了；

好了，准备工作结束，我们可以开始做 docker 镜像文件了，其实做镜像很简单，就是做好 Dockerfile 文件，再通过 docker 命令执行这个文件，就能生成镜像了，我们在 image_tomcat 目录下用编辑器新增一个文件，文件名 ”Dockerfile”，内容如下：

# First docker file from bolingcavalry
# VERSION 0.0.1
# Author: bolingcavalry

#基础镜像
FROM tomcat:7.0.77-jre8

#作者
MAINTAINER BolingCavalry <zq2599@gmail.com>

#定义工作目录
ENV WORK_PATH /usr/local/tomcat/conf

#定义要替换的文件名
ENV USER_CONF_FILE_NAME tomcat-users.xml

#定义要替换的 server.xml 文件名
ENV SERVER_CONF_FILE_NAME server.xml

#删除原文件 tomcat-users.xml
RUN rm $WORK_PATH/$USER_CONF_FILE_NAME

#复制文件 tomcat-users.xml
COPY  ./$USER_CONF_FILE_NAME $WORK_PATH/

#删除原文件 server.xml
RUN rm $WORK_PATH/$SERVER_CONF_FILE_NAME

#复制文件 server.xml
COPY  ./$SERVER_CONF_FILE_NAME $WORK_PATH/

以上就是 Dockerfile 的全部内容，几个关键点如下：

  1. FROM tomcat:7.0.77-jre8 的意思是使用 tomcat:7.0.77-jre8 作为基础镜像，7.0.77-jre8 是 tag，
  2. 使用了 tomcat:7.0.77-jre8 作为基础镜像后，通过 RUN rm 命令将原有的 server.xml 和 tomcat-users.xml 文件删除；
  3. 将我们准备工作中准备的 server.xml 和 tomcat-users.xml 文件复制到原来的 conf 目录下，这样就用取代了原有的文件；

打开电脑的命令行，进入 image_tomcat 目录，这个目录下只有这三个文件：

执行命令：

docker build -t bolingcavalrytomcat:0.0.1 .

执行中会有类似输出：

执行完毕后，输入 docker images 可以查看当前本机的镜像，如下图，可以看到新增的镜像：

有了镜像，执行下面的命令就可以启动 tomcat 了：

docker run --name=tomcat001 -p 8080:8080 -e TOMCAT_SERVER_ID=tomcat_server_001 -idt bolingcavalrytomcat:0.0.1

参数 -e TOMCAT_SERVER_ID=tomcat_server_001 的意思是在容器中设置了环境变量 TOMCAT_SERVER_ID，值是 tomcat_server_001
这时候再执行 docker ps 命令，可以看到启动的容器：

用浏览器访问 localhost:8080，可以看到熟悉的页面：

现在 tomcat 也启动了，代码也写好了，可以试试在线部署了么？别急，还差最后一步，打开 maven 的安装目录，在 conf 目录下找到 settings.xml 文件，打开后在 servers 节点添加以下内容:

<server>
       <id>tomcat7</id>
       <username>account001</username>
       <password>password001</password>
     </server>

这就是在 tomcat 的 tomcat-users.xml 文件中配置的用户和密码，这样执行 maven 插件的时候就能从此处取得对应的用户名和密码去 tomcat 上做操作了。

回到之前的那个 web 工程，用命令行进入 pom.xml 文件所在的目录，执行命令 

mvn clean package -U -Dmaven.test.skip=true tomcat7:redeploy

执行结果如下：

ok，tomcat7-maven-plugin 插件已经帮我们把 war 部署到 docker 容器上去了，在浏览器输入 

http://localhost:8080/loadbalancedemo/hello?name= 张三

可以看到如下效果：

蓝色字体的 tomcat_server_001 就是我们启动 tomcat 容器时通过 - e 参数设置的环境变量，在 HelloController 中被成功取出并展示到 jsp 页面上，代码如下图：

以上通过对 tomcat 官方镜像的一些文件操作，得到了我们自己制作的镜像文件，并结合 mvn 插件实现了 web 应用在线部署在 tomcat 容器上的效果，下一次实战，我们会接着这个例子启动两个 tomcat 容器，再在前面放一个 nginx，来实现负载均衡，过程中会学到 docker compose 和 link 的相关知识。

欢迎关注我的公众号

退出移动版