FEPClusterを作成する場合、ユーザーはバックアップ定義を設定することにより、スケジュールされたバックアップを取得できます。 ユーザーは、作成されたバックアップカスタムリソースを変更することにより、バックアップスケジュールを変更することもできます。
バックアップ定義には次のものが含まれます。
取得時間（crontab形式で指定）
バックアップの種類（フルバックアップまたはインクリメンタルバックアップ）
バックアップはマスターPodでのみ行われます。
バックアップ処理はpgBackRestによって実行されます。
カスタムリソース定義でパラメータをpgbackrestParamsに設定できます。
バックアップスケジュールの最大数は5です。
パラメータの詳細については、pgBackRestユーザーズガイドを参照してください。
ただし、一部のパラメータは制限されています。 詳細は以下のとおりです。
pgBackRestを設定するための重要なパラメータは次のとおりです。このパラメータは、バックアップ情報の保持期間を設定します。自動バックアップが設定されていて、このパラメータが設定されていない場合、バックアップ領域がオーバーフローするリスクが高まります。
パラメータ | 説明 | 設定値 |
|---|---|---|
Full Retention Option | 保持するフルバックアップの値を指定します。 デフォルト値なし（ユーザーのバックアップポリシーに従って設定する必要があります） | 正の整数値 |
Full Retention Type Option | spec.retention -full設定が保持日数（time）であるか保持世代数（count）であるかを指定します。 デフォルト値なし（ユーザーのバックアップポリシーに従って設定する必要があります） | time/count |
以下は、上記のパラメータを設定して、バックアップ保持期間（PITRが有効な期間）をFEPClusterのデプロイ後30日に変更するカスタムリソースの例です。
apiVersion: fep.fujitsu.io/v1
kind: FEPBackup
metadata:
name: fepcluster-backup
spec:
pgBackrestParams: |
# define custom pgbackrest.conf parameters below to override defaults.
[global]
repo-retention-full = 30
repo-retention-full-type = time
...pgBackRest構成ファイルの以下のパラメータは設定できません。
パラメータ | 説明 | 理由 |
|---|---|---|
Copy Archive Option (--archive -copy) | 一貫性を保つために必要なWALセグメントをバックアップにコピー | 内部固定値を使用 |
Check Archive Mode Option (--archive-mode-check) | PostgreSQLのarchive_modeの設定を確認 | マスターからのバックアップに限定 |
Backup from Standby Option (--backup-standby) | スタンバイクラスタからのバックアップ | マスターからのバックアップに限定 |
Stop Auto Option (--stop-auto) | 以前に失敗したバックアップを新しいバックアップで停止 | 9.6では未サポート |
pgBackRest Command Option (--cmd) | pgBackRestコマンド | 内部固定値を使用 |
SSH client command Option (--cmd-ssh) | sshクライアント実行可能ファイルへのパス | sshは未使用 |
Compress Option (--compress) | ファイル圧縮を使用 | 廃止されたオプション（代わりにcompresse-typeオプションを使用してください） |
Config Option (--config) | pgBackRest構成ファイル | 内部固定値を使用 |
Config Include Path Option (--config-include-path) | 追加のpgBackRest設定ファイルへのパス | 内部固定値を使用 |
Config Path Option (--config-path) | pgBackRest構成ファイルのベースパス | 内部固定値を使用 |
Delta Option (--delta) | チェックサムを使用したリストアまたはバックアップ | 新規リストアのみ |
Dry Run Option (--dry-run) | command.lesのドライランを実行 | コマンドラインのみのオプション |
Lock Path Option (--lock-path) | ロックファイルが保存されているパス | 内部固定値を使用 |
Keep Alive Option (--sck -keep-alive) | ソケット接続でキープアライブメッセージを有効にする | 内部固定値を使用 |
Spool Path Option (--spool-path) | 非同期archive-pushコマンドおよびarchive-getコマンドの一時データを格納するパス | FEPClusterカスタムリソース値からの自動判別用 |
Stanza Option (--stanza) | スタンザを定義 | 内部固定値を使用 |
Console Log Level Option (--log-level-console) | コンソールログレベル | Podでの動作は想定外 |
Std Error Log Level Option (--log-level-stderr) | 標準エラーログレベル | Podでの動作は想定外 |
Log Path Option (--log-path) | ログファイルの保存先 | FEPClusterカスタムリソース値からの自動判別用 |
Repository Host Option (--repo-host) | SSH経由のリモート操作用のリポジトリホスト | リポジトリホストは未使用 |
Repository Host Command Option (--repo-host-cmd) | リポジトリホスト上のpgBackRestのパス | |
Repository Host Configuration Option (--repo-host-config) | リポジトリホスト構成ファイルのパス | |
Repository Host Configuration Include Path Option (--repo-host-config-include-path) | インクルードパスを構成するリポジトリホスト | |
Repository Host Configuration Path Option (--repo-host-config-path) | リポジトリホスト構成パス | |
Repository Host Port Option (--repo-host-port) | “repo-host”が構成されている場合のリポジトリホストポート | |
Repository Host User Option (--repo-host-user) | “repo-host”が構成されている場合のリポジトリホストユーザー | |
Repository Path Option (--repo-path) | バックアップとアーカイブが保存されるパス | FEPClusterカスタムリソース値からの自動判別用 |
Archive Retention Option (--repo-retention-archive) | 保持する連続したWALバックアップの数 | このオプションは推奨されません。WALの保持は、Full Retention OptionとFull Retention Type Optionによって制御されます。 |
Archive Retention Type Option (--repo-retention-archive-type) | WAL保持のバックアップタイプ | デフォルトから変更しないことを推奨 |
Differential Retention Option (--repo-retention-diff) | 保持する増分バックアップの数 | 増分バックアップなし |
Archive Mode Option (--archive-mode) | リストアされたクラスタのアーカイブを保持または無効にする | 内部固定値を使用 |
Exclude Database Option (--db-exclude) | 指定されたデータベースを除いてリストア | すべてのデータベースを含むFEPクラスタ全体をリストアするため |
Include Database Option (--db-include) | 指定されたデータベースのみをリストア | すべてのデータベースを含むFEPクラスタ全体をリストアするため |
Link All Option (--link-all) | すべてのシンボリックリンクを復元 | 内部固定値を使用 |
Link Map Option (--link-map) | シンボリックリンクのリンク先を変更 | 内部固定値を使用 |
Recovery Option Option (--recovery-option) | postgreSQLのrecovery.confでのオプションの設定 | 内部固定値を使用 |
Tablespace Map Option (--tablespace-map) | テーブルスペースを指定されたディレクトリにリストア | FEPClusterカスタムリソース値からの自動判別用 |
Map All Tablespaces Option (--tablespace-map-all) | すべてのテーブルスペースを指定されたディレクトリにリストア | FEPClusterごとにテーブルスペースが1つしかないため、テーブルスペースは不要 |
TLS Server Address Option (--tls-server-address) | TLSサーバのアドレス | TLSサーバは未使用 |
TLS Server Authorized Clients Option (--tls-server-auth) | TLSサーバ承認済みクライアント | |
TLS Server Certificate Authorities Option (--tls-server-ca-file) | TLSサーバ認証局 | |
TLS Server Certificate Option (--tls-server-cert-file) | TLSサーバ証明書ファイル | |
TLS Server Key Option (--tls-server-key-file) | TLSサーバのファイル | |
TLS Server Port Option (--tls-server-port) | TLSサーバポート | |
PostgreSQL Database Option (--pg-database) | PostgreSQLデータベース | 内部固定値を使用 |
PostgreSQL Host Option (--pg-host) | SSH経由のリモート操作用のPostgreSQLホスト | SSH接続は不要 |
PostgreSQL Host Command Option (--pg-host-cmd) | PostgreSQLホスト上のpgBackRestexeのパス | 内部固定値を使用 |
PostgreSQL Host Configuration Option (--pg-host-config) | pgBackRest構成ファイルのパス | 内部固定値を使用 |
PostgreSQL Host Configuration Include Path Option (--pg-host-config-include-path) | PostgreSQLホストインクルードパスでのpgBackRestの設定 | 内部固定値を使用 |
PostgreSQL Host Configuration Path Option (--pg-host-config-path) | PostgreSQLホスト上でpgBackRestを設定するためのパス | 内部固定値を使用 |
PostgreSQL Host Port Option (--pg-host-port) | SSHポート仕様 | SSH接続は不要 |
PostgreSQL Host User Option (--pg-host-user) | pg-hostが設定されている場合、PostgreSQLをホストするときのログオンユーザー | SSH接続は不要 |
PostgreSQL Path Option (--pg-path) | PostgreSQLデータディレクトリ | FEPClusterカスタムリソース値からの自動判別用 |
PostgreSQL Port Option (--pg-port) | PostgreSQLポート | FEPClusterカスタムリソース値からの自動判別用 |
PostgreSQL Socket Path Option (--pg-socket-path) | PostgreSQL Unixソケットパス | FEPClusterカスタムリソース値からの自動判別用 |
PostgreSQL Database User Option (--pg-user) | PostgreSQLデータベースユーザー | 内部固定値を使用 |
pgBackRest構成リファレンスのパラメータのうち、次のパラメータは設定可能な値を制限しています。
パラメータ | 説明 | 設定可能な値 |
|---|---|---|
repoX-gcs-key-type | Google Cloud Storageを使用する際に指定する鍵ファイルのタイプ | service |
FEPBackupカスタムリソースでは、pgbackrest.confの内容を書き込むことができますが、スタンザ（pgBackRestのバックアップスペース）の設定は内部で指定されます。
次のセクションは許可されていません。
[stanza: command] , [stanza]