Upgrading your cluster ====================== ``tpaexec upgrade`` コマンドは、TPAクラスターで実行されているソフトウェアをアップグレードするために使用されます。 ``tpaexec deploy`` はアップグレードを実行しません。 このコマンドは、以前の\ ``tpaexec update-postgres`` コマンドを置き換えます。 .. Note:: TPAは、共有Barmanおよび/または共有PEM構成を持つクラスターでの`tpaexec upgrade` コマンドの使用をまだサポートしておらず、将来のリリースでこの機能を追加します。 .. :: ##はじめに config.ymlに変更を加えた場合、それらの変更を適用する方法は、\ ``tpaexec provision`` に続いて\ ``tpaexec deploy`` を実行することです。 このルールの例外は、 ``tpaexec deploy`` が既にインストールされているパッケージの別のバージョンのインストールを拒否することです。代わりに、\ ``tpaexec upgrade`` を使用してソフトウェアアップグレードを実行する必要があります。 次のコンポーネントは、 **任意の** アーキテクチャでアップグレードできます。 - Postgres - :ref:`Repmgrリダイレクトpgbouncer ` - :ref:`barman-pre-config ` - :ref:`PG Backup API ` - :ref:`現在以外の`pem_server_package_version` が指定されている場合、Debianのようなインスタンスでのデプロイが失敗する TPA-1178 <現在以外の`pem_server_package_version` が指定されている場合、Debianのようなインスタンスでのデプロイが失敗する TPA-1178>` サーバーとエージェントの両方 次のコンポーネントは **M1** アーキテクチャでアップグレードでき、使用されるフェールオーバーマネージャーに応じて異なります。 - :ref:`efm-pre-config ` - :ref:`Patroni cluster management commands ` - :ref:`etcd ` パトローニ用 - :ref:`Repmgrリダイレクトpgbouncer ` 次のコンポーネントは、使用するBDRバージョンに応じて、 **BDR -Always-ON** / **PGD-Always-ON** アーキテクチャでアップグレードできます。 - :ref:`pgdcli ` BDR 4の場合はv1、PGD5の場合はv5 - :ref:`pgd-proxy-config ` PGD5のみ .. Note Minor version upgrades only:: **`tpaexec upgrade` は、Postgresおよびほとんどのクラスターコンポーネントのメジャーバージョンのアップグレードをサポートしていません** TPAがアップグレードできるものは、アーキテクチャによって異なります。 - M1アーキテクチャと、M1に該当するすべてのフェールオーバーマネージャー、\ ``upgrade`` は、 ``Postgres`` 、対応するフェールオーバーマネージャー\ ``EFM`` 、\ ``Patroni`` または\ ``repmgr`` 、および選択された非アーキテクチャ固有のコンポーネントのマイナーバージョンのアップグレードを実行できます。 - PGDアーキテクチャでは、 ``upgrade`` は、 PostgresとBDR拡張機能、および明示的にオプトインされている場合 ``pgd-cli`` および\ ``pgd-proxy`` のマイナーバージョンのアップグレードを実行します。 - PGDアーキテクチャでは、 ``reconfigure`` コマンドとの組み合わせでのみ、 ``upgrade`` はBDR拡張機能のメジャーバージョンのアップグレードを実行できます。 他のクラスターコンポーネントのアップグレードのサポートがTPA ``v23.41.0`` に追加されました \*特定のコンポーネント ``EFM`` などは例外です。詳細については、各コンポーネントのドキュメントの\ ``upgrade`` セクションを参照してください。 .. :: このコマンドは、クラスター操作の中断を最小限に抑えてアップグレードを実行しようとします。特殊なアップグレードプロセスの正確な詳細は、以下に文書化されているように、クラスターのアーキテクチャによって異なります。 アップグレードするときは、アップグレードを開始する前に常にbarmanを使用してバックアップをとり、アップグレードのために確保されている時間中に実行されるスケジュールされたバックアップを無効にする必要があります。 一般に、TPAはインスタンスごとに続行し、影響を受けるサービスの停止、新しいパッケージのインストール、必要に応じて構成の更新、サービスを再起動し、ランタイム構成の変更を実行してから、次のインスタンスで同じことを行う前に。プロセス中の任意の時点で、クラスターのノードの1つだけが使用不可になります。 クラスターをPGD-Always-ONにアップグレードする場合、または既存のPGD-Always-ONクラスターをアップグレードする場合、 ``tpaexec upgrade`` コマンドラインにオプション ``-e enable_proxy_monitoring=true`` を追加することにより、アップグレード中にプロキシノードのステータスのモニタリングを有効にできます。有効にすると、bdrデータベースに追加のテーブルが作成され、アップグレードの実行中に監視データがそこに書き込まれます。モニタリングを有効にすることによるパフォーマンスへの影響は非常に小さいため、有効にすることをお勧めします。 コンポーネントの選択 -------------------- .. Note:: コンポーネントのアップグレードは厳密にオプトインです .. :: デフォルトでは、 `--components` フラグが渡されない場合、`tpaexec upgrade` はPostgresを単独で更新します .. code:: shell tpaexec upgrade ~/clusters/speedy 更新する特定のコンポーネントを選択するために、\ ``--components`` フラグはコンマ区切りリストを取ります .. code:: shell tpaexec upgrade ~/clusters/speedy \ --components=postgres,pgd-proxy,pgdcli,pgbouncer,pg-backup-api,barman クラスター内の該当するすべてのコンポーネントを更新する必要がある場合は、\ ``all`` をフラグに渡すことができます .. code:: shell tpaexec upgrade --components=all .. csv-table:: :header: component,value,architecture :widths: 15,12,20 :align: left :class: longtable Barman,barman,all PEM,"pem-server,pem-agent",all PgBackupAPI,pg-backup-api,all PgBouncer,pgbouncer,all EFM,efm,M1 with `failover_manager=efm` etcd,etcd,M1 with `failover_manager=patroni` Patroni,patroni,M1 with `failover_manager=patroni` RepMgr,repmgr,M1 with `failover_manager=repmgr` PGD Cli,pgdcli,"BDR-Always-ON, PGD-Always-ON" PGD-Proxy,pgd-proxy,PGD-Always-ON "Postgres,EPAS,PGE",postgres,All All,all,All パッケージバージョンの選択 -------------------------- デフォルトでは、クラスターを作成したときにパッケージバージョンPostgres、PGD、またはpglogicalなどを明示的に指定しなかった場合、\ ``tpaexec upgrade`` はインストールされたパッケージの最新の利用可能なバージョンに更新します。 .. Note Minor upgrade is not strictly enforced:: アップグレード時に目的のパッケージバージョンが提供されない場合、TPAは使用可能な最新のパッケージをインストールします。マイナーバージョンの制限は、tpaexecのアップグレード中に厳密に適用されません。これにより、コンポーネントのサポートされていないメジャーアップグレードを不本意に試行する可能性があります。したがって、アップグレードのバージョンを明示的に選択して、既存のクラスターでの互換性を保証することをお勧めします。メジャーバージョンは完全に別のパッケージであり、これが発生しないようにするため、Postgresはこの問題を提起しません。 .. :: `--xxx-package-version` オプションpostgres、bdr、pglogicalなどを :ref:`クラスター構成 <クラスター構成>` に使用するか、config.ymlで`xxx_package_version` 変数を定義することにより、特定のバージョンを選択した場合、インストールされたパッケージが既に満足しているため、アップグレードは何も行いません要求されたバージョン。 この場合、config.ymlを編集し、バージョン設定を更新し、\ ``tpaexec provision`` を再実行する必要があります。更新により、選択したバージョンのパッケージがインストールされます。以下に示すように、コマンドラインでバージョンを指定することにより、特定のバージョンに更新することもできます。 .. code:: shell tpaexec upgrade ~/clusters/speedy -vv \ --components=postgres,pgbouncer \ -e postgres_package_version="16.10*" \ -e pgbouncer_package_version="1.24*" \ -e bdr_package_version="5.9.0*" ここでのバージョン構文は、OSディストリビューションとパッケージマネージャーによって異なることに注意してください。特に、yumは\ ``*xyz*`` ワイルドカードを受け入れますが、aptは\ ``xyz*`` のみを理解します上記の例のように。 .. Note : see limitations of using wildcards in package_version in:: :ref:`ワイルドカードの使用に関する既知の問題 <ワイルドカードの使用に関する既知の問題>` 。 .. :: 要求したPostgres、PGD、およびpglogicalパッケージバージョンの組み合わせが賢明であることを確認するのはあなたの責任です。つまり、これらは連携して動作し、インストールしたものから新しいバージョンへのアップグレードパスが存在する必要があります。 PGDクラスターの場合、パッケージマネージャーの依存関係の解決に依存して正しい依存関係を選択するのではなく、3つのコンポーネントすべてPostgres、PGD、pglogical の正確なバージョンを明示的に指定することをお勧めします。 運用環境で実行する前に、QA環境でアップグレードをテストすることを強くお勧めします。 構成 ---- 特定の場合、マイナーバージョンのアップグレードではconfig.ymlを変更する必要はありません。 ``config.yml`` で\ ``postgres_package_version`` が定義されていない場合、 ``tpaexec upgrade`` が実行されると、Postgresを使用可能な最新のマイナーバージョンに正常にアップグレードします。それが正確に何を意味するかは、クラスターの詳細によって異なります。 他のコンポーネントのマイナーバージョンのアップグレードを制御するには、 ``tpaexec upgrade`` を実行する前に\ ``config.yml`` で特定の\ ``xxx_package_version`` が指定されていることを確認し、 ``--components=x,y,z`` フラグまたは\ ``--components=all`` を使用して特定のコンポーネントをアップグレードするように明示的にオプトインすることをお勧めします。クラスター）。 ``config.yml`` で\ ``xxx_package_version`` を固定せずに\ ``tpaexec upgrade`` を実行し、一部またはすべてのコンポーネントをアップグレードすることをオプトインすると、インストールされたコンポーネントパッケージのメジャーバージョンのアップグレードが発生する可能性があります。互換性が損なわれる可能性があるため、TPAはサポートしていません。 場合によっては、アップグレードには、新しいパッケージのインストールとサービスの再起動を超える追加の手順が含まれる場合があります。たとえば、 BDR4からPGD5にアップグレードするには、新しいパッケージリポジトリをセットアップし、プロセス中にBDRノードとグループ構成に特定の変更を加える必要があります。 このような場合、ソフトウェアのアップグレードを有効にするプロセスの一部として必要な複雑な手順がある場合、 ``tpaexec upgrade`` はこれらの手順を実行します。たとえば、上記のシナリオでは、新しいPGD5パッケージリポジトリを構成します通常、これはdeployでも行います。 ただし、アップグレードプロセス自分自身に直接必要な変更のみを行います。たとえば、config.ymlを編集して新しいPostgresユーザーまたはデータベースを追加する場合、これらの変更はアップグレード中に行われません。混乱を避けるために、ソフトウェアのアップグレードプロセスを開始する前に、無関係の保留中の変更を\ ``tpaexec deploy`` することをお勧めします。 BDR-Always-ONからPGD-Always-ONへのアップグレード ------------------------------------------------ BDR-Always-ONからPGD-Always-ONつまりBDR3/4からPGD5にアップグレードするには、最初に\ ``tpaexec reconfigure`` を実行します。 .. code:: shell tpaexec reconfigure ~/clusters/speedy\ --architecture PGD-Always-ON\ --pgd-proxy-routing local このコマンドは、config.ymlを読み取り、クラスターをアップグレードするために必要な変更を行い、新しいconfig.ymlを書き込みます。呼び出しの詳細については、 :ref:`tpaexec reconfigure ` を参照してください。変更を確認した後、\ ``tpaexec upgrade`` を実行してアップグレードを実行します。 .. code:: shell tpaexec upgrade ~/clusters/speedy\ または、プロキシモニタリングを有効にしてアップグレードを実行するには、 .. code:: shell tpaexec upgrade ~/clusters/speedy\ -e enable_proxy_monitoring=true ``tpaexec upgrade`` は\ ``tpaexec provision`` を自動的に実行して、Ansibleインベントリーを更新します。アップグレードプロセスでは、次のことを行います。 1. クラスターをアップグレードするためのすべての前提条件が満たされていることを確認します。 2. クラスター内のインスタンスごとに、正しいリポジトリーが構成されていること、および必要なpostgresパッケージがそれらの中で利用可能なことを確認します。 3. クラスター内のBDRノードごとに、一度に1つずつ - harp-プロキシがそれに接続を送信しないことを保証にノードをフェンスします。 - BDR4をPGD5に置き換えるなど、postgresを停止、更新、および再起動します。 - ノードのフェンスを解除して、接続を再度受信できるようにします。 - このノードに適用されるpgbouncerおよびpgd-cliを更新します。 4. クラスター内のインスタンスごとに、 BDR v5専用のBDR構成を更新します 5. クラスター内のプロキシノードごとに、一度に1つずつ - pgd-proxy. - をセットアップします harp-proxy. - を停止します pgd-proxyを起動します。 6. harp-proxyとそのサポートファイルを削除します。 PGD-Always-ONからPGD-Xへのアップグレード ---------------------------------------- ``PGD-Always-ON`` クラスターの\ ``PGD-X`` へのアップグレードは、 **重要なアーキテクチャの進化** であり、単純な **ソフトウェアの更新** を超えた変更を含みます。これは *注意深く調整されたマルチステージプロセス* であり、最終的なソフトウェアアップグレードを実行する前に、個別のフェーズでクラスターを再構成する必要があります。このプロシージャーは、最初に\ ``pgd-proxy`` をビルトイン\ ``Connection Manager`` に置き換えることにより、\ ``PGD 5`` クラスターの接続処理を最新化します。このステップは、現在ライブクラスターでの手動操作を必要としますが、将来のTPAリリースで自動化が計画されています。次に、クラスターを新しい\ ``PGD-X`` に移行します。アーキテクチャ。 アップグレードプロセスは、クラスターを3つの異なる状態を介して移行します。 1. **開始** ``PGD`` 5.9+ (``PGD-Always-ON`` ) ``PGD-Proxy`` を使用 2. **中級** ``PGD`` 5.9+ (``PGD-Always-ON`` )ビルトイン\ ``Connection Manager`` を使用するようになりました 3. **最終** ``PGD`` 6 (``PGD-X Architecture`` ) 前提条件 ^^^^^^^^ 開始する前に、次の要件を満たしていることを確認してください。 - **クラスターバージョン** クラスターは\ ``PGD`` バージョン5.9以降を実行している必要があります。以前の5.xバージョンを使用している場合は、\ ``tpaexec upgrade`` を使用して最初に最新のマイナーバージョンにアップグレードします。 PGD-Always-ONクラスターのマイナーバージョンのアップグレードの詳細については、セクション#pgd-always-onを参照してください。 - **バックアップ** クラスターの現在のテストされたバックアップがあります。 - **オーバーライドの確認** インスタンスレベルのプロキシオーバーライドたとえば ``pgd_proxy_options`` などについて\ ``config.yml`` を確認しました。これらは自動的に移行できないため、手動での介入が必要です。 - **共同ホストプロキシ** ``PGD 5`` クラスターは、共同ホストプロキシを使用して構成する必要がありますここで ``pgd-proxy`` ロールは\ ``bdr`` ロールと同じインスタンスにあります。スタンドアロンプロキシインスタンスが存在すると、\ ``switch2cm`` コマンドが中止されます。移行を続行する前に、クラスターからスタンドアロンプロキシインスタンスを削除する必要があります。 ステージ1ビルトイン接続マネージャーへの移行 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 最初のステージは、 ``PGD 5.9+`` クラスターを再構成して、外部\ ``pgd-proxy`` の使用から最新のビルトイン\ ``Connection Manager`` に切り替えることです。 TPAは、 ``tpaexec switch2cm`` コマンドを提供して、最小限のダウンタイムでこの移行を自動化します。 .. Note Transitional State Only:: このプロセスは、 `PGD 6` にアップグレードする前の中間ステップとしてのみを目的とした過渡的な`PGD 5.9+` クラスター状態を作成します。 TPAは現在、`Connection Manager` を有効にして`PGD5.9+` に滞在すること、またはこの構成で`PGD5.9+` の新しいマイナーバージョンへの移動をサポートしていません。将来のTPAリリースは、 `Connection Manager` による`PGD 5` のライフサイクル管理を完全にサポートします。 .. :: #### ステップ1.1接続マネージャー用に再構成する 次のコマンドを実行して、\ ``config.yml`` ファイルを更新します。これにより、ビルトイン\ ``Connection Manager`` を有効にするために必要な設定が追加されます。 **このアクションは構成ファイルのみを変更します。データベースクラスターの実行状態はまだ変更されません。** 新しいバージョンを書き込む前に、\ ``reconfigure`` は、現在のファイルたとえば ``config.yml.~1~`` のバックアップを自動的に保存し、安全な復元ポイントを提供します。 呼び出しの詳細については、 :ref:`tpaexec reconfigure ` を参照してください。 .. code:: shell tpaexec reconfigure ~/clusters/speedy --enable-connection-manager ステップ1.2接続マネージャーに切り替える ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ``tpaexec switch2cm`` コマンドを実行して、\ ``pgd-proxy`` からビルトイン\ ``Connection Manager`` への移行を実行します。このコマンドは、 ``tpaexec provision`` を自動的に実行してAnsibleインベントリーを更新し、最小限のダウンタイムですべてのノードをスイッチします。 .. code:: shell tpaexec switch2cm ~/clusters/speedy ``switch2cm`` コマンドは、次の操作を実行します。 1. 接続マネージャー設定でAnsibleインベントリーを更新します 2. 各ノードごと - ノードをフェンスして新しい接続を防止します - PostgreSQLを再起動して接続マネージャー構成をロードします - ``pgd-proxy`` サービスを停止します - PostgreSQLを再度起動して接続マネージャーがポートをバインドできるようにしますb_tran_7 接続マネージャーがリッスンを開始するのを待機します - ノードのフェンスを解除し、接続を確認します このプロセスは、公式 :ref:`EDB Connection Manager Migrationprocedure ` に従います。 ステージ1完了 ^^^^^^^^^^^^^ このステージの最後に、ビルトイン\ ``Connection Manager`` で実行される\ ``PGD`` クラスターが作成されます。これは中間状態であり、ステージ2に直接進む必要があります。マイナーバージョンアップグレードの\ ``tpaexec upgrade`` は、この中間状態では **サポートされていません** が、 PGD 6へのアップグレードが完了するまで\ ``tpaexec deploy`` を実行することをお勧めします。 ステージ2アーキテクチャのPGD-Xへのアップグレード ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ クラスターが\ ``Connection Manager`` で実行されたら、最後の構成手順に進んで、\ ``PGD 6`` アップグレードの準備をできます。 .. Note:: `Stage 1` が正常に完了し、ビルトイン`Connection Manager` で実行されているクラスターからこのプロセスを開始する必要があります。 .. :: #### ステップ2.1 PGD-Xアーキテクチャ用に再構成する 次のコマンドを実行して、新しいアーキテクチャに合わせて\ ``config.yml`` を更新します。これにより、クラスターアーキテクチャタイプが変更され、\ ``BDR`` バージョンが6に設定され、古い古い設定が削除されます。 **このアクションは構成ファイルのみを変更します。データベースクラスターの実行状態はまだ変更されません。** .. code:: shell tpaexec reconfigure ~/clusters/speedy --architecture PGD-X ステップ2.2ソフトウェアのアップグレードを実行する ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ``config.yml`` の最終的な変更を確認した後、標準の\ ``tpaexec upgrade`` コマンドを実行できます。これにより、すべてのノードでソフトウェアのアップグレードが実行され、クラスターが\ ``PGD 6`` になります。 .. code:: shell tpaexec upgrade ~/clusters/speedy または、プロキシモニタリングを有効にしてアップグレードを実行するには、 .. code:: shell tpaexec upgrade ~/clusters/speedy\ -e enable_proxy_monitoring=true ``tpaexec upgrade`` は\ ``tpaexec provision`` を自動的に実行して、Ansibleインベントリーを更新します。アップグレードプロセスでは、次のことを行います。 1. クラスターをアップグレードするためのすべての前提条件が満たされていることを確認します。 2. クラスター内のインスタンスごとに、正しいリポジトリーが構成されていること、および必要なpostgresパッケージがそれらの中で利用可能なことを確認します。 3. クラスター内のBDRノードごとに、一度に1つずつ - ノードをフェンスオフして、接続がないようにします。 - PGD5をPGD6に置き換えるなど、postgresを停止、更新、および再起動します。 - ノードのフェンスを解除して、 - このノードに適用されるpgbouncerおよびpgd-cliを更新します。 4. BDR v6専用のBDR構成を適用します アップグレードの完了 ^^^^^^^^^^^^^^^^^^^^ クラスターは\ ``PGD-X`` アーキテクチャで\ ``PGD 6`` を実行し、通常のように\ ``tpaexec deploy`` と\ ``tpaexec upgrade`` の両方で完全に管理可能です。 PGD-SまたはPGD-X ---------------- 既存のPGD6 PGD-SまたはPGD-Xクラスターを最新の利用可能なソフトウェアバージョンにアップグレードする場合、アップグレードプロセスは次を実行します。 1. クラスターが正常であること、およびノードが構成済みのポートでリッスンしていることを確認します。 2. アップグレードするノードにローカルリポジトリを含むリポジトリが構成および更新されていることを確認します。 3. 更新されたパッケージをインストールできることの確認 4. クラスター内の各BDRノードを一度に1つずつアップグレードします。 **重要:** 高可用性を保証するために、書き込みリーダーがアップグレードされるノードの中にある場合、アップグレードされる最後のノードになります。 - 接続を受け入れないようにノードをフェンスします - postgres - postgresと更新PGDパッケージ - ノードのフェンスを解除して、接続を再度受信できるようにします - BDRクラスターが再確立されたことを確認します Raftコンセンサス使用b_tran_6 アップグレードされたノードが構成済みのポートでリッスンしていることを確認します 5. クラスターヘルスチェックを再実行します 6. アップグレードされたパッケージに関する情報を出力します PGD-Always-ON ------------- 既存のPGD-Always-ON PGD5クラスターを最新の利用可能なソフトウェアバージョンにアップグレードする場合、アップグレードプロセスは次を実行します。 1. クラスターをアップグレードするためのすべての前提条件が満たされていることを確認します。共有PEMまたは共有Barmanクラスターではないことを含みます。 2. クラスターに適用されるすべてのコンポーネントのアップグレード前ヘルスチェックを実行します。進行中のBarmanバックアップがないことを含む、これによりWALレシーバーが停止します 3. クラスター内のインスタンスごとに、正しいリポジトリーが構成されていること、および必要なpostgresパッケージがそれらの中で利用可能なことを確認します。 4. 選択したすべてのコンポーネントを目的のバージョンに更新できることを確認しますパッケージバージョンが提供されている場合 5. クラスター内のBDRノードごとに、一度に1つずつ - pgd-proxyが接続を送信しないようにノードをフェンスオフします。 - postgresを停止、更新、および再起動します。 - ノードのフェンスを解除しますので、 - pgd-proxyおよびpgd-cliソフトウェアの更新明示的にオプトインした場合 6. クラスター内の該当ノードの場合、pgbouncer、barman、pg-backup-api、およびPEMエージェント/PEMサーバーノードのロールに従ってを更新します。 7. 必要に応じてBarman WALレシーバーを起動し、すべてのコンポーネントのアップグレード後のヘルスチェックを実行しますクラスターに適用される場合 BDR-Always-ON ------------- BDR-Always-ONクラスターの場合、アップグレードプロセスはクラスターインスタンスを1つずつ実行し、次のことを実行します。 1. クラスターをアップグレードするためのすべての前提条件が満たされていることを確認します。共有PEMまたは共有Barmanクラスターではないことを含みます。 2. クラスターに適用されるすべてのコンポーネントのアップグレード前ヘルスチェックを実行します。進行中のBarmanバックアップがないことを含む、これによりWALレシーバーが停止します 3. クラスター内のインスタンスごとに、正しいリポジトリーが構成されていること、および必要なpostgresパッケージがそれらの中で利用可能なことを確認します。 4. サーバーがメンテナンス中であることをhaproxyに伝えます。 5. インスタンスがアクティブサーバーの場合、pgbouncerに再接続し、アクティブなセッションが閉じられるまで待機するように要求します。 6. Postgresを停止し、 Postgres、etcd、およびpgdcli該当する場合およびオプトインしている場合パッケージを更新し、Postgresを再起動します。 7. 最後に、haプロキシを介して要求を受信するためにサーバーを再度「準備ができている」としてマークします。 8. クラスター内の該当ノードの場合、pgbouncer、barman、pg-backup-api、およびPEMエージェント/PEMサーバーノードのロールに従ってを更新します。 9. 必要に応じてBarman WALレシーバーを起動し、すべてのコンポーネントのアップグレード後のヘルスチェックを実行しますクラスターに適用される場合 PGD論理スタンバイまたは物理レプリカインスタンスは、haproxyまたはpgbouncerの相互作用なしで更新されます。クラスター内の非Postgresインスタンスは放置されます。 M1 -- M1クラスターの場合、\ ``upgrade`` は最初にストリーミングレプリカと監視ノードを更新し、次に :ref:`tpaexec switchover ` プライマリからアップグレードされたレプリカのいずれかに移行し、プライマリを更新し、最初のプライマリノードにスイッチオーバーします。 1. クラスターをアップグレードするためのすべての前提条件が満たされていることを確認します。共有PEMまたは共有Barmanクラスターではないことを含みます。 2. クラスターに適用されるすべてのコンポーネントのアップグレード前ヘルスチェックを実行します。進行中のBarmanバックアップがないことを含む、これによりWALレシーバーが停止します 3. クラスター内のインスタンスごとに、正しいリポジトリーが構成されていること、および必要なpostgresパッケージがそれらの中で利用可能なことを確認します。 4. ストリーミングレプリカと監視のPostgresを更新します。ノード該当する場合 5. プライマリからアップグレードされたレプリカのいずれかに :ref:`tpaexec switchover ` を実行します 6. プライマリでPostgresの更新 7. 最初のプライマリノードにスイッチオーバーします。 8. クラスター内の該当ノードの場合、pgbouncer、barman、pg-backup-api、およびPEMエージェント/PEMサーバーノードのロールに従ってを更新します。 9. 必要に応じてBarman WALレシーバーを起動し、すべてのコンポーネントのアップグレード後のヘルスチェックを実行しますクラスターに適用される場合 アップグレードプロセスの制御 ---------------------------- ``update_hosts`` 変数を定義することにより、クラスターのインスタンスがアップグレードされる順序を制御できます。 .. code:: shell tpaexec upgrade ~/clusters/speedy \ -e update_hosts=quirk,keeper,quaver これは、シャドウサーバーが最初にアップグレードされるように、アクティブなPGDプライマリインスタンスを最後にリストすることにより、アップグレード中のリード/シャドウのスイッチオーバーを最小限に抑えるのに役立つ場合があります。 環境で追加のアクションが必要な場合、 :ref:`TPA hooks ` パッケージのインストール手順の前後にカスタムAnsibleタスクを実行できます。 ノードのサブセットのアップグレード ---------------------------------- ``update_hosts`` 変数を設定することにより、インスタンスのサブセットでローリングアップグレードを実行できます。ただし、この機能のサポートはアーキテクチャによって異なります。 - **M1** アーキテクチャの場合、この機能は\ ``repmgr`` および\ ``Patroni`` 管理対象クラスターで完全にサポートされています。 ``EFM`` 管理対象クラスターは、EFMを除くすべてのコンポーネントの\ ``update_hosts`` リストを尊重します。 EFMはデータノード全体で異なるバージョンを実行しているクラスターをサポートしていないため、\ ``update_hosts`` で指定されたノードに関係なく、すべてのデータノードはEFMバージョンをアップグレードします。 - **PGD-Always-ON/ BDR-Always-ON** の場合、これはマイナーバージョンのアップグレード中に **のみ** サポートされています。 PGD-Always-ON/ BDR-Always-ONのベストプラクティス ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ PGDノードのサブセットでマイナーアップグレードを実行する場合、\**RAFTリーダーノードを最後に更新することを強くお勧めします。この戦略により、クラスターがBDRの混合バージョンを実行している間のアップグレード後チェックに関する潜在的な問題を回避します。