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

バックアップサービス

プロジェクトのデータを守るためには、定期的にバックアップを取ることが重要です。 Liferay Cloudのバックアップサービスでは、環境データの反復を保存し、必要に応じて環境の復元に使用できます。これらのバックアップには、Liferay DXPデータベースと[LIFERAY_HOME]/dataフォルダの全コンテンツが含まれます。

バックアップサービスは、Liferay Cloudで利用可能ないくつかのサービスのうちの1つです。

どの環境のバックアップページからでも、バックアップの作成、保持されたバックアップの表示またはダウンロード、そしてバックアップから環境を復元することができます。

また、Liferay Cloudコンソールや、バックアップサービスのLCP.jsonファイルから、プロジェクトのニーズに合わせてバックアップサービスを設定することができます。

バックアップサービスの制限事項については、詳細をご覧ください。

バックアップページ

どの環境のバックアップページからでも、バックアップサービスの情報や保持されているバックアップの確認、手動でバックアップを作成したりすることができます。

注記

バックアップページは、バックアップサービスのバージョンが4.3.5より古い場合、本番環境でのみ利用可能です。

以下の手順で、バックアップページにアクセスします。

  1. どの環境からでも、左側のメニューにある「バックアップ」をクリックしてください。

どの環境でも、バックアップページからバックアップ履歴を表示したり、手動バックアップを作成したりできます。

ここから、以下の作業を行います。

  • バックアップ情報の表示:選択した環境のバックアップサービス情報をすばやく確認できます。これには、自動バックアップの頻度、バックアップの保持期間、次回のスケジュールされたバックアップ、最新の作成済みバックアップ、および保持されている最古のバックアップのタイムスタンプ情報が含まれます。

  • バックアップ履歴の表示:選択した環境に保存されているバックアップの全リストを表示できます。各項目には、バックアップの名前、サイズ、種類( Auto 、 Manual 、 Uploaded )、および作成日時が表示されます。赤いバックアップアイコンは、バックアップが失敗したことを示します。その横には「バックアップ失敗」のメッセージと、サポートへの問い合わせリンクが表示されています。

  • 手動バックアップの作成:選択した環境のバックアップを手動で作成できます。詳しくは「手動バックアップの作成」を参照してください。

注記

バックアップのタイムスタンプはブラウザの位置情報に基づいて自動的に表示されますが、バックアップスケジュールはUTC±00のタイムゾーンに基づいています。

環境管理者は、[バックアップ]ページからアクションボタン(⋮)にアクセスし、保持しているバックアップのダウンロードや環境の復元を行うことができます。

管理者は、バックアップページからバックアップをダウンロードしたり、環境を復元したりできます。

また、画面上部の2つのセレクターから、バックアップのリストをステータス(失敗または成功)でフィルタリングしたり、関連するディザスタリカバリ(dr)環境(現在の環境に設定されている場合)からバックアップを表示したりすることもできます。

ディザスターリカバリーのバックアップを表示したり、ドロップダウンメニューからバックアップのステータスでフィルタリングしたりすることができます。

これらの操作を実行する方法の詳細と手順については、 「バックアップのダウンロードとアップロード」および「バックアップからのデータの復元」を参照してください。

手動バックアップの作成

バックアップページから環境を手動でバックアップするには、 「今すぐバックアップ」をクリックします。このプロセスは、サービスの規模に応じて数分から数時間かかります。

起動すると、バックアップサービスのアイコンはバックアップ中であることを示し、画面上部にメッセージが表示されます。新しいバックアップは、[Backup History]にも表示されます。

画面上部のバックアップサービスのアイコンとメッセージは、バックアップ中であることを示します。

警告

Liferayインスタンス上でデータが活発に変更されている間にバックアップを作成すると、データの一貫性が損なわれるリスクがあります。完全に一貫性のあるバックアップを確保するため、データベース管理者と連携して、手動バックアップを実行する間、アップデートを一時停止してください。

「ログを表示」をクリックすると、ログページに移動し、そこでバックアップの各段階をリアルタイムで確認できます。バックアップサービスのページの「ログ」タブでバックアップログを確認することもできます。

サービスログの表示方法については、 「Liferay Cloudサービスログの読み方」を参照してください。

バックアップサービスの構成

Liferay CloudコンソールまたはバックアップサービスのLCP.jsonファイルから、プロジェクトのニーズに合わせてバックアップサービスを設定することができます。

バックアップサービスの設定に使用できる変数の一覧については、 環境変数のリファレンス を参照してください。

重要

バックアップサービスが再構成されると、サービスは再起動され、数分間リクエストの受信を停止したり、設定によっては動作が異なったりする場合があります。

