Deploying an EDB Postgres Distributed example cluster on AWS

このクイックスタートでは、Amazon EC2を使用して、 Always On単一ロケーションアーキテクチャでEDB Postgres Distributedをセットアップします。

TPAとPGDの紹介

さまざまなPostgres構成のインストールと管理を簡単に繰り返し行えるようにするために、TPAを作成しました。 TPAは、Postgresの作成とデプロイを調整します。このクイックスタートでは、最初にTPAをインストールします。 TPAが既にインストールされている場合は、これらの手順をスキップできます。 TPAを使用して、Postgresクラスターのさまざまな構成をデプロイできます。

PGDは、高いパフォーマンスと可用性を実現するように設計されたPostgresのマルチマスター複製実装です。 PGDのインストールは、TPAによって調整されます。 TPAを使用して、PGDデモンストレーションクラスターの構成ファイルを生成します。このクラスターはAmazon EC2インスタンスを使用し、3つのデータノードでクラスターを構成し、3つの Installing PGD Proxy サーバーと Barman を共ホスティングします

バックアップ用のノード。次に、TPAを使用して、必要な構成とソフトウェアを各ノードにプロビジョニングおよび展開できます。

準備

注釈

この一連の手順は、特にIntel / AMDプロセッサー上のUbuntu 22.04 LTSを対象としています。 !!!

EDBアカウント

TPAとPGDの両方をインストールするには、EDBアカウントが必要です。

まだお持ちでない場合。サインアップすると、EDBのソフトウェアリポジトリへの試用版サブスクリプションが提供されます。

登録したら、

EDB Repos 2.0 ページに移動し、リポジトリトークンを取得できます。

このページに初めてアクセスしたときに、[ RequestAccess ]を選択してリポジトリトークンを生成します。 CopyToken アイコンを使用してトークンをコピーし、安全に保存します。

curlをインストールする

curl コマンドを使用して、リポジトリからインストールスクリプトを取得します。 Ubuntuでは、curlはデフォルトではインストールされません。存在するかどうかを確認するには、ターミナルでcurl を実行します。

$ curl
Command curl not found, but can be installed with:
sudo apt install curl

見つからない場合は、次を実行します。

sudo apt -y install curl

環境変数の設定

まず、 EDB_SUBSCRIPTION_TOKEN 環境変数を、

EDBアカウント ステップで取得したEDBリポジトリトークンの値に設定します。

export EDB_SUBSCRIPTION_TOKEN=<your-repo-token>

これを.bashrc スクリプトまたは同様のシェルプロファイルに追加して、常に設定されるようにすることができます。

リポジトリを構成する

この例に必要なすべてのソフトウェアは、 EDB Postgres分散パッケージリポジトリから入手できます。次のコマンドは、スクリプトをダウンロードして実行し、 EDB Postgres分散リポジトリを構成します。このリポジトリには、TPAパッケージも含まれています。

curl -1sLf "https://downloads.enterprisedb.com/$EDB_SUBSCRIPTION_TOKEN/postgres_distributed/setup.deb.sh" | sudo -E bash

edb_notranlate_4出力またはエラーが生成されない場合は、トークンを正しく入力したことを再確認してください。問題が解決しない場合は、 contact Support で支援を求めてください。

Trusted Postgres Architect（TPA）のインストール

TPAを使用して、PGDをプロビジョニングおよびデプロイします。以前にTPAをインストールしたことがある場合は、

Next Steps with PGD に進むことができます。

TPAをインストールするための完全な手順は、 Trusted Postgres Architect documentation 、これもここに含まれています。

Linux環境

ホストプラットフォームとしての TPA supports several distributions of Linux 。これらの例はUbuntu 22.04用に書かれていますが、サポートされている他のプラットフォームでも手順は似ています。

TPAパッケージをインストールする

sudo apt install tpaexec

TPAの構成

TPAのPython環境を構成するTPAを構成する必要があります。 setup コマンドでtpaexec を呼び出します。

