newpage

＃設定

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

  • グローバル/一般構成

  • サーバー構成

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

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

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

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

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

  • 文字列

  • 列挙型

  • 整数

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

引用符で囲む必要はありません。

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

オプションの範囲

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

  • グローバル

  • サーバー

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

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

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

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

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

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

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

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

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

使用可能なすべての構成とそのスコープのリストについては、[「man」ページのセクション5] [man5]をページ。

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

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