Liferay Cloud Console を介したバックアップサービスの設定

  1. バックアップサービスが導入されている環境に移動します。

  2. 環境メニューの「サービス」をクリックしてください。

  3. バックアップサービスの環境変数を確認するには、「バックアップサービス」をクリックしてください。

    環境設定で、バックアップサービスの変数タブに移動してください。

    環境の概要ページで「バックアップ」をクリックすると、バックアップサービスのページにアクセスすることもできます。

  4. 環境変数リファレンスリストから変数を追加して、バックアップサービスを設定します。

  5. 「変更を保存」をクリックしてください。

通常の環境変数に加えて、Liferay Cloudコンソールからシークレット変数を設定することもできます。詳細については、 「Secrets を使用したセキュアな環境変数の管理」を参照してください。

Backup LCP.jsonファイルを使用したバックアップサービスの設定

  1. テキストエディタを使用して、次のパスにあるバックアップLCP.jsonファイルを開きます: /{your_project_name}/backup/LCP.json 。

  2. 環境に関するセクションまでスクロールしてください。

    "env": {
      "LCP_BACKUP_FOLDER": "/opt/liferay/data",
      "LCP_DATABASE_SERVICE": "mydatabase",
      "LCP_MASTER_USER_PASSWORD": "mypassword"
    },
    
  3. Environment Variables Reference のリストから変数を追加して、バックアップサービスを設定します。

  4. ファイルを保存し、プロジェクトにデプロイして設定を適用してください。

LCP.jsonファイルを使用して環境サービスを設定する方法の詳細については、 「LCP.json による設定」を参照してください。

自動バックアップとクリーンアップのスケジュール設定

バックアップの作成と削除の頻度を決定することは、データの保護とストレージの最適化に役立ちます。

警告

Liferayインスタンス上でデータが活発に変更されている最中にバックアップを作成すると、データの一貫性が損なわれるリスクがあります。データ不整合のリスクを軽減するため、バックアップスケジュールはアクティビティが少ない時間帯に開始するように設定してください。完全に一貫性のあるバックアップを確保するには、データベース管理者と連携して、手動バックアップを実行している間は更新を一時停止し、クリーンアップスケジュール ( LCP_BACKUP_CLEANUP_SCHEDULE) とは異なる時間に実行するように設定してください。

自動バックアップスケジュールを設定する方法は2つあります。

コンソール経由でスケジュールを設定する

  1. 選択した環境から、バックアップサービスに移動し、 「構成」タブをクリックします。

    [設定]タブをクリックして、バックアップスケジュールの設定にアクセスします。

    注記

    この環境にバックアップがない場合、バックアップサービスページの「定期バックアップを設定する」リンクをクリックすると、構成タブに移動します。

  2. 「バックアップの作成」ドロップダウンメニューで、利用可能なオプションから希望するバックアップ頻度を選択してください。

    • 毎日:バックアップは毎日作成されます。作成時刻(UTC±00タイムゾーン)を設定できます。本番環境では、毎日のバックアップを推奨します。

    • 毎週:バックアップは毎週作成されます。作成する曜日と時刻(UTC±00タイムゾーン)を設定できます。

    • 詳細設定:より複雑な頻度でcronスケジュール値を設定できます。

    • 未設定(手動):自動バックアップは作成されません。バックアップはすべて手動で作成する必要があります。これは非本番環境におけるデフォルト設定です。

    週間スケジュールを作成する場合は、曜日と時間を選択できます。

  3. 「指定した期間より古いバックアップを削除する」セレクターから、希望する保持期間を選択してください。

  4. 「変更を保存」をクリックしてください。

バックアップサービスが再起動され、サービスが完全に再起動した時点で変更が適用されます。

環境変数を使用したスケジュールの設定

環境ごとに以下の変数を使用して、バックアップの作成および削除のタイミングをカスタマイズしてください。

  • 自動バックアップ:自動バックアップの頻度を設定するには、 cronスケジューリング値を指定してLCP_BACKUP_CREATE_SCHEDULE変数を追加します。

  • 自動クリーンアップ:自動バックアップクリーンアップの頻度を設定するには、 cronスケジューリング値を指定してLCP_BACKUP_CLEANUP_SCHEDULE変数を追加します。

  • 保持期間: LCP_BACKUP_RETENTION_PERIOD変数に数値(0~30)を追加して、自動クリーンアップによって削除されるまでのバックアップの保持日数を設定します。

注記

標準および非標準のcronスケジューリング構文はどちらもUTC±00タイムゾーンに基づいています。標準以外のcron構文を使用する場合、自動バックアップとクリーンアップは指定された値の開始時に実行されます。例えば、 @daily毎日 00:00 UTC にバックアップを実行します。

これらの環境変数は、Liferay Cloudコンソール(バックアップサービス内)で設定するか、プロジェクトリポジトリのbackup/LCP.jsonファイルで設定し、バックアップサービスを環境にデプロイすることで使用できます。

警告

Liferay Cloudコンソールで環境変数を設定した後、リポジトリからバックアップサービスをデプロイする際に、 backup/LCP.jsonに異なる設定を追加した場合、リポジトリの設定がコンソールで設定した環境変数を上書きします。

このbackup/LCP.json例では、12 時間ごと(つまり、UTC の 00:00 と 12:00)にバックアップを作成し、30 日以上前のバックアップを削除する月次クリーンアップを実行します。

"env": {
  "LCP_BACKUP_FOLDER": "/opt/liferay/data",
  "LCP_DATABASE_SERVICE": "mydatabase",
  "LCP_MASTER_USER_PASSWORD": "mypassword",
  "LCP_BACKUP_CREATE_SCHEDULE": "0 0,12 * * *",
  "LCP_BACKUP_CLEANUP_SCHEDULE": "@monthly",
  "LCP_BACKUP_RETENTION_PERIOD": "30"
},

バックアップサービスのパフォーマンス向上

バックアップサービスを設定することで、バックアップのサイズを縮小したり、バックアップの作成および復元プロセスを高速化してパフォーマンスを向上させることができます。

生成済みドキュメントライブラリファイルをバックアップから除外する

Liferay SaaS Liferay PaaS + Google Cloud Storage Liferay DXP 2024.Q3+ Backup Service 5.17.0+

バックアップの作成および復元時に、生成されたドキュメントライブラリファイル(アダプティブメディア、ドキュメントサムネイル、ドキュメントプレビューなど)を除外するように選択できます。 Liferayは必要に応じてこれらのファイルを再生成するため、バックアップする必要はありません。 LCP_BACKUP_EXCLUDE_GENERATED_DL_FILES_ON_BACKUP_CREATEとLCP_BACKUP_EXCLUDE_GENERATED_DL_FILES_ON_BACKUP_RESTOREの値をtrueに設定することで、この機能を有効にできます。バックアップするデータ量を減らすことで、バックアップはより高速かつ軽量になります。

これらの変数は、Liferay SaaS および Google Cloud Storage を使用する Liferay PaaS プロジェクトに適用されます。ファイルシステムストアを使用するLiferay PaaSプロジェクトでは、バックアップサービスはそれらを無視し、バックアップには生成されたすべてのファイルが含まれます。起動時に、サービスは無視する各変数について以下のメッセージをログに記録します。

Project not on LXC cluster, ignoring environment variable [LCP_BACKUP_EXCLUDE_GENERATED_DL_FILES_ON_BACKUP_CREATE]

サービスは変数が有効になった際にログを出力しないため、起動後にこのメッセージが表示されない場合は、設定が有効になっています。

移転戦略の発見

Google Cloud Storage Liferay DXP 2024.Q1.6+ Backup Service 5.17.0+

GCS(Google Cloud Storage)上のバックアップを復元する場合、バックアップサービスは転送戦略を使用する必要があります。 Liferay Cloud は、ドキュメント ライブラリの転送方法として、 gsutilとrclone 2 つの戦略をサポートしています。

バックアップサービスのログを確認することで、どの転送戦略が使用されているかを確認できます。 GCSでバックアップを復元した後、次のようなメッセージが表示されます。

Spawning [TRANSFER_STRATEGY] process to transfer files from [SOURCE] to [DESTINATION]

[TRANSFER_STRATEGY]に記述されているコマンドは、 gsutilまたはrcloneいずれかです。

環境変数LCP_DOCUMENT_LIBRARY_GCS_TRANSFER_STRATEGYを使用して、転送戦略を選択できます。デフォルトでは、バックアップサービスはgsutilを使用して、 rcloneをサポートしていないLiferay DXPバージョンでもバックアップがスムーズに実行されるようにします。

注記

バックアップ転送戦略として、Rcloneはgsutilよりも高速で軽量であり、エラーも少ない。上記のとおり、お使いのLiferay DXPのバージョンがrcloneをサポートしている場合は、必ずrclone使用してください。

バックアップサービスのバージョン管理

Liferay Cloudは、バックアップサービスの最小バージョンを設定しています。これは通常、他のサービスが古いバックアップサービスと互換性がなくなった場合、または新しいバージョンで重要な修正や機能強化が導入された場合に行われます。

Liferay Cloudが最小バージョンを引き上げると、バックアップサービスが新しい最小要件を満たしていない場合は、自動的にアップグレードされます。 Liferay Cloudが下位バージョンのデプロイメントを上書きする場合、ログと概要ページにメッセージが表示されます。

概要ページに、サービスがアップグレードされたことを知らせるメッセージが表示されます。

注記

