最初在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容器上的效果。
參考博客: