Using Liferay Docker Images
ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、 こちら までご連絡ください。

DockerでDXPにパッチを適用する

Liferay パッチ は DXP の問題を修正し、パッチ適用ツールがパッチを適用します。 Docker Hubでは、Liferay は新しい Fix PackSecurity Fix Pack、および Service Pack があらかじめ含まれたイメージを提供しています。 Liferay は、DXP コンテナにインストールするための セキュリティ修正パックホットフィックス、および新しい パッチツール バージョンも提供しています。

エンタープライズサブスクリプション

重要

パッチを適用する前に、必ず データベースとインストールを バックアップしてください。

フィックスパック、セキュリティフィックスパック、およびサービスパックイメージの使用

フィックスパック、セキュリティフィックスパック、およびサービスパックのイメージは、 スリムバンドル に基づいています。 Slim Bundles は通常の Liferay Tomcat バンドル よりも起動が速く、フットプリントも小さくなっています。 ただし、スリムバンドルに適用できるパッチは1つだけです。 したがって、これらのイメージには、次のパッチ適用の制限があります。

  • フィックスパックおよびサービスパックイメージは、ホットフィックスやセキュリティフィックスパックなどの追加パッチを1つだけ受け取ることができます。

  • セキュリティフィックスパックイメージにパッチを適用することはできません。 これらは、セキュリティフィックスパックですでにパッチが適用されたフィックスパックで構成されています。

新しいフィックスパック、セキュリティフィックスパック、またはサービスパックのイメージを使用するには、そのイメージに基づいてコンテナに移行する必要があります。 DXPコンテナから新しいパッチイメージに移行する方法は次のとおりです。

  1. 現在の DXP コンテナを停止します

  2. DXPコンテナをカスタマイズするために使用したファイルを バックアップします。

    git commit -a
    
  3. Docker Hub から新しいイメージをダウンロードしてください。

    docker pull liferay/dxp:[tag]
    
  4. イメージに基づいて、バックアップのアーティファクトと設定ファイルを使用する新しいコンテナを作成します。

    たとえば、アーティファクトとファイルを次のようなローカルフォルダ構造に配置できます。

    [host folder]
    ├───deploy
    ├───files
    ├───patching
    └───scripts
    

    次に、実行コマンドでコンテナの/mnt/liferayフォルダにホストフォルダをバインドマウントする

    docker run ... -v [host folder path]:/mnt/liferay liferay/dxp:[tag]
    

DXPは、アーティファクトとファイルを使用して新しいコンテナで起動します。

パッチのインストール

フィックスパックイメージとサービスパックイメージは、追加のパッチの受け取りが1回に制限されています。 パッチは、ホットフィックス、セキュリティフィックスパック、またはその両方を組み合わせたパッチにすることができます。 この最後のタイプのパッチを入手するには、ヘルプセンターのチケットを作成し、現在のフィックスパックレベルに加えて最新のセキュリティ修正と製品修正を含むパッチを要求します。

パッチ要件:

  1. コンテナに既存のパッチがない。 新しいパッチを適用する前に、既存のパッチはすべて 元に戻す必要があります

  2. イメージはセキュリティフィックスパックイメージであってはなりません。これらのイメージには、すでにパッチ(セキュリティフィックスパック)が含まれています。

  3. コンテナの /mnt/liferay/patching フォルダにマップするボリュームまたはバインドマウントのフォルダ。 詳細については、 コンテナへのファイルの提供 を参照してください。

コンテナにパッチをインストールする方法は2つあります。

  1. 既存のコンテナにパッチをインストールしています

  2. 新しいコンテナにパッチをインストールしています

既存のコンテナへのインストール

既存のコンテナにパッチをインストールする手順は次のとおりです。

  1. 現在のコンテナを停止します

  2. パッチをダウンロードして、コンテナの/mnt/liferay/patchingフォルダにマップするボリュームまたはバインドマウント内のフォルダにコピーします。

  3. コンテナを再起動してください

新しいコンテナへのインストール

新しいコンテナにパッチをインストールする手順は次のとおりです。

  1. ホストフォルダと patchingというサブフォルダを作成します。

    mkdir -p [host folder]/patching
    
  2. パッチをダウンロードして、 [host folder]/patchingフォルダにコピーします。 例えば、

    cp ~/[patch file] [host folder]/patching
    
  3. 現在実行中の DXP コンテナを停止します。

  4. パッチファイルのフォルダをコンテナの/mnt/liferay/patchingフォルダにマップするバインドマウントを含むコンテナを作成します。 この例のパッチ ファイルは patchingというフォルダにあるので、 その親フォルダ ([ホスト フォルダ]) をコンテナの /mnt/liferay フォルダにバインド マウント できます。 これにより、DXPに適用するためのパッチにアクセスできるようになります。

    docker run ... -v [host folder path]:/mnt/liferay liferay/dxp:[tag]
    

    バインドマウントの指定方法の詳細については、 コンテナへのファイルの提供 を参照してください。

パッチツールがパッチをインストールし、DXPが起動します。

重要

パッチツールが次のメッセージを報告する場合: [パッチファイル]はパッチツールバージョン[xyz]と互換性がありません。最新のパッチツールをインストールしてください。 詳細については、 パッチ適用ツールのインストール を参照してください。

パッチを元に戻す

コンテナからパッチを元に戻したり、パッチを適用したコンテナに別のパッチをインストールしたりする場合は、コンテナを削除して新しいコンテナを作成する必要があります。

  1. コンテナを停止します

    docker stop [container]
    
  2. コンテナのアーティファクトとファイルをバックアップします。

  3. コンテナを削除します。

    docker rm [container]
    
  4. 以前に使用したdocker run引数を使用して、同じイメージまたは互換性のあるフィックスパックレベルを持つイメージから新しいコンテナを作成します。 ボリュームまたは バインドマウントを介して、任意のパッチを適用します。

パッチングツールの更新

現在のパッチツールがインストールするパッチと互換性がない場合、パッチツールには次のメッセージが報告されます: [patch file] is incompatible with Patching Tool version [x.y.z]x.y.zはツールのメジャー、マイナー、およびマクロのバージョン番号です)。

新しい パッチツール バージョンのインストール方法は次のとおりです。

  1. カスタマーポータルから最新のパッチ適用ツールをダウンロードしてください。

  2. パッチツールのZIPファイル名の形式がpatching-tool-x.y.z.zipでない場合は、その形式を使用するよう名前を変更します。 例:

    mv patching-tool.zip patching-tool-2.0.15.zip
    
  3. コンテナの /mnt/liferay/patching フォルダを介して、パッチツール ZIP ファイルをコンテナにインストールします。これは、 ホットフィックスとセキュリティ修正パックが インストールされるのと同じ方法です。

コンテナを再起動するか新しいコンテナを実行すると、コンテナのエントリポイントによって新しいパッチツールがインストールされます。

パッチのためのデータベースのアップグレード

パッチでデータベースのアップグレードが必要な場合は、コンテナ化されていない環境でデータベースアップグレードツールを使用してアップグレードする必要があります。

  1. 使用しているLiferayのバージョンのLiferay Tomcat Bundleのインストールをインストールします。

  2. インストールにパッチを適用します。 詳細については、 Liferay のパッチ適用 を参照してください。

  3. データベースアップグレードツールを使用してデータベースをアップグレードします。 詳細については、 データベースアップグレードツールの使用 を参照してください。

データベースがアップグレードされたら、そのデータベースを使用するコンテナを実行します。