Ant-deploying-applications

Ant-アプリケーションのデプロイ

前の章では、アプリケーションをパッケージ化してフォルダーにデプロイする方法を学びました。

この章では、Webアプリケーションをアプリケーションサーバーのdeployフォルダーに直接デプロイします。次に、いくつかのAntターゲットを追加して、サービスを開始および停止します。 Hello World ファックスWebアプリケーションを続けましょう。 これは前の章の続きで、新しいコンポーネントは*太字*で強調表示されています。

build.properties

# Ant properties for building the springapp

appserver.home = c:\\install\\apache-tomcat-7.0.19
# for Tomcat 5 use $appserver.home}/server/lib
# for Tomcat 6 use $appserver.home}/lib
appserver.lib = ${appserver.home}/lib

deploy.path = ${appserver.home}/webapps

tomcat.manager.url = http://www.finddevguides.com:8080/manager
tomcat.manager.username = finddevguides
tomcat.manager.password = secret

build.xml

<?xml version = "1.0"?>

<project name = "fax" basedir = "." default = "usage">
   <property file = "build.properties"/>
   <property name = "src.dir" value = "src"/>
   <property name = "web.dir" value = "war"/>
   <property name = "javadoc.dir" value = "doc"/>
   <property name = "build.dir" value = "${web.dir}/WEB-INF/classes"/>
   <property name = "name" value = "fax"/>

   <path id = "master-classpath">
      <fileset dir = "${web.dir}/WEB-INF/lib">
         <include name = "*.jar"/>
      </fileset>

   <pathelement path = "${build.dir}"/>
   </path>

   <target name = "javadoc">
      <javadoc packagenames = "faxapp.*" sourcepath = "${src.dir}"
         destdir = "doc" version = "true" windowtitle = "Fax Application">

         <doctitle><![CDATA[<h1> =  Fax Application  =  </h1>]]></doctitle>
         <bottom><![CDATA[Copyright © 2011. All Rights Reserved.]]></bottom>
         <group title = "util packages" packages = "faxapp.util.*"/>
         <group title = "web packages" packages = "faxapp.web.*"/>
         <group title = "data packages" packages = "faxapp.entity.*:faxapp.dao.*"/>
      </javadoc>
   </target>

   <target name = "usage">
      <echo message = ""/>
      <echo message = "${name} build file"/>
      <echo message = "-----------------------------------"/>
      <echo message = ""/>
      <echo message = "Available targets are:"/>
      <echo message = ""/>
      <echo message = "deploy    --> Deploy application as directory"/>
      <echo message = "deploywar --> Deploy application as a WAR file"/>
      <echo message = ""/>
   </target>

   <target name = "build" description = "Compile main source tree java files">

      <mkdir dir = "${build.dir}"/>

      <javac destdir = "${build.dir}" source = "1.5" target = "1.5" debug = "true"
         deprecation = "false" optimize = "false" failonerror = "true">
         <src path = "${src.dir}"/>
         <classpath refid = "master-classpath"/>
      </javac>
   </target>

   <target name = "deploy" depends = "build" description = "Deploy application">
      <copy todir = "${deploy.path}/${name}"
         preservelastmodified = "true">

         <fileset dir = "${web.dir}">
            <include name = "**/*.*"/>
         </fileset>
      </copy>
   </target>

   <target name = "deploywar" depends = "build" description =
      "Deploy application as a WAR file">

      <war destfile = "${name}.war" webxml = "${web.dir}/WEB-INF/web.xml">
         <fileset dir = "${web.dir}">
            <include name = "**/*.*"/>
         </fileset>
      </war>

      <copy todir = "${deploy.path}" preservelastmodified = "true">
         <fileset dir = ".">
            <include name = "*.war"/>
         </fileset>
      </copy>
   </target>

   <target name = "clean" description = "Clean output directories">
      <delete>
         <fileset dir = "${build.dir}">
            <include name = "**/*.class"/>
         </fileset>
      </delete>
   </target>

   <!-- ============================================================ -->
   <!-- Tomcat tasks -->
   <!-- ============================================================ -->

   <path id = "catalina-ant-classpath">
      <!-- We need the Catalina jars for Tomcat -->
      <!--  * for other app servers - check the docs -->

      <fileset dir = "${appserver.lib}">
         <include name = "catalina-ant.jar"/>
      </fileset>
   </path>

   <taskdef name = "install" classname = "org.apache.catalina.ant.InstallTask">
      <classpath refid = "catalina-ant-classpath"/>
   </taskdef>

   <taskdef name = "reload" classname = "org.apache.catalina.ant.ReloadTask">
      <classpath refid = "catalina-ant-classpath"/>
   </taskdef>

   <taskdef name = "list" classname = "org.apache.catalina.ant.ListTask">
      <classpath refid = "catalina-ant-classpath"/>
   </taskdef>

   <taskdef name = "start" classname = "org.apache.catalina.ant.StartTask">
      <classpath refid = "catalina-ant-classpath"/>
   </taskdef>

   <taskdef name = "stop" classname = "org.apache.catalina.ant.StopTask">
      <classpath refid = "catalina-ant-classpath"/>
   </taskdef>

   <target name = "reload" description = "Reload application in Tomcat">
      <reload url = "${tomcat.manager.url}"username = "${tomcat.manager.username}"
         password = "${tomcat.manager.password}" path = "/${name}"/>
   </target>
