JettyにWebアプリケーションをデプロイする

jetty Mavenプラグインは、Java Webアプリケーションの構築中に迅速なテストと反復を行うのに役立ちます。 それを使用してアプリケーションをデプロイおよび実行できるようにするには、pom.xmlにプラグインを追加するだけです。

最新バージョンは、this Maven linkをたどることで見つけることができます。

次の手順を実行する前に、ポート8080で実行されているJettyのインスタンスが停止していることを確認する必要があります。

プラグインを追加した後にアプリをデプロイするには、pom.xmlが配置されているルートに移動し、次のコマンドを実行します。

このコマンドは、新しいjettyインスタンスを作成し、プラグインはそれにアプリをデプロイします。 http://localhost:8080.をロードすることでアクセスできます

jetty Mavenプラグインは、変更がないかWebプロジェクトを継続的にスキャンし、再展開を続けます。

前のサブセクションから、アプリは/コンテキストでデプロイされました。 ただし、以前のように/jettyなどの特定のコンテキストパスでデプロイする場合は、プラグインを別の方法で構成する必要があります。

プラグイン宣言を次のXMLに変更します。

配置をさらにカスタマイズするために構成ブロックを追加したことに注目してください。 必要に応じて、このブロック内に配置するいくつかの構成オプションが存在します。

これらの変更後、以前と同じようにプラグインを再実行し、http://localhost:8080/jettyを介してアプリにアクセスできます。

直面する可能性のあるシナリオは、使用中のポートの例外です。 本番用にポート8080で実行されているjettyインスタンスがあるかもしれませんが、まだ開発段階にあり、Mavenプラグインを使用したデプロイに伴う反復の容易さの恩恵を受けたいと考えています。

そのような場合、別のポートでテストサーバーを実行する必要があります。 プラグイン構成を次のXMLに変更しましょう。

Mavenプラグインを再実行すると、http://localhost:8888/jettyからアプリにアクセスできるようになります。

jetty Mavenプラグインを使用すると、jettyのインスタンスをインストールして実行する必要がないことに注意してください。 むしろ、独自の突堤インスタンスを作成します。

Webアプリの迅速な展開と実行でjetty-runnerを使用するには、このMaven linkに従って最新バージョンをダウンロードできます。

jetty-runnerでは、ダウンロードしたjarを好きな場所に配置するだけで、Webアーカイブへのファイルシステムパスを準備できます。

コマンドラインから設定パラメーターを渡すことができ、また、さまざまなコンテキストで多数のアプリケーションをデプロイし、1つのコマンドでさまざまなポートにバインドできます。

jetty-runner jarをjetty-appディレクトリと同じ階層に配置しました。 これは、Webアプリケーションを含むディレクトリです。

jetty-runnerを使用してWARをデプロイしましょう。

このコマンドは、Mavenプラグインの場合と同様に、jettyインスタンスを作成し、提供されたWARをデプロイします。 WARパスは、絶対パスでも相対パスでもかまいません。

このアプリケーションは、http://localhost:8080を使用してロードできます。

以前のように/jettyコンテキストでデプロイするには：

http://localhost:8080/jettyからアクセスできます。

特定のポート番号にデプロイするには：

http://localhost:9090からアクセスできます。

同じコマンドで複数のWARを展開するには、–path引数を使用してそれぞれを一意にします。

次に、http://localhost:8080/oneを介してone.warにアクセスし、http://localhost:8080/twoを介してtwo.warにアクセスします。

このセクションでは、use Cargo’s Maven plugin to deploy a WAR to Jettyの実行方法を確認します。この場合、WARをJetty9.xインスタンスにデプロイします。

プロセス全体をしっかり把握するために、コマンドラインから新しいJava Webアプリケーションを作成することから始めます。

これにより、cargo-deployディレクトリに完全なJavaWebアプリケーションが作成されます。 このアプリケーションをそのままビルド、デプロイ、ロードすると、ブラウザにHello World!が出力されます。

Webアプリケーションにはサーブレットが含まれていないため、web.xmlファイルは非常に基本的なものになります。 したがって、新しく作成したプロジェクトのWEB-INFフォルダーに移動し、次のコンテンツでまだ自動作成されていない場合はweb.xmlを作成します。

