Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

第6章 アプリケーションデプロイメントの管理

JBoss EAP には、管理者向けと開発者向けのアプリケーションデプロイメントおよび設定オプションが多くあります。管理者は、管理コンソール のグラフィカルインターフェイスや 管理 CLI のコマンドラインインターフェイスを使用して本番環境のアプリケーションデプロイメントを管理できます。開発者は、設定可能なファイルシステムの デプロイメントスキャナー、HTTP API、Red Hat CodeReady Studio などの IDE、および Maven などを含む、多くのテストオプションをアプリケーションのデプロイメントで使用できます。

アプリケーションをデプロイするときにデプロイメント記述子の検証を有効にするには、org.jboss.metadata.parser.validate システムプロパティーを true に設定します。これには、以下の方法の 1 つを使用します。

  • サーバー起動時 

    $ EAP_HOME/bin/standalone.sh -Dorg.jboss.metadata.parser.validate=true
    Copy to Clipboard Toggle word wrap

  • 以下の管理 CLI コマンドでサーバー設定に追加 

    /system-property=org.jboss.metadata.parser.validate:add(value=true)
    Copy to Clipboard Toggle word wrap

6.1. 管理 CLI を使用したアプリケーションデプロイメントの管理
リンクのコピー

管理 CLI を使用してアプリケーションをデプロイすると、単一のコマンドラインインターフェイスでデプロイメントスクリプトを作成および実行できます。このスクリプト機能を使用して、特定のアプリケーションデプロイメントおよび管理シナリオを設定できます。スタンドアロンサーバーとして稼働している場合は単一サーバーのデプロイメント状態を管理でき、マネージドドメインで稼働している場合はサーバーのネットワーク全体のデプロイメントを管理できます。

6.1.1. スタンドアロンサーバーでのアプリケーションデプロイメントの管理
リンクのコピー

6.1.1.1. 管理 CLI を使用したスタンドアロンサーバーへのアプリケーションのデプロイ
リンクのコピー

管理 CLI で deployment deploy-file コマンドを使用して、アプリケーションをスタンドアロンサーバーにデプロイできます。

前提条件

  • JBoss EAP が実行中である。

手順

  • 管理 CLI から、Web Archive (war) としてパッケージ化されたアプリケーションをデプロイします。

    構文

    deployment deploy-file <path_to_the_application>/<application_name>.war
    Copy to Clipboard Toggle word wrap

    例

    deployment deploy-file /my-applications/test-application.war
    Copy to Clipboard Toggle word wrap

    正常にデプロイされると、管理 CLI には何も出力されませんが、サーバーログに次の出力のようなデプロイメントメッセージが記録されます。 

    WFLYSRV0027: Starting deployment of "test-application.war" (runtime-name: "test-application.war")
WFLYUT0021: Registered web context: /test-application
WFLYSRV0010: Deployed "test-application.war" (runtime-name : "test-application.war")
    Copy to Clipboard Toggle word wrap

同様に、以下の deployment コマンドを使用できます。

  • deployment deploy-cli-archive を使用してコンテンツを .cli アーカイブファイルからデプロイします。CLI デプロイメントアーカイブは、.cli 拡張子を持つ JAR ファイルです。デプロイする必要があるアプリケーションアーカイブと、コマンドおよび操作が含まれる deploy.scr および undeploy.scr CLI スクリプトファイルが含まれます。deploy.scr スクリプトファイルには、アプリケーションアーカイブをデプロイし、環境を設定するコマンドと操作が含まれます。undeploy.scr スクリプトファイルには、アプリケーションアーカイブをアンデプロイし、環境をクリーンアップするコマンドが含まれます。
  • deployment deploy-url を使用して、URL によって参照されるコンテンツをデプロイします。
注記

--runtime-name オプションで runtime-name 属性を指定する場合は、名前に .war 拡張子を含める必要があります。そうしないと、Web コンテキストが JBoss EAP によって登録されません。

6.1.1.2. 管理 CLI を使用したスタンドアロンサーバーからのアプリケーションのアンデプロイ
リンクのコピー

