PGD Lightweight
===============

..  Note::
   このアーキテクチャはPostgres Distributed 5専用です。 PGD 4または3.7が必要な場合は、 :ref:`BDR-Always-ON <BDR-Always-ON>` を使用してください。

軽量構成のEDB Postgres Distributed
5は、テストおよび実稼働での使用に適しています。

このアーキテクチャには、EDBサブスクリプションが必要です。すべてのソフトウェアは
:ref:`Configuring EDB Repos 2.0 repositories <Configuring EDB Repos 2.0 repositories>`  からソースされます。

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

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

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

.. code:: bash

       tpaexec configure ~/clusters/pgd-lw \
           --architecture Lightweight \
           --edb-postgres-extended 15 \
           --platform aws --instance-type t3.micro \
           --distribution Debian \
           --location-names main dr \

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

.. code:: bash

   tpaexec configure --architecture Lightweight --help

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

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

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

  `--architecture` (`-a`),`Lightweight`に設定する必要があります
  Postgres flavour and version (e.g. `--postgresql 15`),有効な :ref:`Postgresのフレーバーとバージョン<Postgresのフレーバーとバージョン>` 。

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

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

  `--platform`,`aws`、`docker`、`bare`のいずれか。,Defaults to `aws`.
  `--location-names`,場所名のスペース区切りのリスト。場所の数は、指定された名前の数と同じです。,TPA will configure a single location with three data nodes.
  `--add-proxy-nodes-per-location`,各場所のプロキシノードの数。,PGD-proxy will be installed on each data node.
  `--bdr-database`,レプリケーションに使用されるデータベースの名前。,Defaults to `bdrdb`.
  `--enable-pgd-probes`,`health/is-ready`などのpgd-プロキシのhttp(s) APIエンドポイントを有効にして、プロキシの状態をプローブできるようにします。,Disabled by default.
  `--proxy-listen-port`,プロキシノードがトラフィックを書き込みリーダーにルーティングするポート。,Defaults to 6432
  `--proxy-read-only-port`,プロキシノードが読み取り専用トラフィックをシャドウノードにルーティングするポート。,Defaults to 6433

軽量構成の詳細
^^^^^^^^^^^^^^

PGD
Lightweightクラスターは2つのロケーションで構成され、2つのノードを含むプライマリアクティブロケーションと、単一のノードを含むディザスターリカバリーdrロケーション。

クラスターの場所名は\ ``--location-names primary dr``
として指定されます。ロケーションは、この定義がユースケースにとって意味のある方法で、レベルの冗長性を提供する独立したデータセンターを表します。たとえば、AWSリージョン、独自のデータセンター、またはサーバーがホストされている場所を識別するためのその他の指定。

..  Note for AWS users::
   TPAを使用してAWSクラスターをプロビジョニングしている場合、場所は指定した`--region` 内の別のアベイラビリティーゾーンにマッピングされます。複数の`--regions` を指定できますが、TPAは現在VPCピアリングを設定して、異なるリージョンのインスタンスが相互に通信できるようにするものではありません。マルチリージョンクラスターの場合、自分自身でVPCピアリングを設定する必要があります。

デフォルトでは、すべてのデータノードすべての場所で、接続ルーティングのためにPGD-プロキシも実行されます。代わりに別のPGD-プロキシインスタンスを作成するには、\ ``--add-proxy-nodes-per-location 3``
または追加する数のプロキシを使用します。

グローバルルーティングは、すべてのプロキシを単一の書き込みリーダーにルートさせます。この書き込みリーダーは、すべての場所で使用可能なすべてのデータノードの間で選択されます。

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

オプションで\ ``--enable-pgd-probes [{http, https}]``
を指定して、プロキシの状態を簡単にプローブできるhttp
APIエンドポイントを有効にすることができます。

:ref:`クラスター構成 <クラスター構成>` で説明されるオプションを指定することもできます。
