5.3. JBoss EAP のカスタムモジュールの作成


同じサードパーティーライブラリーを使用する多くのアプリケーションを同じサーバーにデプロイする場合は、カスタムモジュールを作成すると便利です。これらのライブラリーを各アプリケーションとバンドルする代わりに、管理者はこれらのライブラリーが含まれるモジュールを作成およびインストールできます。

カスタムモジュールは次の方法で作成できます。

5.3.1. カスタムモジュールの手動作成

Java Archive (JAR) またはその他のリソースファイルからモジュールを作成し、JBoss EAP のアプリケーションでそれらのファイルを使用できます。

前提条件

  • モジュールに必要な JAR またはリソースファイルがある。

手順

  1. EAP_HOME/modules/ ディレクトリーに適切なディレクトリー構造を作成します。

    例: MySQL JDBC ドライバーディレクトリー構造の作成

    $ cd EAP_HOME/modules/
    $ mkdir -p com/mysql/main

  2. JAR ファイルまたはその他必要なリソースを main/ サブディレクトリーにコピーします。

    例: MySQL JDBC ドライバー JAR のコピー

    $ cp /path/to/mysql-connector-j-8.0.33.jar EAP_HOME/modules/com/mysql/main/

    注記

    MySQL ドライバーの JAR 名 (mysql-connector-j-8.0.33.jar) は、あくまで例として示したものです。テスト済みの MySQL バージョンの詳細は、Tested databases を参照してください。

  3. module.xml ファイルを main/ サブディレクトリーに作成し、そのファイルの適切なリソースおよび依存関係を指定します。

    例: MySQL JDBC ドライバー module.xml ファイル

    <?xml version="1.0" ?>
    <module xmlns="urn:jboss:module:1.9" name="com.mysql">
      <resources>
        <resource-root path="mysql-connector-j-8.0.33.jar"/>
      </resources>
      <dependencies>
        <module name="java.xml" export="true"/>
        <module name="java.xml.crypto" export="true"/>
        <module name="jdk.xml.dom" export="true"/>
    
        <module name="jakarta.transaction.api"/>
      </dependencies>
    </module>

    注記

    MySQL ドライバーの JAR 名 (mysql-connector-j-8.0.33.jar) は、あくまで例として示したものです。テスト済みの MySQL バージョンの詳細は、Tested databases を参照してください。

5.3.2. 管理 CLI を使用したカスタムモジュールの作成

管理 CLI を使用して、Java Archive (JAR) またはその他のリソースファイルからモジュールを作成し、JBoss EAP のアプリケーションでそれらのファイルを使用できます。

重要

module 管理 CLI コマンドを使用したモジュールの追加および削除は、テクノロジープレビューとしてのみ提供されます。このコマンドは、マネージドドメインでの使用や、リモートによる管理 CLI への接続時には適していません。本番環境では、モジュールを手作業で追加および削除する必要があります。詳細は以下を参照してください。

テクノロジープレビュー機能は、Red Hat の実稼働環境のサービスレベルアグリーメント (SLA) ではサポートされず、機能的に完全ではないことがあるため、Red Hat では実稼働環境での使用を推奨していません。テクノロジープレビュー機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行い、フィードバックを提供していただくことを目的としています。

テクノロジープレビュー機能のサポート範囲は、Red Hat カスタマーポータルの テクノロジープレビュー機能のサポート範囲 を参照してください。

前提条件

  • モジュールに必要な JAR またはリソースファイルがある。

手順

  1. JBoss EAP サーバーを起動します。
  2. 管理 CLI を起動します。

    $ EAP_HOME/bin/jboss-cli.sh
  3. module add 管理 CLI コマンドを使用して新しいコアモジュールを追加します。

    構文

    module add --name=<MODULE_NAME> --resources=<PATH_TO_RESOURCE> --dependencies=<DEPENDENCIES>

    例: MySQL モジュールの作成

    module add --name=com.mysql --resources=</path/to>/mysql-connector-j-8.0.33.jar --dependencies=java.xml,java.xml.crypto,jdk.xml.dom,jakarta.transaction.api

    注記

    MySQL ドライバーの JAR 名 (mysql-connector-j-8.0.33.jar) は、あくまで例として示したものです。テスト済みの MySQL バージョンの詳細は、Tested databases を参照してください。

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

会社概要

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

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

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

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

Legal Notice

Theme

© 2026 Red Hat
トップに戻る