管理 CLI で deployment undeploy コマンドを使用して、スタンドアロンサーバーからアプリケーションをアンデプロイできます。アプリケーションをアンデプロイすると、リポジトリーからデプロイメントコンテンツが削除されます。デプロイメントコンテンツを保持しながらアプリケーションを使用不可にする場合は、代わりにデプロイメントを無効にできます。詳細は、管理 CLI を使用したスタンドアロンサーバーでのアプリケーションの無効化 を参照してください。

前提条件

  • JBoss EAP が実行中である。

手順

  • 管理 CLI を使用してアプリケーションをアンデプロイします。

    構文

    deployment undeploy <deployment>
    Copy to Clipboard Toggle word wrap

    例

    deployment undeploy test-application.war
    Copy to Clipboard Toggle word wrap

    正常にアンデプロイされると、管理 CLI には何も出力されませんが、サーバーログに次の出力のようなアンデプロイメントメッセージが記録されます。 

    WFLYUT0022: Unregistered web context: /test-application
WFLYSRV0028: Stopped deployment test-application.war (runtime-name: test-application.war) in 62ms
WFLYSRV0009: Undeployed "test-application.war" (runtime-name: "test-application.war")
    Copy to Clipboard Toggle word wrap

同様に、deployment undeploy-cli-archive を使用して .cli アーカイブファイルからコンテンツをアンデプロイできます。ワイルドカード (*) を使用してすべてのデプロイメントをアンデプロイすることも可能です。 

deployment undeploy *
Copy to Clipboard Toggle word wrap

6.1.1.3. 管理 CLI を使用したスタンドアロンサーバーでのアプリケーションの無効化
リンクのコピー

リポジトリーからデプロイメントコンテンツを削除せずに、デプロイされたアプリケーションを無効にできます。

前提条件

  • JBoss EAP が実行中である。

手順

  • 管理 CLI から deployment disable コマンドを使用して、JBoss EAP にデプロイされた 1 つまたはすべてのアプリケーションを無効にできます。

    • 1 つのデプロイメントを無効にする場合:

      構文

      deployment disable <deployment>
      Copy to Clipboard Toggle word wrap

      例

      deployment disable test-application.war
      Copy to Clipboard Toggle word wrap

    • すべてのデプロイメントを無効にする場合: 

      deployment disable-all
      Copy to Clipboard Toggle word wrap

6.1.1.4. 管理 CLI を使用したスタンドアロンサーバーでのアプリケーションの有効化
リンクのコピー

無効になっているアプリケーションを有効にできます。

前提条件

  • JBoss EAP が実行中である。

手順

  • 管理 CLI から deployment enable コマンドを使用して、JBoss EAP にデプロイされた 1 つまたはすべてのアプリケーションを有効にできます。

    • 1 つのデプロイメントを有効化する場合:

      構文

      deployment enable <deployment>
      Copy to Clipboard Toggle word wrap

      例

      deployment enable test-application.war
      Copy to Clipboard Toggle word wrap

    • すべてのデプロイメントを有効化する場合: 

      deployment enable-all
      Copy to Clipboard Toggle word wrap

6.1.1.5. 管理 CLI を使用したスタンドアロンサーバーでのデプロイメントのリスト表示
リンクのコピー

スタンドアロンサーバー内のデプロイメントをリスト表示し、ランタイム名、ステータスなどのデプロイメント情報を表示できます。

前提条件

  • JBoss EAP が実行中である。

手順

  • deployment info コマンドを使用して、デプロイメント情報をリスト表示します。 

    deployment info
    Copy to Clipboard Toggle word wrap

    出力には、ランタイム名、状態、有効であるかどうかなど、各デプロイメントの詳細が表示されます。 

    NAME                 RUNTIME-NAME         PERSISTENT ENABLED STATUS
helloworld.war       helloworld.war       true       true    OK
test-application.war test-application.war true       true    OK
    Copy to Clipboard Toggle word wrap

    以下のコマンドは、名前を指定してデプロイメント情報を表示します。 

    deployment info helloworld.war
    Copy to Clipboard Toggle word wrap

deployment list コマンドを使用して、デプロイメントをすべて表示することもできます。

6.1.2. マネージドドメインでのアプリケーションデプロイメントの管理
リンクのコピー

