A First Cluster Deployment ========================== この短いチュートリアルでは、単純な :ref:`M1 ` デプロイメントをローカルDockerインストールに展開する手順を説明します。最後までに、4つのコンテナ、1つのプライマリデータベース、2つのレプリカ、およびバックアップノードが構成され、探索できる準備が整います。 この例では、UbuntuシステムでTPAを実行しますが、ほとんどのLinuxシステムで考慮事項は同様です。 TPAのインストール ^^^^^^^^^^^^^^^^^ あなたがEDB顧客の場合、EDBのリポジトリからTPAパッケージを直接インストールする :ref:`TPA installation ` に従ってください。 TPAのオープンソースユーザーであれば、Github.comからダウンロードできる :ref:`Installing TPA from source ` があります。 これらのガイドに従って、ここに戻ります。 Dockerのインストール ^^^^^^^^^^^^^^^^^^^^ 前述のように、展開例をDockerに展開します。まだDockerをインストールしていない限り、それをセットアップする必要があります。 DebianまたはUbuntuでは、次のコマンドを実行してDockerをインストールします。 :: sudo apt update sudo apt install docker.io 他のLinuxディストリビューションについては、 `Docker Engine Install page `_ を参照してください。 次を使用してユーザーをdockerグループに追加します。 :: sudo usermod -aG docker newgrp docker .. Warning:: ユーザーにDockerデーモンと対話できる機能を付与すると、Dockerホストでのrootを簡単に取得できます。信頼できるユーザーのみがDockerデーモンにアクセスできる必要があります。 .. Note on RHEL 7 instances:: RHEL 7インスタンスを使用するには、cgroups v1を実行するようにホストを構成する必要があります。 システムのドキュメントを参照してcgroups構成を確認および変更するか、このチュートリアルに従うコンテナ用の別のオペレーティングシステムを選択します。 TPAを使用した構成の作成 ^^^^^^^^^^^^^^^^^^^^^^^ このプロセスの次のステップは、構成を作成することです。 TPAは、 ``configure`` コマンドを介して作業のほとんどを実行します。あなたがしなければならないのは、コマンドラインフラグとオプションを指定して、展開するものを大まかに選択することです。 ``tpaexec configure`` コマンドは次のとおりです。 :: tpaexec configure demo --architecture M1 --platform docker --postgresql 15 --enable-repmgr --no-git これにより、 :ref:`M1 ` を含む\ ``demo`` という構成が作成されます。したがって、プライマリ、レプリカ、バックアップノードがあります。 ``--platform docker`` は、この構成をローカルのDockerインスタンスで作成する必要があることをTPAに指示します。すべてのコンテナとOS要件をプロビジョニングします。他のプラットフォームには、アマゾンウェブサービスと同じことを行う :ref:`awscliを使用してボリューム属性を変更する ` と :ref:`bare(-metal servers) ` が含まれます。オペレーティングシステムのプロビジョニングをスキップし、既に構成されたLinuxホストへのソフトウェアのインストールに直接進みます。 ``--postgresql 15`` では、Community Postgresバージョン15を使用するようにTPAに指示します。ソフトウェアの選択に関していくつかのオプションがありますが、これはオープンソースユーザーにとって最も簡単なデフォルトです。 ``--enable-repmgr`` を追加すると、TPAに :ref:`Replication Manager ` を使用してレプリケーションとフェイルオーバーをハンドリングするように展開を構成するように指示します。 最後に、\ ``--no-git`` は、gitを介して構成をリビジョン制御できるTPAの機能をオフにします。 このコマンドを実行すると、どうやらコマンドラインでは何も起こりません。ただし、 ``demo`` というディレクトリが作成され、新しい展開のブループリントである\ ``config.yml`` ファイルを含むいくつかのファイルが含まれています。 デプロイメントのプロビジョニング -------------------------------- これで、新しい展開を実行するコンテナまたは仮想マシンを作成する準備が整いました。これは、 ``provision`` コマンドで実現できます。実行します :: tpaexec provision demo 構成の展開の準備に必要なさまざまな操作を介したTPAの動作が表示されます。 Deploying --------- プロビジョニングが完了したら、展開に進むことができます。これにより、必要に応じて、オペレーティングシステムとシステムパッケージがインストールされます。次に、要求されたPostgresアーキテクチャをインストールし、必要な構成をすべて実行します。 :: tpaexec deploy demo 構成を展開するために必要なさまざまな操作を介したTPAの動作が表示されます。 テスト ------ 新しいデータベースでpgbenchを実行する tpaexec ``test`` コマンドを使用して、新しく展開された構成をすばやくテストできます。 :: tpaexec test demo 接続しています -------------- psqlプロンプトを表示するには、最も簡単なルートは、dockerまたはSSHを使用して、コンテナまたは構成に応じてVMまたはホストのいずれかにログインすることです。走る :: tpaexec ping demo 展開内のすべての接続可能なホストにpingを実行すると、次のような出力が得られます。 :: $ tpaexec ping demo unfair | SUCCESS => { "changed": false, "ping": "pong" } uptake | SUCCESS => { "changed": false, "ping": "pong" } quondam | SUCCESS => { "changed": false, "ping": "pong" } uptight | SUCCESS => { "changed": false, "ping": "pong" } ``SUCCESS`` で応答したノードの1つを選択します。この例では、 ``uptake`` を使用します。 dockerのみを使用する予定がある場合は、 ``docker exec -it uptake /bin/bash`` コマンドを使用して、適切なホスト名に置き換えます。 すべての種類のTPA展開で機能する別のオプションは、SSHを使用することです。これを行うには、最初に現在のディレクトリを作成した構成ディレクトリに変更します。 たとえば、構成の名前付けはdemoなので、そのディレクトリに移動します。そこで、\ ``ssh -F ssh_config ourhostname`` を実行して接続します。 :: cd demo ssh -F ssh_config uptake Last login: Wed Sep 6 10:08:01 2023 from 172.17.0.1 [root@uptake ~]# どちらの場合も、コンテナにrootユーザーとしてログインします。 ``sudo -iu postgres`` を使用して、ユーザーを\ ``postgres`` ユーザーに変更できるようになりました。 ``postgres`` として、 ``psql`` を実行できます。 TPAはそのユーザーを\ ``.pgpass`` ファイルで既に構成しているため、パスワードを提示する必要はありません。 :: [root@uptake ~]# postgres@uptake:~ $ psql psql (15.4) Type "help" for help. postgres=# そして、データベースに接続しています。 SSHを使用せずにホストシステムからコンテナに接続できます。 ``ssh_config`` ファイルから接続するホストのIPアドレスを取得します。 :: $ grep "^ *Host" demo/ssh_config Host * Host uptight HostName 172.17.0.9 Host unfair HostName 172.17.0.4 Host quondam HostName 172.17.0.10 Host uptake HostName 172.17.0.11 Uptakeに接続するので、IPアドレスは172.17.0.11です。 また、 postgresユーザーのパスワードも取得する必要があります。 ``tpaexec show-password demo postgres`` を実行して、システムから保存されたパスワードを取得します。 :: tpaexec show-password demo postgres a9LmI1X^uMOpPoEnLuRdL%L$oRQak3om Postgresqlクライアントがインストールされていると仮定すると、次のことを実行できます。 :: psql --host 172.17.0.11 -U postgres Password for user postgres: 前に取得したパスワードを入力します。 :: psql (14.9 (Ubuntu 14.9-0ubuntu0.22.04.1), server 15.4) WARNING: psql major version 14, server major version 15. Some psql features might not work. SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, bits: 256, compression: off) Type "help" for help. postgres=# これで、Dockerホストから、TPA展開されたDockerコンテナのいずれかで実行されているPostgresに接続されました。