Barmanクライアントユーティリティ (barman-cli )¶
以前は別のオープンソースプロジェクトでしたが、 barman-cli
はバージョン2.8からBarmanのコアにマージされ、RPM /
Debianパッケージとして配布されています。 barman-cli
には、PostgreSQLサーバーとともにインストールするための推奨されるクライアントユーティリティのセットが含まれています。
barman-wal-archive：「barman-wal-archiveを介したWALアーカイブ」セクションで説明されているようにarchive_commandとして使用されるアーカイブスクリプト。barman-wal-restore：上記の「get-wal」セクションで説明されているように、スタンバイサーバーおよびリカバリサーバーでrestore_commandリカバリオプションの一部として使用されるWAL復元スクリプト。
詳細については、特定のマニュアルページまたは--help
オプションを参照してください。
インストール¶
Barmanクライアントユーティリティは、通常、PostgreSQLがインストールされている場所にインストールされます。プライマリまたはスタンバイであるすべてのPostgreSQLサーバーにbarman-cli
パッケージをインストールすることをお勧めします。
リポジトリをインストールするには、メインの「インストール」セクションを参照してください。
RedHat/CentOSシステムにパッケージをインストールするには、 root
として次のように入力します。
yum install barman-cli
Debian/Ubuntuでは、 root ユーザーとして次のように入力します。
apt-get install barman-cli
クラウド用Barmanクライアントユーティリティ (barman-cli-cloud )¶
Barmanクライアントユーティリティが拡張され、WALファイルとバックアップをサポートされているクラウドプロバイダーに中継することにより、オブジェクトストレージの統合をサポートし、PostgreSQLデータベースのディザスターリカバリー機能を強化しています。
サポートされているクラウドプロバイダーは次のとおりです。
AWS S3（またはS3互換のオブジェクトストア）
Azure Blobストレージ
Google Cloud Storage（Rest API）
これらのユーティリティは barman-cli-cloud
RPM/Debianパッケージで配布されており、PostgreSQLサーバーと一緒にインストールできます。
barman-cloud-wal-archive：archive_commandとして使用され、 BarmanサーバーをバイパスしてWALファイルをクラウドストレージに直接送信するアーカイブスクリプト。または、WALアーカイブ用のフックスクリプトとして（pre_archive_retry_script）;barman-cloud-wal-restore：restore_commandとして使用して、 BarmanサーバーをバイパスしてクラウドストレージからWALファイルを取得し、PostgreSQLスタンバイに直接保存するスクリプト。barman-cloud-backup：PostgreSQLサーバーで直接ローカルバックアップを作成し、 Barmanサーバーをバイパスしてサポートされているクラウドプロバイダーに送信するために使用されるバックアップスクリプト。または、バーテンダーのバックアップをクラウドにコピーするためのフックスクリプトとして（post_backup_retry_script)barman-cloud-backup-delete：barman-cloud-backupで作成された1つ以上のバックアップをクラウドストレージから削除し、関連するWALを削除するために使用されるスクリプト。barman-cloud-backup-keep：クラウドストレージ内のバックアップにアーカイブバックアップとしてフラグを付けるために使用されるスクリプト-このようなバックアップは、適用される保持ポリシーに関係なく永久に保持されます。barman-cloud-backup-list：クラウドストレージからbarman-cloud-backupで取得したBarmanバックアップの内容をリストするために使用されるスクリプト;barman-cloud-restore：barman-cloud-backupでクラウドストレージから直接取得したバックアップを復元するために使用されるスクリプト;
- aws-s3クラウドプロバイダーの資格情報を設定する方法については、
Credentials を参照してください。
- azure-blob-storageクラウドプロバイダーの資格情報については、
を参照してください。次の環境変数がサポートされています。AZURE_STORAGE_CONNECTION_STRING
、AZURE_STORAGE_KEY 、およびAZURE_STORAGE_SAS_TOKEN 。
--credential オプションを使用して、Azure Active
Directoryを介して認証するために、 azure-cli
またはmanaged-identity の資格情報を指定することもできます。
警告
クラウドユーティリティには、使用するクラウドプロバイダーの適切なライブラリが必要です。(https://github.com/boto/boto3)[boto3]または(https://docs.microsoft.com/en-us/ python/api/azure-storage-blob/?view=azure-python) [azure-storage-blob]および（オプションで）（https://docs.microsoft.com/en-us/python/api/azure-identity /?view=azure-python) [azure-identity]
インストール¶
クラウド用のBarmanクライアントユーティリティは、 Barmanをバイパスしてクラウドプロバイダーに直接バックアップするPostgreSQLサーバーにインストールする必要があります。
barman-cloud-backup および/またはbarman-cloud-wal-archive
をフックスクリプトとして使用する場合は、
Barmanサーバーにbarman-cli-cloud
パッケージをインストールすることもできます。
リポジトリをインストールするには、メインの「インストール」セクションを参照してください。
RedHat/CentOSシステムにパッケージをインストールするには、 root
として次のように入力します。
yum install barman-cli-cloud
Debian/Ubuntuでは、 root ユーザーとして次のように入力します。
apt-get install barman-cli-cloud
barman-cloudフックスクリプト¶
上記の説明に従って、 Barmanサーバーにbarman-cli-cloud
パッケージをインストールします。
以下をPostgreSQLサーバーのBarman構成に追加して、barman-cloud-backup
をポストバックアップスクリプトとして構成します。
post_backup_retry_script = barman-cloud-backup [*OPTIONS*] *DESTINATION_URL* ${BARMAN_SERVER}
警告
フックスクリプトとして実行する場合 barman-cloud-backupはバックアップのステータスがDONEである必要があり、バックアップが他のステータスの場合は失敗します。このため、バックアップのステータスが`WAITING_FOR_WALS` であるときにフックスクリプトが実行されないように、 -w / --wait オプションを使用してバックアップを実行することをお勧めします。
以下をPostgreSQLサーバーのBarman構成に追加して、
barman-cloud-wal-archive
をプレWALアーカイブスクリプトとして構成します。
pre_archive_retry_script = barman-cloud-wal-archive [*OPTIONS*] *DESTINATION_URL* ${BARMAN_SERVER}
クラウドプロバイダーの選択¶
--cloud-provider
オプションを使用して、バックアップとWALのクラウドプロバイダーを選択します。これは次のいずれかに設定できます。
aws-s3[デフォルト]: AWS S3またはS3互換のオブジェクトストア。azure-blob-storage: Azure Blob Storageサービス。google-cloud-storage： Google Cloud Storageサービス。
プロバイダー別の特異性¶
Google Cloud Storage¶
設定¶
google_storage_client依存関係が必要になります：bash pip3 install google-cloud-storage
資格情報を設定するには：
Create a service account そして、サービスアカウントキーを作成します。
バケットのアクセス権を設定します。
バケットのサービスアカウントに Storage Admin Role を付与することをお勧めします。
※ barman_cloudを使用する場合、バケットが存在しない場合は作成されます。バケットの作成にはデフォルトのオプションが使用されます。バケットに特定のオプション（リージョン、ストレージクラス、ラベル）が必要な場合は、必要なものすべてに一致するようにバケットを作成して設定することをお勧めします。
env variable
GOOGLE_APPLICATION_CREDENTIALS
をサービスアカウントキーファイルパスに設定します。
postgres（archive_commandまたはrestore_command）からbarman
cloudを実行している場合は、postgres環境ファイルにGOOGLE_APPLICATION_CREDENTIALS
を設定することを忘れないでください。
使用法¶
一部の詳細は、すべての barman cloud コマンドに固有です。
Google Cloud Storage
--cloud-provider=google-cloud-storageを選択SOURCE_URLはgsとhttpsの両方をサポートしています。例：edb_notranlate_8
使用法¶
一部の詳細は、すべての barman cloud コマンドに固有です。
Google Cloud Storage
--cloud-provider=google-cloud-storageを選択SOURCE_URLはgsとhttpsの両方をサポートしています。例：edb_notranlate_8
