Upgrading your cluster

Upgrading your cluster#

tpaexec upgrade コマンドは、TPAクラスターで実行されているソフトウェアをアップグレードするために使用されます。 tpaexec deploy はアップグレードを実行しません。

このコマンドは、以前のtpaexec update-postgres コマンドを置き換えます。

注釈

TPAは、共有Barmanおよび/または共有PEM構成を持つクラスターでの`tpaexec upgrade` コマンドの使用をまだサポートしておらず、将来のリリースでこの機能を追加します。

config.ymlに変更を加えた場合、それらの変更を適用する方法は、tpaexec provision に続いてtpaexec deploy を実行することです。

このルールの例外は、 tpaexec deploy が既にインストールされているパッケージの別のバージョンのインストールを拒否することです。代わりに、tpaexec upgrade を使用してソフトウェアアップグレードを実行する必要があります。

次のコンポーネントは、 任意の アーキテクチャでアップグレードできます。

  • Postgres

  • Repmgrリダイレクトpgbouncer

  • barman-pre-config

  • PG Backup API

  • 現在以外の`pem_server_package_version が指定されている場合、Debianのようなインスタンスでのデプロイが失敗する TPA-1178 <現在以外の`pem_server_package_version` が指定されている場合、Debianのようなインスタンスでのデプロイが失敗する TPA-1178>`

サーバーとエージェントの両方

次のコンポーネントは M1 アーキテクチャでアップグレードでき、使用されるフェールオーバーマネージャーに応じて異なります。

次のコンポーネントは、使用するBDRバージョンに応じて、 BDR -Always-ON / PGD-Always-ON アーキテクチャでアップグレードできます。

  • 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データベースに追加のテーブルが作成され、アップグレードの実行中に監視データがそこに書き込まれます。モニタリングを有効にすることによるパフォーマンスへの影響は非常に小さいため、有効にすることをお勧めします。

コンポーネントの選択#

注釈

コンポーネントのアップグレードは厳密にオプトインです

tpaexec upgrade ~/clusters/speedy

更新する特定のコンポーネントを選択するために、--components フラグはコンマ区切りリストを取ります

tpaexec upgrade ~/clusters/speedy \
   --components=postgres,pgd-proxy,pgdcli,pgbouncer,pg-backup-api,barman

クラスター内の該当するすべてのコンポーネントを更新する必要がある場合は、all をフラグに渡すことができます

tpaexec upgrade --components=all

component

value

architecture

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 はインストールされたパッケージの最新の利用可能なバージョンに更新します。

この場合、config.ymlを編集し、バージョン設定を更新し、tpaexec provision を再実行する必要があります。更新により、選択したバージョンのパッケージがインストールされます。以下に示すように、コマンドラインでバージョンを指定することにより、特定のバージョンに更新することもできます。

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* のみを理解します上記の例のように。

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 を実行します。

tpaexec reconfigure ~/clusters/speedy\
  --architecture PGD-Always-ON\
  --pgd-proxy-routing local

このコマンドは、config.ymlを読み取り、クラスターをアップグレードするために必要な変更を行い、新しいconfig.ymlを書き込みます。呼び出しの詳細については、 tpaexec reconfigure を参照してください。変更を確認した後、tpaexec upgrade を実行してアップグレードを実行します。

tpaexec upgrade ~/clusters/speedy\

または、プロキシモニタリングを有効にしてアップグレードを実行するには、

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 コマンドを提供して、最小限のダウンタイムでこの移行を自動化します。

次のコマンドを実行して、config.yml ファイルを更新します。これにより、ビルトインConnection Manager を有効にするために必要な設定が追加されます。

このアクションは構成ファイルのみを変更します。データベースクラスターの実行状態はまだ変更されません。

新しいバージョンを書き込む前に、reconfigure は、現在のファイルたとえば config.yml.~1~ のバックアップを自動的に保存し、安全な復元ポイントを提供します。

呼び出しの詳細については、 tpaexec reconfigure を参照してください。

tpaexec reconfigure ~/clusters/speedy --enable-connection-manager

ステップ1.2接続マネージャーに切り替える#

tpaexec switch2cm コマンドを実行して、pgd-proxy からビルトインConnection Manager への移行を実行します。このコマンドは、 tpaexec provision を自動的に実行してAnsibleインベントリーを更新し、最小限のダウンタイムですべてのノードをスイッチします。

