BDR-Always-ON
=============

EDB Postgres Distributed 3.7または4
Always-ON構成で、テストおよび実稼働での使用に適しています。

このアーキテクチャでは、従来の2ndQuadrantリポジトリへのサブスクリプションが必要であり、一部のオプションではEDB
Repos 1.0へのサブスクリプションが必要です。 :ref:`How TPA uses 2ndQuadrant and EDB repositories <How TPA uses 2ndQuadrant and EDB repositories>` を参照

このトピックの詳細については。

BDR-Always-ONアーキテクチャには4つのバリアントがあり、 ``--layout``
構成オプションで選択できます。

1.ブロンズ： 2×bdr +プライマリ、bdr + Witness、バーマン、2×harp-proxy

2.シルバー ：ブロンズ、bdr +witnessがbdr
+プライマリに昇格し、バーテンダーが別の場所に移動しました

3.ゴールド ：それぞれ2×bdr
+プライマリ、2×harp-proxy、およびbarmanを持つ2つの対称的な場所。プラス3番目の場所にbdr
+証人

4.プラチナ ：ゴールド、ただし、各メインの場所に1つのbdr +
readonly（論理スタンバイ）が追加されています

EDBのPostgres Distributed Always On Architectures
 :ref:`whitepaper <EDB Postgres Distributed configuration>` を確認できます

詳細なレイアウト図については。

このアーキテクチャは、PGDバージョン3.7および4で使用するためのものです。

クラスター構成
--------------

構成オプションの概要
^^^^^^^^^^^^^^^^^^^^

このアーキテクチャの\ ``tpaexec configure``
の呼び出し例を以下に示します。

.. code:: shell

   tpaexec configure ~/clusters/bdr \
            --architecture BDR-Always-ON \
            --platform aws --region eu-west-1 --instance-type t3.micro \
            --distribution Debian \
            --edb-postgres-advanced 14 --redwood
            --layout gold \
            --harp-consensus-protocol bdr

helpコマンドを使用して、使用可能なすべてのオプションをリストできます。

.. code:: shell

   tpaexec configure --architecture BDR-Always-ON --help

次の表は、
BDR-Always-ONの必須オプションと追加の重要なオプションについて説明しています。オプションの詳細については、次のセクションで説明します。

必須オプション
^^^^^^^^^^^^^^

.. csv-table::
  :header: Option,Description
  :widths: 10,30
  :align: left
  :class: longtable

  `--architecture` (`-a`),`BDR-Always-ON`に設定する必要があります。
  Postgres flavour and version (e.g. `--postgresql 14`),有効な :ref:`tpaexec-configure <Cluster configuration>` 。
  `--layout`,`bronze`、`silver`、`gold`、`platinum`のいずれか。
  `--harp-consensus-protocol`,`bdr`、`etcd`のいずれか。

追加オプション
^^^^^^^^^^^^^^

.. csv-table::
  :header: Option,Description,Behaviour if omitted
  :widths: 12,25,15
  :align: left
  :class: longtable

  `--platform`,`aws`、`docker`、`bare`のいずれか。,Defaults to `aws`.
  `--enable-camo`,各ロケーションに2つのデータノードをCAMOパートナーとして設定します。,CAMO will not be enabled.
  `--bdr-database`,レプリケーションに使用されるデータベースの名前。,Defaults to `bdrdb`.
  `--enable-harp-probes`,`health/is-ready`などのharpのhttp(s) apiエンドポイントを有効にして、harpの状態をプローブできるようにします。,Disabled by default.

BDR-Always-ON構成の詳細
^^^^^^^^^^^^^^^^^^^^^^^

``--layout layoutname``
を指定して、サポートされているBDRユースケースのバリエーションのいずれかを設定する必要があります。許可される引数は、ブロンズ、シルバー、ゴールド、およびプラチナです。ブロンズ、ゴールド、プラチナのレイアウトには、Raftコンセンサスマジョリティのノード数が奇数であることを保証するPGD
Witnessノードがあります。
Witnessノードはデータレプリケーションに参加しません。

``--harp-consensus-protocol protocolname``
を指定する必要があります。サポートされているプロトコルはbdrおよびetcdです。詳細については、 :ref:`Configuring HARP <Configuring HARP>` を参照してください。

オプションで\ ``--bdr-database dbname``
を指定して、PGDを有効にしたデータベースの名前を設定できます（デフォルト：bdrdb）。

オプションで\ ``--enable-camo``
を指定して、各リージョンのPGDプライマリインスタンスのペアを互いのCAMOパートナーに設定できます。

オプションで\ ``--enable-harp-probes [{http, https}]``
を指定して、http(s)
apiエンドポイントを有効にして、harpのヘルスを簡単にプローブできるようにします。

BDR-Always-ONアーキテクチャでは、デフォルトでHARP2を有効にすることに注意してください。

 :ref:`tpaexec help configure-options <Cluster configuration>` で説明されているオプションのいずれかを指定することもできます。
