Red Hat Training

A Red Hat training course is available for Red Hat JBoss Enterprise Application Platform

10.5.3. デプロイメントスキャナーを使用してスタンドアロンサーバーインスタンスからアプリケーションをアンデプロイ

前提条件

概要

このタスクでは、デプロイメントスキャナーでデプロイされたスタンドアロンサーバーインスタンスからアプリケーションをアンデプロイする方法を説明します。「アプリケーションデプロイメント 」 トピックで説明されているように、この方法は開発者の利便性のために保持され、本番稼働環境でのアプリケーション管理には管理コンソールと管理 CLI の方法が推奨されます。

注記
デプロイメントスキャナーは、アプリケーション管理の他のデプロイメント方法と併用しないでください。管理コンソールでアプリケーションサーバーから削除されたアプリケーションは、deployment ディレクトリーに含まれるマーカーファイルやアプリケーションに影響を与えずにランタイムから削除されます。誤ってリダクションやその他のエラーのリスクを最小限に抑えるには、実稼働環境で管理 CLI と管理コンソールを使用します。

手順10.10 以下の方法の 1 つを用いたアプリケーションのアンデプロイ

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

    アプリケーションをデプロイする方法は 2 つありますが、アプリケーションをデプロイメントフォルダーから削除する場合と、デプロイメントの状態のみを変更する場合によって、使用する方法が異なります。

    • マーカーファイルの削除によるアンデプロイ

      デプロイされたアプリケーションの example.war.deployed マーカーファイルを削除し、ランタイムからアプリケーションのアンデプロイを開始するためにデプロイメントスキャナーをトリガーします。
      結果
      デプロイメントスキャナーはアプリケーションをアンデプロイし、example.war.undeployed マーカーファイルを作成します。アプリケーションはデプロイメントフォルダーに残ります。

    • アプリケーションの削除によるアンデプロイ

      注記
      この方法を使用した展開形式の WAR ファイルのアンデプロイは有効ではありません。マーカーファイルを削除してアンデプロイメントのみが有効になります。展開形式の WAR ファイルをアンデプロイしようとすると、以下のメッセージがログに記録されます。 
      WARN  [org.jboss.as.server.deployment.scanner] (DeploymentScanner-threads - 2) JBAS015006: The deployment scanner found that the content for exploded deployment EXAMPLE.war has been deleted, but auto-deploy/undeploy for exploded deployments is not enabled and the EXAMPLE.war.deployed marker file for this deployment has not been removed. As a result, the deployment is not being undeployed, but resources needed by the deployment may have been deleted and application errors may occur. Deleting the EXAMPLE.war.deployed marker file to trigger undeploy is recommended.
      デプロイメントディレクトリーからアプリケーションを削除して、ランタイムからアプリケーションのアンデプロイを開始するためにデプロイメントスキャナーをトリガーします。
      結果
      デプロイメントスキャナーはアプリケーションをアンデプロイし、filename.filetype.undeployed マーカーファイルを作成します。アプリケーションはデプロイメントフォルダーに存在しません。

結果

アプリケーションファイルはアプリケーションサーバーからアンデプロイされ、管理コンソールの Deployments 画面に表示されません。

バグの報告