完全修飾名を入力せずにMavenが貨物のコマンドを認識できるようにするには、Mavenのsettings.xml.のプラグイングループに貨物Mavenプラグインを追加する必要があります。

ルート<settings></settings>要素の直接の子として、次を追加します。

このサブセクションでは、新しいデプロイメント要件に合うようにpom.xmlを編集します。

次のようにプラグインを追加します。

explicitly define the packaging as a WARがないと、ビルドが失敗することに注意してください。 プラグインセクションで、cargo maven2プラグインを追加します。

執筆時点での最新バージョンは1.5.0です。 ただし、最新バージョンは常にhereで見つけることができます。 さらに、Jettyコンテナと既存のJettyインストールを使用していることをMavenに通知する構成セクションを追加します.

コンテナータイプをinstalledに設定することにより、マシンにJettyインスタンスがインストールされていることをMavenに通知し、このインストールへの絶対URLを提供します。

構成タイプをexistingに設定することにより、使用している既存のセットアップがあり、それ以上の構成は不要であることをMavenに通知します。

別の方法は、URLを指定して指定されたJettyバージョンをダウンロードしてセットアップするように貨物に指示することです。 ただし、焦点はWAR deploymentです。

Maven2.xとMaven3.xのどちらを使用していても、cargomaven2プラグインは両方で機能することに注意してください。

次を実行して、アプリケーションをインストールできます。

以下を実行して展開します：

MavenおよびJettyコンソールですべてがうまくいけば、http://localhost:8080/cargo-deploy.をロードすることでWebアプリケーションを実行できるはずです。

$JETTY_HOME/webappsフォルダーを確認すると、デプロイメント記述子ファイル、または以前にカーゴによって作成されたcargo-deploy.xmlと呼ばれるコンテキストファイルと呼ばれるものが見つかります。

デフォルトでは、Jettyにはリモート展開の可能性がありません。 このようなサポートをJettyに追加するために、CargoはJetty remote deployerWebアプリケーションを使用します。

これは、Cargo開発者が事前に作成したWebアプリケーションWARをダウンロードし、このWARをターゲットの桟橋コンテナに展開する必要があることを意味します。

cargo Mavenプラグインを使用してこのリモートサーバーにデプロイするたびに、デプロイ用のWARを使用して、リモートサーバー上のデプロイヤーアプリケーションにHTTPリクエストを送信します。

このリモートデプロイヤーはhereで見つけることができます。 toolsセクションに移動し、cargo-jetty-7-and-onwards-deployerWARをダウンロードします。

セキュリティに関する考慮事項

認証の目的で、これが機能する前に、桟橋にsecurity realmを設定する必要があります。 リモートjettyサーバーの$JETTY_HOME/etcディレクトリにrealm.propertiesというファイルを作成します。 ファイルの内容は次のとおりです。

adminは、クライアントが保護されたアプリにアクセスできるユーザー名、passwordはパスワード、managerは、アクセスが許可される前にクライアントが持つ必要のある役割です。

また、デプロイヤアプリケーションでセキュリティ要件を宣言する必要があります。 jettyダウンロードページからダウンロードしたWARを解凍し、いくつかの変更を加えて、WARに戻します。

解凍後、WEB-INF/web.xmlに移動し、Uncomment in order to activate securityコメントを使用してXMLコードのコメントを解除します。 または、次のコードをそこに配置します。

デプロイヤーのデプロイ

これで、アプリをWARにパックして、リモートサーバー上の任意の場所にコピーできます。 次に、Jettyに展開します。

展開中は、deployment descriptor fileを使用して、securityHandlerを作成し、それにloginServiceを渡すことができるようにするのが最善です。 すべての保護されたアプリケーションにはログインサービスが必要です。そうでない場合、jettyはそれらのデプロイに失敗します。

ここで、リモート桟橋インスタンスの$JETTY_HOME/webappsにコンテキストファイルを作成しましょう。コンテキストファイルの命名規則を覚えておいてください。 WARと同じ名前にします。

