Liferay Forums ドキュメント

ホーム/Marketplace Apps/Liferay Forums/インストール

このページは英語版を翻訳したものです。UI のラベルとメニュー名は英語で表記しています。内容が異なる場合は、英語版が優先されます。

Liferay SaaS へのインストール

Liferay SaaS では、Liferay Cloud のコマンドラインツールを使って、フォーラムの 3 つの zip を 1 つずつ順番にデプロイします。Liferay Cloud は、batch とフォーラムサイトをジョブとして、マイクロサービスを常時稼働するサービスとして実行します。

これらの手順は、必要な修正を適用したクリーンな Liferay DXP 2026.Q1.4 LTS で、Liferay Cloud が client extension を実行する方法をローカルで再現した環境でテストされたものです。Liferay SaaS の環境ではまだテストされていません。

  1. 手順 1: Liferay のバージョンと修正を確認する
  2. 手順 2: デプロイの準備をする
  3. 手順 3: batch をデプロイする
  4. 手順 4: マイクロサービスをデプロイする
  5. 手順 5: site initializer をデプロイする
  6. 手順 6: メール通知を設定する
  7. 手順 7: インストールを確認する
  8. API 呼び出しの上限
  9. 以降のデプロイ
  10. フォーラムサイトの追加
  11. 関連情報

手順 1: Liferay のバージョンと修正を確認する

Liferay SaaS では、Liferay のバージョンと hotfix は Liferay が管理し、同じクラスター上のすべての環境に一度に適用されます。hotfix をお使いの環境だけにインストールすることはできません。そのため、お使いの環境で動作しているリリースを前提に作業します。

  1. お使いの環境で動作しているリリースと hotfix を Liferay サポートに問い合わせ、2026.Q1 LTS リリースであることを確認します。

  2. それを必要な Liferay の修正と比較します。含まれていない修正については、インストール後に回避策を使用します。LPD-85594 は Liferay SaaS では関係ありません。以下の手順では、site initializer を 2 回実行することはないためです。

手順 2: デプロイの準備をする

  1. Liferay Cloud のコマンドラインツールをインストールし、lcp login でサインインします。

  2. デプロイ先の拡張環境の ID を <project>-<environment> の形式で確認します。Liferay Cloud コンソールに表示されています。

  3. 最新リリースから、次のファイルをダウンロードします。

手順 3: batch をデプロイする

  1. batch をデプロイします。

     lcp deploy -p <project>-<environment> --extension liferay-forums-batch.zip
    
  2. ジョブが完了するまで待ちます。Applications → Notification Templates に、batch が最後に作成する C2M0 Notification Email Reply と C2M0 Notification Email Mention が表示されれば完了です。その後、Control Panel → Objects に C2M0 Forums フォルダーが表示され、7 つのオブジェクト(C2M0 Attachment、C2M0 Message、C2M0 Subscription、C2M0 Suspicious Activity、C2M0 Thread、C2M0 User、C2M0 Vote)が含まれています。

batch が完了するまで先に進まないでください。次の手順でデプロイするマイクロサービスは、その時点で存在するフォーラムの部分にしかアクセス権を得られません。早すぎるタイミングでデプロイすると、アクセス権を得られず、すべての投稿が Your account has been banned from participating in the forums. というメッセージで拒否されます。

手順 4: マイクロサービスをデプロイする

lcp deploy -p <project>-<environment> --extension liferay-forums-etc-spring-boot.zip

Liferay がマイクロサービスを登録し、Liferay Cloud がその認証情報を使ってマイクロサービスを起動します。その後、Control Panel → Security → OAuth 2 Administration に Liferay Forums Etc Spring Boot OAuth Application Headless Server と Liferay Forums Etc Spring Boot OAuth Application User Agent が表示されます。

手順 5: site initializer をデプロイする

lcp deploy -p <project>-<environment> --extension liferay-forums-site-initializer.zip

そのジョブによって、/web/forums にフォーラムサイトが作成されます。

手順 6: メール通知を設定する

batch によって、仮の送信元アドレスを持つメールテンプレートが 2 つ作成されています。メンバーにメールが届く前に、実際のアドレスを設定し、Liferay Cloud コンソールからマイクロサービスのサービス liferayforumsetcspringboot を再起動してください。メール通知を参照してください。

手順 7: インストールを確認する

/web/forums のフォーラムサイトについて、インストールの確認に進みます。

返信が拒否される場合は、投稿が拒否される を参照してください。

API 呼び出しの上限

Liferay SaaS では、ユーザーごと、1 時間あたりの API 呼び出し数に上限があります。マイクロサービスは、投稿のたびに単一のユーザーとして、すべてのフォーラムサイトの分をまとめて Liferay を呼び出します。利用の多いフォーラムや、利用の多いフォーラムサイトが複数ある場合は上限に達することがあり、その場合はその 1 時間が終わるまで投稿が拒否されます。大量の利用が見込まれる場合は、現在の上限を Liferay サポートに確認してください。

以降のデプロイ

  • batch を再度デプロイしないでください。 デプロイのたびにそのジョブが再実行され、メールテンプレートがすでに存在するため、失敗した項目が報告されます。データとテンプレートへの変更は保持されますが、ジョブは失敗として表示されます。
  • site initializer を再度デプロイしないでください。 そのジョブが再実行され、フォーラムサイトのアドレスが /web/group-<number> にリセットされて、フォーラムのリンクが壊れます。LPD-85594 では、Liferay SaaS でこれを防げません。これが起きた場合は、Site Settings でフレンドリー URL を元に戻してください。
  • マイクロサービスを再度デプロイするのは、その新しいバージョンがある場合だけにし、デプロイ後に返信を確認してください。

フォーラムサイトの追加

フォーラムサイトごとに、リリースのソースコードからビルドした専用の site initializer の zip を用意し、1 回だけデプロイします。マイクロサービスの再起動は不要です。複数のサイトを参照してください。