8.17. 起動可能な JAR への JBoss EAP パッチの適用

JBoss EAP ベアメタルプラットフォームでは、CLI スクリプトを使用して起動可能な JAR にパッチをインストールできます。

CLI スクリプトは patch apply コマンドを実行し、起動可能な JAR ビルド時にパッチを適用します。

重要

起動可能な JAR にパッチを適用した後は、適用されたパッチからロールバックすることはできません。パッチなしで起動可能な JAR をリビルドする必要があります。

さらに、JBoss EAP JAR Maven プラグインを使用して、起動可能な JAR にレガシーパッチを適用することもできます。このプラグインは、サーバーのパッチに使用される CLI スクリプトを参照する <legacy-patch-cli-script> 設定オプションを提供します。

注記

<legacy-patch-cli-script> の接頭辞 legacy-* は、アーカイブパッチを起動可能な JAR に適用することに関連します。このメソッドは、通常の JBoss EAP ディストリビューションにパッチを適用するのと似ています。

JBoss EAP JAR Maven プラグイン設定で legacy-patch-cleanup オプションを使用して、未使用のパッチコンテンツを削除して、起動可能な JAR のメモリーフットプリントを低減できます。このオプションは、未使用のモジュール依存関係を削除します。このオプションは、パッチ設定ファイルで、デフォルトで false に設定されています。

legacy-patch-cleanup オプションは、以下のパッチコンテンツを削除します。

  • <JBOSS_HOME>/.installation/patches ディレクトリー
  • ベースレイヤーのパッチモジュールの元の場所。
  • パッチによって追加された未使用のモジュールは、既存のモジュールグラフまたはパッチが適用されたモジュールグラフで参照されません。
  • .overlays ファイルに記載されていないディレクトリーのオーバーレイを設定します。
重要

legacy-patch-clean-up オプション変数は、テクノロジープレビューとして提供されます。テクノロジープレビューの機能は、Red Hat の本番環境のサービスレベルアグリーメント (SLA) ではサポートされず、機能的に完全ではないことがあるため、Red Hat は本番環境での使用は推奨しません。テクノロジープレビューの機能は、最新の技術をいち早く提供して、開発段階で機能のテストやフィードバックの収集を可能にするために提供されます。

注記

この手順に概説する情報は、起動可能な JAR にも関係します。

前提条件

  • Red Hat カスタマーポータル でアカウントを設定している。

  • 製品のダウンロードページから以下のファイルをダウンロードしている。

    • JBoss EAP 7.3.4 GA パッチ
    • JBoss EAP XP 2.0.0 パッチ

手順

  1. 起動可能な JAR に適用するレガシーパッチを定義する CLI スクリプトを作成します。スクリプトには、1 つまたは複数の patch apply コマンドが含まれている必要があります。Galleon レイヤーでトリミングされたサーバーにパッチを適用する場合には、--override-all コマンドが必要です。以下に例を示します。 

    patch apply patch-oneoff1.zip --override-all

patch apply patch-oneoff2.zip --override-all

patch info --json-output
  2. pom.xml ファイルの <legacy-patch-cli-script> 要素で CLI スクリプトを参照します。
  3. 起動可能な JAR をリビルドします。

その他のリソース