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

最初在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/blog_demos,您也可以指执行命令git clone git@github.com:zq2599/blog_demos.git来获得,下载后整个文件夹下有多个工程,本次实战用到的是loadbalancedemo,建议用intellJ Idea以maven工程的形式导入。

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

           <plugin>
                <groupId>org.apache.tomcat.maven</groupId>
                <artifactId>tomcat7-maven-plugin</artifactId>
                <version>2.2</version>
                <configuration>
                    <url>http://192.168.1.129:8080/manager/text</url>
                    <server>tomcat8</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”:

<Connector port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443"
               URIEncoding="UTF-8" /> 

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

4.修改tomcat-users.xml文件,在tomcat-users节点中增加内容:

<role rolename="manager"/>    
<role rolename="manager-gui"/>    
<role rolename="admin"/>    
<role rolename="admin-gui"/>    
<user username="tomcat" password="tomcat" roles="admin-gui,admin,manager-gui,manager-script,manager"/>   

5. 增加manager.xml ,内容如下:

<Context privileged="true" antiResourceLocking="false"
         docBase="${catalina.home}/webapps/manager">
    <Valve className="org.apache.catalina.valves.RemoteAddrValve" allow="^.*$" />
</Context>

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

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

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

#基础镜像
FROM tomcat

#作者
MAINTAINER Lizhong <1979158178@qq.com>

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

#定义manager.xml工作目录
ENV MANAGER_PATH /usr/local/tomcat/conf/Catalina/localhost

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

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

#定义要新增的manager.xml文件名
ENV MANAGER_CONF_FILE_NAME manager.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/

#复制文件manager.xml
COPY  ./$MANAGER_CONF_FILE_NAME $MANAGER_PATH/

以上就是Dockerfile的全部内容,几个关键点如下: 
1. FROM tomcat的意思是使用tomcat作为基础镜像;
2. 使用了tomcat作为基础镜像后,通过RUN rm命令将原有的server.xml和tomcat-users.xml文件删除; 
3. 将我们准备工作中准备的server.xml和tomcat-users.xml文件复制到原来的conf目录下,这样就用取代了原有的文件;

打开电脑的命令行,进入image_tomcat目录,这个目录下只有这四个文件: 

执行命令:

docker build -t tomcat:0.0.1 .

执行中会有类似输出:

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

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

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

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

用浏览器访问192.168.1.129:8080,可以看到熟悉的页面: 

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

<server>
    <id>tomcat8</id>
    <username>tomcat</username>
    <password>tomcat</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://192.168.1.129:8080/loadbalancedemo/hello?name=张三丰

可以看到如下效果:

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

 

以上通过对tomcat官方镜像的一些文件操作,得到了我们自己制作的镜像文件,并结合mvn插件实现了web应用在线部署在tomcat容器上的效果。

 

参考博客:

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

maven如何在tomcat8中自动部署

posted on 2018-04-29 20:31    阅读(15597)  评论(3编辑  收藏  举报