sudo /opt/EDB/TPA/bin/tpaexec setup
export PATH=$PATH:/opt/EDB/TPA/bin

export コマンドをシェルのプロファイルに追加できます。

TPAインストールのテスト

selftest を実行して、TPAが正しくインストールされたことを確認できます。

  tpaexec selftest
  ``` TPAがインストールされました。

  ###  AWS CLI

  TPAはAWS CLIを使用してプロビジョニングとデプロイします。 `Install the CLI <https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html>`_ 、次に十分なアクセス権を持つIAMユーザーの `configure credentials <https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html>`_ 。 :ref:`TPA AWS platform <Deploying EDB Postgres Distributed using Trusted Postgres Architect>` には、必要な権限が詳しく説明されています。

  ##  TPAを使用したPGDのインストール

  ###  構成ファイルの生成

  :ref:`tpaexec configure <Deploying EDB Postgres Distributed using Trusted Postgres Architect>` コマンドを実行して、構成フォルダーを生成します。

  ```shell-session
  tpaexec configure democluster \
    --architecture PGD-Always-ON \
    --platform aws \
    --region eu-west-1 \
    --edb-postgres-advanced 15 \
    --redwood \
    --location-names dc1 \
    --pgd-proxy-routing global \
    --no-git \
    --hostnames-unsorted

:ref:`PGD 5's Always On architectures <Choosing your architecture>` の構成を設定するPGD-Always-ONアーキテクチャ（\ ``--architecture PGD-Always-ON``

）を指定します。デフォルトアーキテクチャの一部として、これにより、3つのデータノードでクラスターが構成され、3つの Installing PGD Proxy サーバーと、バックアップ用の Barman ノードが共ホスティングされます。

AWS（--platform aws ）を使用していることを指定し、リージョン（--region eu-west-1 ）としてeu-west-1を指定します。

TPAのデフォルトは、AWSのt3.microインスタンスです。このデモンストレーションにはこれで十分であり、

AWS free tier アカウントでの使用にも適しています。

デフォルトでは、TPAはDebianをAWS上のすべてのノードのデフォルトOSとして構成します。

TPAの実行に使用しているのと同じプラットフォームにPGDを展開する必要はないことに注意してください。

データノードがOracle互換性（--redwood ）で EDB Postgres Advanced Server v15 （--edb-postgres-advanced 15 ）を実行することを指定します。

--location-names を使用して、ノードの概念的な場所をdc1 に設定します。次に、 --pgd-proxy-routing をglobal に設定して、プロキシルーティングがクラスター内のすべてのノードにトラフィックをルーティングできるようにします。

デフォルトでは、TPAは構成の変更をGitリポジトリにコミットします。この例では、それを行う必要はないため、 --no-git フラグを渡します。

最後に、 --hostnames-unsorted を渡して、ノードの反復可能なホスト名を生成するようにTPAに依頼します。それ以外の場合は、事前に定義された適切な単語のリストからホスト名をランダムに選択します。

このコマンドは、現在の作業ディレクトリにdemocluster というサブディレクトリを作成します。 TPAがクラスターの作成に使用するconfig.yml 構成ファイルが含まれています。次を使用して表示できます。

less democluster/config.yml

edb_notranlate_10 - Deploying with TPA のPGD-Always-ON構成オプションの詳細

クラスターのプロビジョニング：

次に、

tpaexec provision コマンドを使用して、作成したばかりの構成を実行するために必要なリソースを割り当てます。

shell tpaexec provision democluster

プラットフォーム（デフォルトプラットフォーム）としてAWSを指定したため、TPAはEC2インスタンス、VPC、サブネット、ルーティングテーブル、インターネットゲートウェイ、セキュリティグループ、EBSボリューム、Elastic IPなどをプロビジョニングします。

設定時に既存のものを指定しなかったため、TPAはS3バケットの作成の確認も求めます。