リモート桟橋サーバーを起動し、すべてがうまくいけば、http://localhost:8080/cargo-jetty-deployer.をロードできるはずです。そうすると、次のようなものが表示されるはずです。

リモートJettyへのWARのデプロイ

リモートデプロイを行うには、pom.xmlの構成セクションを変更するだけで済みます。 リモートデプロイとは、Jettyのローカルインストールがないが、リモートサーバーで実行されているデプロイヤーアプリへの認証されたアクセスがあることを意味します。

それでは、構成セクションが次のようになるようにpom.xmlを変更しましょう。

今回は、コンテナタイプをinstalledからremoteに変更し、構成タイプをexistingからruntimeに変更します。 最後に、ホスト名、ポート、および認証プロパティを構成に追加します。

プロジェクトをきれいにします：

インストールしてください：

最後に、それを展開します：

それでおしまい。

タスクバーからwindow項目を選択し、ドロップダウンメニューからpreferencesを選択することで、JettyインストールをEclipseに埋め込むことができます。

表示されるウィンドウの左パネルに設定項目のツリーグリッドがあります。 次に、Eclipse→サーバーに移動するか、検索バーにサーバーと入力します。

次に、まだ開いていない場合はJettyディレクトリを選択し、ダウンロードしたJettyバージョンを選択します。

パネルの右側に設定ページが表示されます。このページで有効化オプションを選択して、このJettyバージョンをアクティブにし、インストールフォルダーを参照します。

スクリーンショットから、jetty 7.xは、構成したjettyのバージョンに置き換えられます。

変更を適用し、次にeclipseのウィンドウからサーバービューを開く→[ビューの表示]サブメニューを開くと、新しく構成されたサーバーが表示され、アプリケーションを起動、停止、およびデプロイできます。

Webアプリケーションを組み込みJettyインスタンスにデプロイするには、ワークスペースに存在する必要があります。

ウィンドウからserversビューを開き、ビューを表示してサーバーを探します。 開いたら、構成したサーバーを右クリックして、表示されるコンテキストメニューからadd deploymentを選択できます。

表示されるNew Deploymentダイアログボックスから、projectドロップダウンを開き、Webプロジェクトを選択します。

Exploded Archive(development mode)、our changes in the application will be synced live without having to redeployを選択すると、Projectコンボボックスの下にDeploy Typeセクションがあります。これは非常に効率的であるため、開発中の最良のオプションです。

Packaged Archive(production mode)を選択すると、変更を加えてブラウザに表示するたびに再デプロイする必要があります。 これは本番環境でのみ最適ですが、Eclipseでも同様に簡単です。

通常、デバッグを容易にするためにEclipseを介してWARをデプロイすることを選択します。 Eclipseの組み込みサーバーで使用されている場所以外の場所にデプロイしたい場合があります。

最も一般的な例は、運用サーバーがオンラインであり、Webアプリケーションを更新する場合です。

実稼働モードで展開し、New DeploymentダイアログボックスでDeploy Locationに注目し、そこからWARを選択することで、この手順をバイパスできます。

展開中に、組み込みサーバーを選択する代わりに、組み込みサーバーのリストの横にあるserversビューから<Externally Launched>オプションを選択できます。 外部Jettyインストールの$JETTY_HOME /webappsディレクトリに移動します。

Runメニューを開き、Edit Configurationsオプションをクリックします。

左側のパネルでJetty Serverを検索します。存在しない場合は、メニューの+記号をクリックし、Jettyを検索して、Localを選択します。 nameフィールドにJetty 9を入力します。

Configure…ボタンをクリックし、Jetty Homeフィールドで、インストールのホームロケーションに移動して選択します。

必要に応じて、Startupページをhttp://localhost:8080/およびHTTP port: 8080に設定し、必要に応じてポートを変更します。

Deploymentタブに移動し、+記号をクリックして、サーバーに追加するアーティファクトを選択し、[OK]をクリックします。

ローカルJetty構成と同じ手順に従いますが、[サーバー]タブで、インストールのリモートの場所を入力する必要があります。