• チュートリアル

---

ビルド

PgBouncer は、Autoconf ベースのビルドシステムでも、より新しい、まだ実験的な Meson ビルドシステムでもビルドできます。現時点では、本番用のビルドおよびパッケージングには Autoconf が推奨されます。Meson ビルドは将来のリリースでデフォルトになり、Autoconf ビルドは削除される見込みのため、Meson のテストと問題の報告を歓迎します。コンパイルにはいくつかの要素が必要です：

• Libevent 2.0+
• pkg-config
• OpenSSL 1.0.1+（TLS サポート用）
• C11 対応の C コンパイラー
• (オプション) c-ares は Libevent の evdns の代替として利用可能
• (オプション) LDAP ライブラリ
• (オプション) PAM ライブラリ

Meson ビルドにはさらに Meson 0.58+ と Ninja が必要であり、Autoconf ビルドには GNU Make 3.81+ が必要です。

依存関係がインストールされたら、Autoconf でビルドします：

$ ./configure --prefix=/usr/local
$ make
$ make install

または Meson でビルドします（実験的）：

$ meson setup build --prefix=/usr/local
$ meson compile -C build
$ meson install -C build

Git からビルドする場合、または Windows 用にビルドする場合は、以下の別途のビルド手順を参照してください。

---

DNS ルックアップサポート

PgBouncer は、設定の読み込み時に一度だけではなく、接続時にホスト名のルックアップを行います。これには非同期 DNS 実装が必要です。以下の表は、サポートされるバックエンドとその検出順序を示しています。

1. EDNS0 は、1 つのホスト名の背後に 8 件を超えるアドレスがある場合に必要です。
2. SOA の照会は、ゾーンシリアルの変更時にホスト名を再確認するために必要です。
3. EDNS0 を有効にするには、options edns0 を /etc/resolv.conf に追加してください。

c-ares は最も機能が充実しており、ほとんどの用途およびバイナリパッケージング（十分に新しいバージョンが利用可能な場合）に推奨されます。Libevent の組み込み evdns も、記載された制限を除き多くの用途に適しています。他のバックエンドは現在、ほとんどがレガシーな選択肢であり、テストもほとんど行われていません。

デフォルトでは、c-ares が見つかった場合に使用されます。使用を強制するには -Dcares=enabled（configure の場合は --with-cares）、無効化するには -Dcares=disabled（configure の場合は --without-cares）を指定します。c-ares を使用しない（見つからないか無効化されている）場合、Libevent が使用されます。Libevent の evdns の使用を無効にして libc ベースの実装にフォールバックするには、-Devdns=false（configure の場合は --disable-evdns）を指定してください。

---

オプション機能

PAM、LDAP、systemd の各機能は meson によって自動検出されます。-Dpam、-Dldap、-Dsystemd の各オプションのデフォルトは auto であり、それぞれのライブラリが存在する場合にその機能がビルドされます。-D<feature>=enabled で強制的に有効に、-D<feature>=disabled で強制的に無効にできます。Autoconf ビルドはこれらの機能を自動検出しません。--with-pam、--with-ldap、または --with-systemd で明示的に有効にしてください。

---

PAM 認証

PAM サポート付きでコンパイルした場合、PAM を通じてユーザーを検証する新しいグローバル認証タイプ pam が利用可能になります。

---

LDAP 認証

LDAP サポート付きでコンパイルした場合、LDAP を通じてユーザーを検証する新しいグローバル認証タイプ ldap が利用可能になります。

---

systemd 統合

systemd サポートでは、Type=notify（systemd 253 以降を使用している場合は Type=notify-reload）およびソケット活性化を利用できます。例については etc/pgbouncer.service および etc/pgbouncer.socket を参照してください。

---

Git からビルドする

Autoconf ビルドでは、configure を実行する前にヘッダーファイルおよび設定ファイルを生成する必要があります：

$ git clone --branch pgbouncer_1_26_0 https://github.com/pgbouncer/pgbouncer.git
$ cd pgbouncer
$ ./autogen.sh
$ ./configure
$ make
$ make install

デフォルトでは、すべてのファイルが /usr/local にインストールされます。 configure に 1 つ以上のコマンドラインオプションを指定できます。 利用可能なオプションおよび設定をカスタマイズする環境変数を確認するには、./configure --help を実行してください。

Git からの Autoconf ビルドに追加で必要なパッケージ: autoconf, automake, libtool, pandoc

Meson ビルドでは、チェックアウトから直接ビルドできます。 man ページをビルドするには pandoc が必要です：

$ meson setup build
$ meson compile -C build
$ meson install -C build

利用可能な -D オプションを一覧表示するには、meson configure build を実行してください。

---

テスト

テストディレクトリ内の README.md ファイル を参照して、テストの実行方法を確認してください。

---

Windows 上でのビルド

Windows でサポートされている唯一のビルド環境は MinGW です。Cygwin および Visual $ANYTHING はサポートされていません。

MinGW でビルドするには、通常の Autoconf ビルドを行います：

$ ./configure
$ make

または実験的な Meson ビルドを行います：

$ meson setup build
$ meson compile -C build

Autoconf を使って Unix からクロスコンパイルする場合:

$ ./configure --host=i586-mingw32msvc

LDAP ビルドオプションは現在、Windows ではサポートされていません。

---

Windows 上での実行

コマンドラインからの実行は通常通りですが、-d（デーモン化）と -u（ユーザー切り替え）のスイッチは機能しません。

Windows サービスとして PgBouncer を実行するには、service_name パラメーターを設定してサービス名を指定する必要があります。その後、以下を実行します。

$ pgbouncer -regservice config.ini

サービスをアンインストールするには：

$ pgbouncer -unregservice config.ini

Windows イベントログを使用するには、設定ファイルで syslog = 1 を設定してください。 ただし、その前に pgbevent.dll の登録が必要です。

$ regsvr32 pgbevent.dll

登録を解除するには、次のようにします：

$ regsvr32 /u pgbevent.dll