Trusted Postgres Architectドキュメントの.. SeeAlso "Further reading"::

クラスターのデプロイ

構成が整い、インフラストラクチャがプロビジョニングされたら、分散クラスターを Choosing your deployment method できるようになりました。

tpaexec deploy democluster

TPAは構成を適用し、必要なパッケージをインストールして、実際のEDB Postgres分散クラスターをセットアップします。

Trusted Postgres Architectドキュメントの.. SeeAlso "Further reading"::

クラスターへの接続

これで、SSHを使用してクラスターのノードのいずれかにログインし、データベースに接続する準備が整いました。構成プロセスの一部では、キーを使用して、すべてのノードのSSHログインを設定します。 SSH構成を使用するには、前に tpaexec configure コマンドで作成したdemocluster ディレクトリにいる必要があります。

cd democluster

そこから ssh -F ssh_config <hostname> を実行してSSH接続を確立できます。クラスター内の最初のデータベースノードであるkaboomに接続します。

ssh -F ssh_config kaboom
__OUTPUT__
[admin@kaboom ~]#

kaboomでadminとしてログインしていることに注意してください。

ここで、enterprisedbユーザーのIDを採用する必要があります。このユーザーは、クラスターのノードに接続するように事前構成され、承認されています。

sudo -iu enterprisedb
__OUTPUT__
enterprisedb@kaboom:~ $

psql コマンドを実行して、 bdrdbデータベースにアクセスできます。

psql bdrdb
__OUTPUT__
psql (15.2.0, server 15.2.0)
Type "help" for help.

bdrdb=#

kaboomノードで実行されているPostgresデータベースに直接接続され、 SQLコマンドの発行を開始できます。

SQLクライアントを終了するには、 exit と入力します。

PGD CLIの使用

PGD CLIとしても知られるpgdユーティリティを使用すると、 EDB Postgres分散クラスターを制御および管理できます。すでにノードにインストールされています。

pgd check-health を実行して、クラスターの状態を確認するために使用できます。

pgd check-health
__OUTPUT__
Check      Status Message
- ----      ------ -------
ClockSkew  Ok     All BDR node pairs have clockskew within permissible limit
Connection Ok     All BDR nodes are accessible
Raft       Ok     Raft Consensus is working correctly
Replslots  Ok     All BDR replication slots are working correctly
Version    Ok     All nodes are running same BDR versions
enterprisedb@kaboom:~ $

または、 pgd show-nodes を使用して、クラスター内のデータを保持するノードを表示するようにPGDに依頼できます。

pgd show-nodes
__OUTPUT__
Node   Node ID    Group        Type Current State Target State Status Seq ID
- ---   -------    -----        ---- ------------- ------------ ------ ------
kaboom 2710197610 dc1_subgroup data ACTIVE        ACTIVE       Up     1
kaftan 3490219809 dc1_subgroup data ACTIVE        ACTIVE       Up     3
kaolin 2111777360 dc1_subgroup data ACTIVE        ACTIVE       Up     2
enterprisedb@kaboom:~ $

同様に、 pgd show-proxies を使用してプロキシ接続ノードを表示します。

pgd show-proxies
__OUTPUT__
Proxy  Group       Listen Addresses Listen Port
- ----  -----       ---------------- -----------
kaboom democluster [0.0.0.0]        6432
kaftan democluster [0.0.0.0]        6432
kaolin democluster [0.0.0.0]        6432

プロキシは、アプリケーションのデータノードのクラスターへの高可用性接続を提供します。コマンドpsql -h kaboom,kaftan,kaolin -p 6432 bdrdb を使用して、プロキシに接続し、さらにデータベースに接続できます。

psql -h kaboom,kaftan,kaolin -p 6432 bdrdb
__OUTPUT__
psql (15.2.0, server 15.2.0)
SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, compression: off)
Type "help" for help.

bdrdb=#

クラスターを探索する

*クラスターでの Next Steps with PGD