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

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

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

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

重要

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

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

Fix Pack、Security Fix Pack、および Service Pack のイメージは、 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 フォルダー にバインド マウントします。 run

    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. パッチをダウンロード し、それを [ホスト フォルダー]/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. データベースアップグレードツールを使用してデータベースをアップグレードします。 詳細については、 データベース アップグレード ツールの使用 を参照してください。

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