Web アプリケーションを開発する際、実際にローカル・サーバなどのサーバに配備 (deploy) して挙動を確認する作業をする必要があります。 ローカル・サーバに Tomcat を用いている場合、「tomcat-maven-plugin」によって、Web アプリケーションを配備する処理をビルドプロセスに組み込むことができます。
今回は、「tomcat-maven-plugin」を使う際に必要となる、ローカル・サーバの設定方法を見ていきます。 必要な設定は、Web アプリケーションを配備するために、「manager 権限」で Tomcat にアクセスできるようにすることです。
この設定方法は以下の2通りあります:
- Tomcat を設定する
- Maven2 プロジェクトとローカル・リポジトリを設定する
このうちのどちらかの設定を行う必要があります。
Tomcat を設定する
Tomcat の設定ファイルを変更できる場合、「TOMCAT_HOME/conf」フォルダ*1下の tomcat-users.xml を開き、以下のような <user> 要素を付け加えます:
<tomcat-users> ... <user username="admin" password="" roles="manager"/> </tomcat-users>
username 属性の値は「admin」、password 属性の値は空文字列にする必要があります。
Maven2 プロジェクトとローカル・リポジトリを設定する
Tomcat の設定ファイルが変更できない(したくない)場合、settings.xml と POM ファイルを設定します。
settings.xml の設定
まず、ローカル・リポジトリと同フォルダ*2上に XML ファイル「settings.xml」を作成し、以下の内容を作成します:
<?xml version="1.0" encoding="UTF-8"?> <server> <id>myserver</id> <username>myname</username> <password>mypassword</password> </server>
「username」「password」の子テキストは、manager 権限のあるユーザーのものにする必要があります。 また、<id> 要素の子テキスト(今の場合 myserver)は任意です。 POM ファイルの <server> 要素の設定で参照します。
POM ファイルの設定
次に Maven2 プロジェクトの POM ファイルを開き、「project/build/plugins」要素下に以下の <plugin> 要素を付加します。
<plugin> <groupId>org.codehaus.mojo</groupId> <artifactId>tomcat-maven-plugin</artifactId> <configuration> <server>myserver</server> </configuration> </plugin>
<server> 要素の子テキストは、settings.xml で設定した <id > 要素の子テキストです。