6.1.2.1. 管理 CLI を使用したマネージドドメインへのアプリケーションのデプロイ
リンクのコピー

管理 CLI で deployment deploy-file コマンドを使用し、アプリケーションをデプロイするサーバーグループを指定して、アプリケーションをスタンドアロンサーバーにデプロイできます。

前提条件

  • JBoss EAP がマネージドドメインとして実行されている。

手順

  • 管理 CLI から、Web Archive (war) としてパッケージ化されたアプリケーションを特定のサーバーグループまたはすべてのサーバーグループにデプロイできます。

    • 特定のサーバーグループにアプリケーションをデプロイする場合:

      構文

      deployment deploy-file <path_to_the_application>/<application_name>.war --server-groups=<server-group_1>,..., <server-group_1>
      Copy to Clipboard Toggle word wrap

      例

      deployment deploy-file /my-applications/test-application.war --server-groups=main-server-group,other-server-group
      Copy to Clipboard Toggle word wrap

    • すべてのサーバーグループにアプリケーションをデプロイする場合:

      構文

      deployment deploy-file <path_to_the_application>/<application_name>.war --all-server-groups
      Copy to Clipboard Toggle word wrap

      例

      deployment deploy-file /my-applications/test-application.war --all-server-groups
      Copy to Clipboard Toggle word wrap

      正常にデプロイされると、管理 CLI には何も出力されませんが、サーバーログに各サーバーのデプロイメントメッセージが記録されます。 

    [Server:server-one] WFLYSRV0027: Starting deployment of "test-application.war" (runtime-name: "test-application.war")
[Server:server-one] WFLYUT0021: Registered web context: /test-application
[Server:server-one] WFLYSRV0010: Deployed "test-application.war" (runtime-name : "test-application.war")
    Copy to Clipboard Toggle word wrap

同様に、以下の deployment コマンドを使用できます。

  • deployment deploy-cli-archive コマンドを使用してコンテンツを .cli アーカイブファイルからデプロイします。CLI デプロイメントアーカイブは、.cli 拡張子を持つ JAR ファイルです。デプロイする必要があるアプリケーションアーカイブと、コマンドおよび操作が含まれる deploy.scr および undeploy.scr CLI スクリプトファイルが含まれます。deploy.scr スクリプトファイルには、アプリケーションアーカイブをデプロイし、環境を設定するコマンドと操作が含まれます。undeploy.scr スクリプトファイルには、アプリケーションアーカイブをアンデプロイし、環境をクリーンアップするコマンドが含まれます。
  • deployment deploy-url コマンドを使用して、URL によって参照されるコンテンツをデプロイします。
注記

--runtime-name オプションで runtime-name 属性を指定する場合は、名前に .war 拡張子を含める必要があります。そうしないと、Web コンテキストが JBoss EAP によって登録されません。

6.1.2.2. 管理 CLI を使用したマネージドドメインからのアプリケーションのアンデプロイ
リンクのコピー

管理 CLI の deployment undeploy コマンドを使用して、マネージドドメインとして実行されている JBoss EAP からアプリケーションをアンデプロイできます。アプリケーションをアンデプロイすると、リポジトリーからデプロイメントコンテンツが削除されます。デプロイメントコンテンツを保持しながらアプリケーションを使用不可にする場合は、代わりにデプロイメントを無効にできます。詳細は、管理 CLI を使用したマネージドドメイン内のアプリケーションの無効化 を参照してください。

前提条件

  • JBoss EAP がマネージドドメインとして実行されている。

手順

  • 管理 CLI から、アプリケーションデプロイメントを持つすべてのサーバーグループからアプリケーションをアンデプロイします。

    構文

    deployment undeploy <application_name>.war --all-relevant-server-groups
    Copy to Clipboard Toggle word wrap

    例

    deployment undeploy test-application.war --all-relevant-server-groups
    Copy to Clipboard Toggle word wrap

    正常にアンデプロイされると、管理 CLI には何も出力されませんが、サーバーログに次の出力のような各サーバーのアンデプロイメントメッセージが記録されます。 