tpaexec switch2cm ~/clusters/speedy

switch2cm コマンドは、次の操作を実行します。

  1. 接続マネージャー設定でAnsibleインベントリーを更新します

  2. 各ノードごと

    • ノードをフェンスして新しい接続を防止します

    • PostgreSQLを再起動して接続マネージャー構成をロードします

    • pgd-proxy サービスを停止します

    • PostgreSQLを再度起動して接続マネージャーがポートをバインドできるようにしますb_tran_7 接続マネージャーがリッスンを開始するのを待機します

    • ノードのフェンスを解除し、接続を確認します

このプロセスは、公式 EDB Connection Manager Migrationprocedure に従います。

ステージ1完了#

このステージの最後に、ビルトインConnection Manager で実行されるPGD クラスターが作成されます。これは中間状態であり、ステージ2に直接進む必要があります。マイナーバージョンアップグレードのtpaexec upgrade は、この中間状態では サポートされていません が、 PGD 6へのアップグレードが完了するまでtpaexec deploy を実行することをお勧めします。

ステージ2アーキテクチャのPGD-Xへのアップグレード#

クラスターがConnection Manager で実行されたら、最後の構成手順に進んで、PGD 6 アップグレードの準備をできます。

注釈

Stage 1 が正常に完了し、ビルトイン`Connection Manager` で実行されているクラスターからこのプロセスを開始する必要があります。

次のコマンドを実行して、新しいアーキテクチャに合わせてconfig.yml を更新します。これにより、クラスターアーキテクチャタイプが変更され、BDR バージョンが6に設定され、古い古い設定が削除されます。

このアクションは構成ファイルのみを変更します。データベースクラスターの実行状態はまだ変更されません。

tpaexec reconfigure ~/clusters/speedy --architecture PGD-X

ステップ2.2ソフトウェアのアップグレードを実行する#

config.yml の最終的な変更を確認した後、標準のtpaexec upgrade コマンドを実行できます。これにより、すべてのノードでソフトウェアのアップグレードが実行され、クラスターがPGD 6 になります。

tpaexec upgrade ~/clusters/speedy

または、プロキシモニタリングを有効にしてアップグレードを実行するには、

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 アップグレードされたノードが構成済みのポートでリッスンしていることを確認します

  1. クラスターヘルスチェックを再実行します

  2. アップグレードされたパッケージに関する情報を出力します

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 は最初にストリーミングレプリカと監視ノードを更新し、次に tpaexec switchover

プライマリからアップグレードされたレプリカのいずれかに移行し、プライマリを更新し、最初のプライマリノードにスイッチオーバーします。

  1. クラスターをアップグレードするためのすべての前提条件が満たされていることを確認します。共有PEMまたは共有Barmanクラスターではないことを含みます。

  2. クラスターに適用されるすべてのコンポーネントのアップグレード前ヘルスチェックを実行します。進行中のBarmanバックアップがないことを含む、これによりWALレシーバーが停止します

  3. クラスター内のインスタンスごとに、正しいリポジトリーが構成されていること、および必要なpostgresパッケージがそれらの中で利用可能なことを確認します。

  4. ストリーミングレプリカと監視のPostgresを更新します。ノード該当する場合

  5. プライマリからアップグレードされたレプリカのいずれかに tpaexec switchover を実行します

  6. プライマリでPostgresの更新

  7. 最初のプライマリノードにスイッチオーバーします。

  8. クラスター内の該当ノードの場合、pgbouncer、barman、pg-backup-api、およびPEMエージェント/PEMサーバーノードのロールに従ってを更新します。

  9. 必要に応じてBarman WALレシーバーを起動し、すべてのコンポーネントのアップグレード後のヘルスチェックを実行しますクラスターに適用される場合

アップグレードプロセスの制御#

update_hosts 変数を定義することにより、クラスターのインスタンスがアップグレードされる順序を制御できます。

tpaexec upgrade ~/clusters/speedy \
  -e update_hosts=quirk,keeper,quaver

これは、シャドウサーバーが最初にアップグレードされるように、アクティブなPGDプライマリインスタンスを最後にリストすることにより、アップグレード中のリード/シャドウのスイッチオーバーを最小限に抑えるのに役立つ場合があります。

環境で追加のアクションが必要な場合、 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の混合バージョンを実行している間のアップグレード後チェックに関する潜在的な問題を回避します。

目次