Configuration

Barmanには2種類の構成ファイルがあります。

  • グローバル/一般構成

  • サーバー構成

メイン構成ファイル（デフォルトでは /etc/barman.conf にデフォルト）には、メインディレクトリ、システムユーザ、ログファイルなどの一般的なオプションが含まれています。

サーバー構成ファイル（ Barmanによってバックアップされるサーバーごとに1つ）は /etc/barman.d ディレクトリにあり、 .conf サフィックスが必要です。

重要

：歴史的な理由により、グローバルオプションとサーバーオプションの両方を含む1つの構成ファイルを保持できます。ただし、メンテナンス上の理由から、このアプローチは非推奨です。

Barmanの構成ファイルは、INIフォーマットに従います。

構成ファイルは、異なるタイプのパラメーターを受け入れます。

  • 文字列

  • 列挙型

  • 整数

  • ブール値、 on/true/1 も off/false/0 も受け入れられます。

それらのどれも引用する必要はありません。

注：一部の enum では off は許可されますが、 false は許可されません。

オプションの範囲

すべての構成オプションにはスコープがあります。

  • グローバル

  • サーバー

  • global / server：一般的にグローバルレベルで設定できるサーバーオプション

グローバルオプションは、 [barman] labelによってINIファイルで識別される一般セクションで許可されます。

[barman]
; ... global and global/server options go here

サーバーオプションは、サーバーセクションでのみ指定できます。サーバーセクションは、構成ファイルの行で大括弧（ [ および ] ）で識別されます。サーバーセクションは、 BarmanのそのサーバーのIDを表します。次の例では、 pg 名前付けのサーバーのセクションを指定しています。

[pg]
; Configuration options for the
; server named pg go here

Barmanでサーバー名として使用できない2つの予約語があります。

  • barman ：グローバルセクションの識別子

  • all ： Barmanが管理するすべてのサーバーでいくつかのコマンドをシーケンスに実行できる便利なショートカット

Barmanは ConventionoverConfiguration デザインパラダイムを実装しており、柔軟性を失わずに構成に必要なオプションの数を削減しようとします。したがって、一部のサーバーオプションはグローバルレベルで定義し、サーバーレベルでオーバーライドできます。これにより、ユーザーは一般的な動作を指定し、1つ以上のサーバーに対してそれを調整できます。これらのオプションには、グローバル/サーバースコープがあります。

使用可能なすべての構成とそのスコープのリストについては、 section 5 of the 'man' page を参照してください。

man 5 barman

設定の例

以下は、メイン構成ファイルの基本的な例です。

[barman]
barman_user = barman
configuration_files_directory = /etc/barman.d
barman_home = /var/lib/barman
log_file = /var/log/barman/barman.log
log_level = INFO
compression = gzip

一方、以下の例は、ストリーミングバックアップを使用するサーバー構成ファイル。

[streaming-pg]
description =  "Example of PostgreSQL Database (Streaming-Only)"
conninfo = host=pg user=barman dbname=postgres
streaming_conninfo = host=pg user=streaming_barman
backup_method = postgres
streaming_archiver = on
slot_name = barman

次のコードは、 rsync / SSHを使用した従来のバックアップの基本的な例を示しています。

[ssh-pg]
description =  "Example of PostgreSQL Database (via Ssh)"
ssh_command = ssh postgres@pg
conninfo = host=pg user=barman dbname=postgres
backup_method = rsync
parallel_jobs = 1
reuse_backup = link
archiver = on

詳細については、配布された barman.conf ファイル、および ssh-server.conf-template および streaming-server.conf-template テンプレートファイルを参照してください。