ひまlab

ひまな時になんか書く。

Tomcat7にEclipseからアプリケーションをデプロイする方法

Tomcat7 Eclipse ant

前置き

Tomcat7に対して、EclipseからAntを使ってデプロイしようとした際に、色々苦戦したのでやり方を記録に残します。
やることはそれほど多くありませんが、Tomcat6とは違いがあるので、これからTomcat7を使う方は参考にどうぞ。

環境

手順

Tomcatの設定

  • デプロイに使うTomcatユーザのロールに"manager- script"を追加します。
    • TOMCAT_HOME/conf/tomcat-users.xmlを開き、以下のようにrolesのとこに、manager-scriptを追加
    <tomcat-users>
        <user name="admin" password="tomcat" roles="manager-gui,manager-script"/>
    </tomcat-users>

Eclipseの設定

Eclipseを使用せずに、Antのみで行いたい場合は、参考のページを見てください

  • Antが使用するjarを追加
    • build.xmlを用意
      • warを作れる定義を用意。詳細は省略
    • プロジェクトエクスプローラ上で、Build.xmlを右クリック
    • Run As → Ant Build を選択 f:id:kanjin:20130302213916p:plain
    • 上部のタブから、Classpathを選択 → Add External JARsを押下 f:id:kanjin:20130302214037p:plain
    • 事前に取得した以下の7つのjarを選択し、Applyを押下
      1. tomcat-juli.jar
      2. catalina-ant.jar
      3. tomcat-coyote.jar
      4. tomcat-util.jar
      5. jasper.jar
      6. jasper-el.jar
      7. servlet-api.jar
        • jasper.jar, jasper-el.jar, servlet-api.jarはドキュメントに載ってないので要らないかも・・。消すとエラーが出るので追加しています

Build.xmlの編集

  • 以下の内容をBuild.xmlに追加
    • プロパティ値は、環境に合わせて書き換える
 <!-- プロパティ値 -->
    <property name="manager.url"   value="http://192.168.0.2:8080/manager/text"/>
    <property name="manager.username"   value="admin"/>
    <property name="manager.password"   value="tomcat"/>
    <property name="manager.context.path"   value="/TomcatProject"/>
    <property name="manager.war.file"   value="file:./dist/TomcatProject.war"/>  
    <property name="manager.update"   value="true"/>
    
    <target name="manager.deploy.war"
        depends="context.status"
        if="context.deployable">
        <deploy url="${manager.url}"
            username="${manager.username}"
            password="${manager.password}"
            path="${manager.context.path}"
            update="${manager.update}"
            war="${manager.war.file}"/>
    </target>

    <target name="manager.undeploy.war" 
        description="context.status"
        if="context.undeployable">
        <undeploy url="${manager.url}" 
            username="${manager.username}" 
            password="${manager.password}" 
            path="${manager.context.path}" />
    </target>

    <target name="context.status">
        <property name="running" value="${manager.context.path}:running"/>
        <property name="stopped" value="${manager.context.path}:stopped"/>

        <list url="${manager.url}"
            outputproperty="ctx.status"
            username="${manager.username}"
            password="${manager.password}">
        </list>

        <condition property="context.running">
            <contains string="${ctx.status}" substring="${running}"/>
        </condition>
        <condition property="context.stopped">
            <contains string="${ctx.status}" substring="${stopped}"/>
        </condition>
        <condition property="context.notInstalled">
            <and>
                <isfalse value="${context.running}"/>
                <isfalse value="${context.stopped}"/>
            </and>
        </condition>
        <condition property="context.deployable">
            <or>
                <istrue value="${context.notInstalled}"/>
                <and>
                    <istrue value="${context.running}"/>
                    <istrue value="${manager.update}"/>
                </and>
                <and>
                    <istrue value="${context.stopped}"/>
                    <istrue value="${manager.update}"/>
                </and>
            </or>
        </condition>
        <condition property="context.undeployable">
            <or>
                <istrue value="${context.running}"/>
                <istrue value="${context.stopped}"/>
            </or>
        </condition>
    </target>
  • プロパティ値について
    • manager.url
      • デプロイ先のサーバを示すURL
        • http://<hostname>:<port>/manager/text
    • manager.username
      • デプロイに使用するtomcatのユーザ名
    • manager.password
      • デプロイに使用するtomcatのパスワード
    • manager.context.path
      • デプロイするアプリケーションのコンテキストパス
        • /<任意のコンテキストパス>
          • /を忘れずにつける
    • manager.war.file
      • warへのパス
    • manager.update
      • すでにデプロイされている場合に、更新するか
        • 更新する場合: true, 更新しない場合: false

デプロイ

  • プロジェクトエクスプローラ上で、Build.xmlを右クリック
  • Run As → Ant Build を選択
  • manager.deploy.warを選択し、Runを押下

アンデプロイ

  • プロジェクトエクスプローラ上で、Build.xmlを右クリック
  • Run As → Ant Build を選択
  • manager.undeploy.warを選択し、Runを押下

以上、思ったより長かった

参考