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

Docker での DXP のパッチ適用

LiferayのパッチはDXPの問題を修正し、パッチ適用ツールはこれらのパッチを適用します。 Docker Hubでは、Liferayは新しいFix Pack 、 Security 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というフォルダにあるため、その親フォルダ ( [host folder]) をコンテナの/mnt/liferayフォルダにバインドマウントできます。これにより、DXPにパッチを適用できるようになります。

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

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

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

重要

パッチ適用ツールが[patch file] is incompatible with Patching Tool version [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-xyzzipという形式でない場合は、その形式になるように名前を変更してください。例:

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

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

パッチ適用のためデータベースをアップグレードする

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

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

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

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

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