Liferay Cloudが最小バージョンを引き下げても、バックアップサービスには影響はありません。新しい要件を満たす旧バージョンを手動でデプロイすることも可能です。

主要デプロイメントディレクトリ

ファイルの種類パス説明
SQLスクリプトbackup/configs/[ENV]/scripts/ここにある.sqlスクリプトは、バックアップから復元されるたびに自動的に実行されます。

環境変数リファレンス

名前デフォルト値説明
LCP_BACKUP_CLEANUP_SCHEDULE0 1 * * *cronスケジューリング構文を使用して、自動クリーンアップをスケジュールします。クリーンアップ処理では、バックアップ保持期間を超過したすべてのバックアップが削除されます。 LCP_BACKUP_CREATE_SCHEDULEと競合してはなりません。
LCP_BACKUP_CREATE_SCHEDULE[5-55][0-1] * * *cronスケジューリング構文を使用して自動バックアップをスケジュールします。 LCP_BACKUP_CLEANUP_SCHEDULEと競合してはなりません。バックアップサービスのバージョン3.2.1以降では、値が指定されていない場合、ランダムなデフォルト値が作成されます。
LCP_BACKUP_EXCLUDE_GENERATED_DL_FILES_ON_BACKUP_CREATEfalseバックアップを作成する際に、生成されたドキュメントライブラリファイル(アダプティブメディア、サムネイル、プレビュー)を除外します。 Liferay SaaSおよびGoogle Cloud Storageを使用したLiferay PaaSにのみ適用されます。詳細については、 「生成されたドキュメントライブラリファイルをバックアップから除外する」を参照してください。
LCP_BACKUP_EXCLUDE_GENERATED_DL_FILES_ON_BACKUP_RESTOREfalseバックアップを復元する際に、生成されたドキュメントライブラリファイル(アダプティブメディア、サムネイル、プレビュー)を除外します。 Liferay SaaSおよびGoogle Cloud Storageを使用したLiferay PaaSにのみ適用されます。詳細については、 「生成されたドキュメントライブラリファイルをバックアップから除外する」を参照してください。
LCP_BACKUP_RESTORE_SCHEDULE該当なしcronスケジューリング構文を使用して、自動復元をスケジュールします。災害復旧環境での使用を想定しています。
LCP_BACKUP_RESTORE_DL_DOWNLOAD_AND_EXTRACT_STRATEGYdownload-then-extractドキュメントライブラリのダウンロードおよび抽出戦略を決定します。変更頻度の低い静的データのバックアップにはdownload-then-extractを、変更頻度が高く迅速な復旧が必要なデータパイプラインにはstream-pipelineを使用してください。
LCP_BACKUP_RETENTION_PERIOD30定期クリーンアップ時に削除するバックアップを決定します。クリーンアップによって削除されるまでのバックアップの保持日数を選択してください。 0から30までの値のみが許可されます。
LCP_DATABASE_SERVICEdatabaseデータベースサービスのID。
LCP_DBNAMElportalデータベース名。
LCP_DEBUG_LOGfalseバックアップサービスのデバッグログを有効にします。 trueまたはfalseに設定します。
LCP_DOCUMENT_LIBRARY_GCS_TRANSFER_STRATEGYgsutil文書ライブラリの転送戦略を決定します。 rclone最低限 Liferay バージョンを必要としますが、パフォーマンスが向上します。
LCP_GCP_STORAGE_UPLOAD_MAX_RETRIES6バックアップのアップロードが失敗した場合に、再試行する最大回数。この制限を超えると、アップロードは中止され、完全に最初からやり直される可能性があります(最大2回まで)。
LCP_GCP_STORAGE_UPLOAD_MAX_RETRY_DELAY64LCP_GCP_STORAGE_UPLOAD_MAX_RETRIESで設定された各再試行間の遅延時間(秒単位)。
LCP_GCP_STORAGE_UPLOAD_RETRY_DELAY_MULTIPLIER3以降の再試行ごとに、 LCP_GCP_STORAGE_UPLOAD_MAX_RETRY_DELAYで設定された遅延時間を乗算します。
LCP_GCP_STORAGE_UPLOAD_TIMEOUT6000バックアップアップロード要求(または再試行)間の最大遅延時間(秒単位)。これは、 LCP_GCP_STORAGE_UPLOAD_RETRY_DELAY_MULTIPLIER遅延時間を増加させることができる量の上限を設定します。
LCP_MASTER_USER_NAMEdxpcloudマスターユーザー名。
LCP_MASTER_USER_PASSWORDLCP_PROJECT_MASTER_TOKENマスターパスワード。
LCP_SERVICE_LOG_LEVELINFO表示するログメッセージの優先度が最も低いレベル。ログレベルの名前または数値を設定します。詳細については、 「ログレベル」を参照してください。