パッチを使った作業

以下のようなパッチ関連のことをする必要があるかもしれません:

Liferayサポートへのパッチレベルの報告から始めます。

Support Ticketsにsupport-infoを足す

問題を再現するには、環境の情報(ハードウェアアーキテクチャなど)とパッチレベルをLiferayサポートに提供しなければいけません。以下のコマンドを実行して、(パッチレベルを含む)サポート情報をファイルに書き込みます。

patching-tool support-info

サポート情報はpatching-toolフォルダ内のpatching-tool-support-info-actual-timestamp.txtファイルに書き込まれます。このファイルをLESAチケットにアップロードしてください。

パッチのアンインストール

パッチングツールにinstallコマンドしかないことに気がつきましたか? これは、パッチがコマンドではなく、patchesフォルダに表示されるものによって管理されているためです。このフォルダからパッチを追加または削除して、インストールしたパッチを管理します。

パッチをアンインストール(削除)する方法は次のとおりです:

  1. patchesフォルダからパッチを削除してください。

  2. patching-tool installコマンドを実行してください。

すべてのパッチを元に戻すには、次のコマンドを実行します:

patching-tool revert

以上がパッチを削除、そして元に戻す方法です。

パッチレベルの比較

パッチングツールは異なるLiferay DXPパッチとバージョンの間で何が変わったかを示すことができるため、これは開発者にとっては便利な機能です。これらのコマンドは、さまざまなパッチレベルに関する情報を表示します:

patching-tool diff:2つのパッチレベルの違いをプリントします。少なくとも1つの保存済みパッチレベルが利用可能である必要があります。このコマンドは、出力をフィルタリングするためのオプションを受け入れます。

  • source:2つのパッチレベルの違いを表示します。

  • files:修正したファイルの一覧を表示します。

  • fixed-issues:問題追跡システムからのLPS / LPE問題のリストを表示します。

  • html:これを一つのフィルタオプションとともに指定し、(sourcefiles、またはfixed-issues)パッチが同じレベルになった後、diffsフォルダ内に違いをHTMLファイルに書きます。(<stored-name-1>-<stored-name-2>-[type]-diff.html) 追加部分は緑色に、削除部分は赤色に着色されています。

  • collisions:デプロイされたプラグインと衝突する修正されたファイルのリストを表示します。

詳しい使用法については、patching-tool help diffを実行してください。

patching-tool storediffコマンドのパッチングレベルの情報を管理します。パッチには、パッチレベルを保存するためのもの、またdiffコマンドで使用できる情報を準備するためのソースコードが含まれている必要があります。storeコマンドオプションは次のとおりです:

  • info:保存されているパッチレベルを構成するパッチの一覧をプリントします。

  • add:パッチディレクトリにあるパッチレベルを保存します。

  • update:パッチレベルの情報を追加または更新します。

  • rm:以前に保存したパッチレベル情報を削除します。

詳しい使用法については、patching-tool help storeを実行してください。

パッチとデプロイされたプラグインの衝突を表示する

いくつかのパッチは、プラグインによってカスタマイズしたかもしれないファイルを更新します。このpatching-tool list-collisionsコマンドは、インストールされたパッチファイルとプラグインのバージョンの(衝突の)違いをリストします。これがコマンドです:

patching-tool list-collisions

これは、以下のdiffコマンドの別名です。

patching-tool diff collisions files _base

_baseは文字通りのパッチレベル名です。衝突は、ソースコードファイルを含むインストール済みパッチに対してのみ一覧表示されます。

インストールからのパッチの分離

パッチングツールのseparateコマンドは、パッチ適用済みのLiferay DXPのインストールサイズを小さくするのに役立ちます。インストールにパッチが適用されている場合は、そこから復元ファイルを移動することで、インストールサイズを小さくすることができます。

なぜパッチを適用したインストールが大きいかというと、復元ファイルはWebアプリケーションのWEB-INFフォルダ内にデフォルトで保存されているからです。これらのファイルは、インストールに再度パッチを適用するために必要です。

これらのファイルが削除されると、その後のパッチ適用プロセスは失敗します。このため、Liferayは、新しいパッチが届いたときにファイルを安全に保存および復元しながら、インストールからパッチファイルを分離するオプションを追加しました。これを行うには、次のコマンドを使用します。

patching-tool separate [separation_name]

このコマンドはパッチングツールのpatchesフォルダ内にliferay-patching-files-[separation-name].zipファイルを作成します。ここにはパッチング、検証、そして確認するために必要なファイルとメタデータが含まれています。このファイルを作成すると、パッチファイルはデフォルトのロケーションから削除され、このファイルでのみ使用可能になります。このファイルを他の場所に保存して、インストールのサイズを小さくすることができます。

警告:この方法で製品がそのパッチから分離されていると、パッチが復元されるまで、ほとんどのパッチングツールコマンドを実行できません。

分離処理後は、以下のコマンドのみ使用できます:

  • auto-discovery
  • info
  • setup

他のコマンドを使うと以下が表示されます:

This installation does not include data for patching. Please copy the
liferay-patching-files-[separation-name].zip file into the 'patches' directory
and run patching-tool setup.

これが、パッチファイルをシステムに復元する方法です。詳細は下記。

分離したパッチファイルの復元

Liferay DXPに再度パッチを適用する必要がある場合は、分離したパッチアーティファクトを復元する必要があります。これを行うためには、liferay-patching-files-[separation-name].zipをパッチングツールのpatchesフォルダに再度コピーして、patching-tool setupコマンドを実行してください。

このコマンドは、必要なパッチングアーティファクトを見つけて、パッチファイルをインストール済み環境に復元します。その後、パッチングツールはパッチを分離する前と同じように機能します。

« パッチのインストールパッチングツールの設定方法 »
この記事は役に立ちましたか?
0人中0人がこの記事が役に立ったと言っています