</project>

この例では、Tomcatをアプリケーションサーバーとして使用しています。 まず、ビルドプロパティファイルで、いくつかの追加プロパティを定義しました。

• appserver.home は、Tomcatアプリケーションサーバーへのインストールパスを指します。
• appserver.lib は、Tomcatインストールフォルダー内のライブラリファイルを指します。
• deploy.path 変数は、Tomcatのwebappフォルダーを指すようになりました。

Tomcatマネージャーアプリケーションを使用して、Tomcatのアプリケーションを停止および開始できます。 マネージャーアプリケーションのURL、ユーザー名、パスワードもbuild.propertiesファイルで指定されます。 次に、 catalina-ant.jar を含む新しいCLASSPATHを宣言します。 このjarファイルは、Apache Antを介してTomcatタスクを実行するために必要です。

catalina-ant.jarは、次のタスクを提供します-

Sr.No.	Properties & Description
1	InstallTask Webアプリケーションをインストールします。 クラス名：org.apache.catalina.ant.InstallTask
2	ReloadTask Webアプリケーションをリロードします。 クラス名：org.apache.catalina.ant.ReloadTask
3	ListTask すべてのWebアプリケーションをリストします。 クラス名：org.apache.catalina.ant.ListTask
4	StartTask Webアプリケーションを開始します。 クラス名：org.apache.catalina.ant.StartTask
5	StopTask Webアプリケーションを停止します。 クラス名：org.apache.catalina.ant.StopTask
6	ReloadTask 停止せずにWebアプリケーションをリロードします。 クラス名：org.apache.catalina.ant.ReloadTask

リロードタスクには、次の追加パラメータが必要です-

• マネージャーアプリケーションへのURL

• Webアプリケーションを再起動するユーザー名

• Webアプリケーションを再起動するためのパスワード

• 再起動するWebアプリケーションの名前

  *deploy-war* コマンドを発行してwebappをTomcat webappsフォルダーにコピーしてから、Fax Webアプリケーションをリロードしましょう。 次の結果は、Antファイルを実行した結果です-

C:\>ant deploy-war
Buildfile: C:\build.xml

BUILD SUCCESSFUL
Total time: 6.3 seconds

C:\>ant reload
Buildfile: C:\build.xml

BUILD SUCCESSFUL
Total time: 3.1 seconds

上記のタスクを実行すると、Webアプリケーションがデプロイされ、Webアプリケーションがリロードされます。