Deploying an EDB Postgres Distributed example cluster on AWS#

このクイックスタートでは、Amazon EC2を使用してAlways On Single LocationアーキテクチャでEDB Postgres分散をセットアップします。

TPAとPGDの紹介#

私たちは、さまざまなPostgres構成のインストールと管理を簡単に再現可能にするためにTPAを作成しました。 TPAは、Postgresの作成と展開を調整します。このクイックスタートでは、最初にTPAをインストールします。既にTPAをインストールしている場合、これらの手順をスキップできます。 TPAを使用して、さまざまな構成のPostgresクラスターを展開できます。

PGDは、高いパフォーマンスと可用性を実現するように設計されたPostgresのマルチマスター複製実装です。 PGDのインストールは、TPAによって調整されます。 TPAを使用して、PGDデモクラスターの構成ファイルを生成します。このクラスターはAmazon EC2インスタンスを使用します

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

準備#

注釈

このセットの手順は、Intel / AMDプロセッサー上のUbuntu 22.04 LTS専用です。 !!!

EDBアカウント#

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

Sign up for a free EDB account

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

登録したら、 EDB Repos 2.0 ページに移動し、リポトークンを取得します。

このページに最初にアクセスしたときに、 Request Access を選択してリポトークンを生成します。 Copy Token アイコンを使用してトークンをコピーし、安全に保存します。

カールのインストール#

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 Distributedパッケージリポジトリから入手できます。次のコマンドは、 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 ArchitectTPAのインストール#

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を構成する必要があります。次のコマンドでtpaexec を呼び出します setup

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

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

TPAインストールのテスト#

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

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

###  AWS資格情報

TPAは、AWS資格情報を使用して、AWSへの展開を実行します。企業管理のアカウントをお持ちでない限り、 `get your credentials from AWS <https://docs.aws.amazon.com/singlesignon/latest/userguide/howtogetcredentials.html>`_  する必要があります。企業が管理するアカウントには、資格情報を取得するための独自のプロセスがあります。

資格情報は、AWSアクセスキーIDとシークレットアクセスキーで構成されます。作業用のAWSデフォルトリージョンを選択する必要もあります。

環境変数`AWS_ACCESS_KEY_ID` 、`AWS_SECRET_ACCESS_KEY` 、および`AWS_DEFAULT_REGION` をAWS資格情報の値に設定します。これらを`.bashrc` または同様のシェルプロファイルに追加して、常に設定されるようにできます。

```shell
$ export AWS_ACCESS_KEY_ID=THISISJUSTANEXAMPLE
$ export AWS_SECRET_ACCESS_KEY=d0ntU5E/Th1SAs1ts/jUs7anEXAMPLEKEY
$ export AWS_DEFAULT_REGION=us-west-2

アカウントには、TPAが使用するリソースを作成および管理するために必要な権限が必要です。: TPA AWS platform ページには、必要な権限の詳細が記載されています。これについてサポートが必要な場合は、AWS管理者に相談してください。

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

構成ファイルの生成#

tpaexec configure コマンドを実行して、構成フォルダーを生成します。

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

PGD-Always-ONアーキテクチャ --architecture PGD-Always-ON を指定します。これは、

PGD 5's Always On architectures の構成をセットアップします。デフォルトアーキテクチャの一部として、これは3つのデータノードでクラスターを構成し、3つの各ホストにPGDプロキシ構成をインストールするサーバーとバックアップ用の Barman ノードをコホストします。

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

TPAは、AWSのt3.microインスタンスにデフォルトします。このデモにはこれで十分であり、: AWS free tier アカウントでの使用にも適しています。

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

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

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

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

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

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

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

less democluster/config.yml

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

Trusted Postgres Architectドキュメントの PGD-Always-ON - Trusted Postgres Architectドキュメントの tpaexec configure - Trusted Postgres Architectドキュメントの AWS platform

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

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

tpaexec provision democluster

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

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

クラスターの展開#

構成が配置され、インフラストラクチャがプロビジョニングされると、分散クラスターを Deploying an EDB Postgres Distributed example cluster on AWS できるようになります。

tpaexec deploy democluster

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

クラスターへの接続#

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

cd democluster

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

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

kaboomに管理者としてログインしていることに注意してください。

次に、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 dc1_subgroup [0.0.0.0]        6432
kaftan dc1_subgroup [0.0.0.0]        6432
kaolin dc1_subgroup [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=#

クラスターを探索する#

Connect your database アプリケーションへ
Explore failover 実践演習付き
Understand conflicts 作成とモニタリング
Next Steps with PGD クラスターでの作業において

Deploying an EDB Postgres Distributed example cluster on AWS

目次

Deploying an EDB Postgres Distributed example cluster on AWS#

TPAとPGDの紹介#

準備#

EDBアカウント#

カールのインストール#

環境変数の設定#

リポジトリの構成#

Trusted Postgres ArchitectTPAのインストール#

Linux環境#

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

TPAの設定#

TPAインストールのテスト#

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

構成ファイルの生成#

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

クラスターの展開#

クラスターへの接続#

PGD CLIを使用する#

クラスターを探索する#