[Server:server-one] WFLYUT0022: Unregistered web context: /test-application
[Server:server-one] WFLYSRV0028: Stopped deployment test-application.war (runtime-name: test-application.war) in 74ms
[Server:server-one] WFLYSRV0009: Undeployed "test-application.war" (runtime-name: "test-application.war")
Copy to Clipboard Toggle word wrap

同様に、deployment undeploy-cli-archive コマンドを使用して .cli アーカイブファイルからコンテンツをアンデプロイできます。ワイルドカード (*) を使用してすべてのデプロイメントをアンデプロイすることも可能です。 

deployment undeploy * --all-relevant-server-groups
Copy to Clipboard Toggle word wrap

6.1.2.3. 管理 CLI を使用したマネージドドメイン内のアプリケーションの無効化
リンクのコピー

デプロイされたアプリケーションを特定のサーバーグループから無効にし、そのデプロイメントを持つ他のサーバーグループのリポジトリーにそのコンテンツを保持できます。

前提条件

  • JBoss EAP がマネージドドメインとして実行されている。

手順

  • 管理 CLI から deployment disable コマンドを使用して、JBoss EAP にデプロイされた 1 つまたはすべてのアプリケーションを無効にできます。

    • 1 つのアプリケーションを無効にする場合:

      構文

      deployment disable <application_name>.war --server-groups=<server-group_1>,..., <server-group_1>
      Copy to Clipboard Toggle word wrap

      例

      deployment disable test-application.war --server-groups=other-server-group
      Copy to Clipboard Toggle word wrap

    • すべてのデプロイメントを無効にする場合:

      構文

      deployment disable-all --server-groups=<server-group_1>,..., <server-group_1>
      Copy to Clipboard Toggle word wrap

      例

      deployment disable-all --server-groups=other-server-group
      Copy to Clipboard Toggle word wrap

6.1.2.4. 管理 CLI を使用したマネージドドメイン内のアプリケーションの有効化
リンクのコピー

無効になっているデプロイされたアプリケーションを有効にします。

前提条件

  • JBoss EAP がマネージドドメインとして実行されている。

手順

  • 管理 CLI から deployment enable コマンドを使用して、JBoss EAP にデプロイされた 1 つまたはすべてのアプリケーションを有効にできます。

    • 1 つのデプロイメントを有効化する場合:

      構文

      deployment enable <deployment> --server-groups=<server-group_1>,..., <server-group_1>
      Copy to Clipboard Toggle word wrap

      例

      deployment enable test-application.war --server-groups=other-server-group
      Copy to Clipboard Toggle word wrap

    • すべてのデプロイメントを有効化する場合: 

      deployment enable-all --server-groups=<server-group_1>,..., <server-group_1>
      Copy to Clipboard Toggle word wrap

      例

      deployment enable-all --server-groups=other-server-group
      Copy to Clipboard Toggle word wrap

6.1.2.5. 管理 CLI を使用したマネージドドメイン内のデプロイメントのリスト表示
リンクのコピー

デプロイメントをリスト表示し、ランタイム名、ステータスなどのデプロイメント情報を表示できます。

前提条件

  • JBoss EAP がマネージドドメインとして実行されている。

手順

  • deployment info コマンドを使用して、デプロイメント情報をリスト表示します。 

    deployment info helloworld.war
    Copy to Clipboard Toggle word wrap

    出力には、デプロイメントと各サーバーグループでの状態が表示されます。 

    NAME               RUNTIME-NAME
helloworld.war     helloworld.war

SERVER-GROUP       STATE
main-server-group  enabled
other-server-group added
    Copy to Clipboard Toggle word wrap

    以下のコマンドは、サーバーグループを指定してデプロイメント情報を表示します。 

    deployment info --server-group=other-server-group
    Copy to Clipboard Toggle word wrap

    出力には、デプロイメントと、指定のサーバーグループに対する状態が表示されます。 

    NAME                 RUNTIME-NAME         STATE
helloworld.war       helloworld.war       added
test-application.war test-application.war enabled
    Copy to Clipboard Toggle word wrap

deployment list コマンドを使用して、ドメインのデプロイメントをすべて表示することもできます。

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hatトップに戻る