インストールとアップグレード

Kubernetesへのインストール

オペレーターマニフェストを直接使用する

オペレーターは、Kubernetesの他のリソースと同様に、kubectl を介して適用されるYAMLマニフェストを介してインストールできます。

latest operator manifest をインストールできます

このマイナーリリースでは次のようになります。

kubectl apply --server-side -f \
  https://raw.githubusercontent.com/cloudnative-pg/cloudnative-pg/release-1.24/releases/cnpg-1.24.1.yaml

これは次の方法で確認できます。

kubectl get deployment -n cnpg-system cnpg-controller-manager

`kubectl` の`cnpg` プラグインを使用する

cnpg プラグインを使用して、静的マニフェストにあるデフォルトの構成オプションをオーバーライドできます。

たとえば、デフォルトの最新のマニフェストを生成しますが、ウォッチ名前空間を特定の名前空間のみに変更するには、次のコマンドを実行できます。

kubectl cnpg install generate \
  --watch-namespace "specific-namespace" \
  > cnpg_for_specific_namespace.yaml

より包括的な例については、 Backup {postgresql-cnpg-io-v1-Backup} ドキュメントを参照してください。

警告

GKEにCloudNativePGをデプロイしており、エラー`... failed to call webhook...` を取得した場合は、公式 docs で説明しているように、デフォルトでは、ワーカーノードとコントロールプレーン間のトラフィックは、いくつかの特定のポートを除きてファイアウォールによってブロックされていることに注意してください

そしてこれによって issue 。 WebhookサービスのtargetPort を許可されるもののいずれかに変更するか、ファイアウォールでWebhookのポート9443 を開く必要があります。

Helmチャートを使用する

オペレーターは、提供されている Helm chart を使用してインストールできます。

OLMを使用する

CloudNativePGは、 Operator Lifecycle Manager (OLM) からインストールすることもできます

OperatorHub.io から直接。

Red Hat OpenShiftでの展開の場合、EDBは、: Red Hat OpenShift Container Platform から入手可能なCloudNativePGの認定バージョンを提供および完全にサポートしています。

デプロイメントの詳細

Kubernetesでは、オペレーターはデフォルトでKubernetes Deployment としてcnpg-system 名前空間にインストールされます。この展開の名前は、インストール方法によって異なります。マニフェストまたはcnpg プラグインを介してインストールされる場合、デフォルトでcnpg-controller-manager と呼ばれます。 Helmを介してインストールされた場合、デフォルト名はcnpg-cloudnative-pg です。

注釈

Helmを使用すると、 *"values.yaml"* file の`fullnameOverride` フィールドを介してデプロイメントの名前をカスタマイズできます。

kubectl のdescribe コマンドを使用して、詳細情報を取得できます。

$ kubectl get deployments -n cnpg-system
NAME                READY   UP-TO-DATE   AVAILABLE   AGE
<deployment-name>   1/1     1            1           18m

kubectl describe deploy \
  -n cnpg-system \
  <deployment-name>

他の展開と同様に、レプリカセットの上にあり、ローリングアップグレードをサポートします。 CloudNativePGオペレーターのデフォルト構成には、単一のレプリカの展開が付属しており、ほとんどのインストールに適しています。ポッドが実行されているノードに到達できなくなった場合、ポッドは別のノードで再スケジュールされます。

オペレーターレベルでの高可用性が必要な場合、オペレーターがリーダー選択をサポートしていることを考慮すると、展開構成で複数のレプリカを指定できます。また、テイントと寛容を利用して、実際のPostgreSQLクラスターが実行されているノードでオペレーターが実行されないことを確認できます。これには、自己管理のKubernetesインストールのコントロールプレーンが含まれる場合があります。

参考

いくつかのデフォルトオプションをオーバーライドすることにより、オペレーターのデフォルト動作を変更できます。詳細については、オペレーター設定セクションを参照してください。

アップグレード

重要

1.14.0以前のリリースノートをよくお読みください

一部のバージョンは追加の手順を必要とする場合があるため、アップグレードを実行する前に。

CloudNativePGオペレーターのアップグレードは、2段階のプロセスです。

コントローラと関連するKubernetesリソースをアップグレードする
すべてのPostgreSQLポッドで実行されているインスタンスマネージャーをアップグレードする

リリースノートに別の記載がない限り、最初のステップは、通常、プレーンなKubernetesインストールの新しいバージョンのマニフェストを適用するか、使用するディストリビューションのネイティブパッケージマネージャーを使用して実行されます上記のセクションの指示に従ってください。

2番目のステップは、コントローラの更新後に自動的にトリガーされます。デフォルトでは、これにより、展開されたすべてのPostgreSQLクラスターのローリング更新が開始され、新しいインスタンスマネージャーを使用するように一度に1つのインスタンスをアップグレードします。ローリング更新は、 primaryUpdateStrategy オプションによって制御されるスイッチオーバーで終了します。デフォルト値unsupervised は、スイッチオーバーを自動的に完了します。 supervised に設定している場合、ユーザーはkubectl のcnpg プラグインを使用して、新しいプライマリインスタンスを手動でプロモートする必要があります。

参考

このプロセスは、ローリングアップデートページで詳細に説明されています。

重要

primaryUpdateStrategy が`unsupervised` のデフォルト値に設定されている場合、オペレーターのアップグレードはPostgreSQLクラスターでスイッチオーバーをトリガーし、通常は無視できるダウンタイムを発生します。

デフォルトのローリング更新動作は、インスタンスマネージャーのインプレース更新に置き換えることができます。このアプローチでは、 PostgreSQLインスタンスの再起動が必要ないため、クラスター内のスイッチオーバーを回避します。この機能はデフォルトで無効になっていますが、以下で詳細に説明します。

スプレッドアップグレード

デフォルトでは、すべてのPostgreSQLクラスターは同時にロールアウトされるため、特に複数のクラスターを管理する場合、リソース使用量の急増につながる可能性があります。 CloudNativePGは、 operator level で2つの構成オプションを提供します

これにより、クラスターのロールアウト間、または同じクラスター内のインスタンス間で遅延を導入でき、時間の経過とともにリソース使用量を分散するのに役立ちます。

CLUSTERS_ROLLOUT_DELAY さまざまなPostgreSQLクラスターデフォルト0 のロールアウトの間で待機する秒数を定義します。
INSTANCES_ROLLOUT_DELAY 同じPostgreSQLクラスター内の個々のインスタンスのロールアウトの間で待機する秒数を定義しますデフォルト0 。

インスタンスマネージャーのインプレース更新

デフォルトでは、CloudNativePGは、オペレーターが更新されるたびに、クラスターのローリング更新を発行します。オペレーターに同梱される新しいインスタンスマネージャーは、initコンテナを介して各PostgreSQLポッドに追加されます。

ただし、この動作は構成を介して変更でき、インスタンスマネージャーのインプレース更新を有効にできます。これは、コンテナを生きたままにするPID 1プロセスです。

内部的には、CloudNativePGの各インスタンスマネージャーは、完全性検証フェーズが正常に完了し、すべての内部プロセスを正常に終了した後、既存の実行可能ファイルを置き換える新しい実行可能ファイルのインジェクションをサポートします。新しいバイナリで再起動すると、インスタンスマネージャーは既に実行されている postmaster をシームレスに採用します。

その結果、PostgreSQLプロセスは更新の影響を受けず、スイッチオーバーを実行する必要はありません。コインの反対側は、Podがスタート後に変更され、不変性の純粋な概念を壊すということです。

オペレーター設定でENABLE_INSTANCE_MANAGER_INPLACE_UPDATES 環境変数を'true' に設定することにより、この機能を有効にできます。

インプレースアップグレードプロセスでは、ポッド内のinitコンテナイメージは変更されません。したがって、ポッド定義はオペレーターの現在のバージョンを反映しません。

バージョン間の互換性

CloudNativePGはセマンティックバージョニングに従います。同じAPIバージョン内のオペレーターのすべてのリリースは、以前のAPIバージョンと互換性があります。現在のAPIバージョンはv1で、オペレーターのバージョン1.x.yに対応します。

新機能に加えて、オペレーターの新しいバージョンにはバグ修正と安定性の強化が含まれています。このため、各バージョンは、最も安全で安定したPostgres環境を維持するためにリリースされるため、**オペレーターの最新バージョンにアップグレードすることを強くお勧めします。

CloudNativePGは現在、少なくとも毎月オペレーターの新しいバージョンをリリースしています。各バージョンが利用可能になったときに更新を適用できない場合は、バージョンをスキップせずに、各バージョンを順番にアップグレードして、定期的に最新の状態になることをお勧めします。

1.14.0以前のリリースノートページには、CloudNativePGのすべてのリリースバージョンで導入された変更の詳細なリストが含まれており、ソフトウェアの新しいバージョンにアップグレードする前に読む必要があります。

ほとんどのバージョンは直接アップグレード可能であり、その場合、プレーンなKubernetesインストールに新しいマニフェストを適用するか、選択したディストリビューションのネイティブパッケージマネージャーを使用するだけで十分です。

バージョンを直接アップグレードできない場合、新しいバージョンをインストールする前に古いバージョンを削除する必要があります。これはユーザーデータに影響を与えるのではなく、オペレーター自分自身にのみ影響を与えます。

<!–

1.25.0または1.24.xへのアップグレード

重要

CloudNativePGの既存のすべてのユーザーは、バージョン1.25.0または少なくとも現在使用しているマイナーリリースの最新の安定バージョン1.24.xにアップグレードすることをお勧めします。 -->

以前のマイナーバージョンから1.24へのアップグレード

警告

上位のマイナーリリースにアップグレードするたびに、すべての中間マイナーリリースのリリースノートとアップグレード手順を確認してください。たとえば、1.22.xから1.24に移行する場合は、1.23および1.24のリリースノートとアップグレード手順を必ず読んでください。

レプリカクラスターから分散トポロジへ

CloudNativePG 1.24.0の重要な機能強化の1つは、レプリカクラスター機能のアップグレードです。

以前のレプリカクラスター機能は、現在「スタンドアロンレプリカクラスター」と呼ばれていますが、複数のKubernetesクラスターにまたがるディザスターリカバリーDRおよび高可用性HAシナリオでは推奨されなくなりました。スタンドアロンレプリカクラスターは、レポート、OLAP、テストデータを使用した開発環境の作成などの読み取り専用ワークロードに最適です。

DRとHAの目的で、CloudNativePGはレプリカクラスターの分散トポロジー戦略を導入するようになりました。この新しい戦略では、プライベート、パブリック、ハイブリッド、およびマルチクラウド環境、複数のリージョン、および異なるクラウドプロバイダーにまたがるPostgreSQLクラスターを構築できます。また、スイッチオーバー操作を制御するAPIも提供し、任意の時点で1つのクラスターのみがプライマリとして機能します。

この分散トポロジ戦略は、復元力とスケーラビリティを強化し、多様なインフラストラクチャ設定にわたって高可用性とディザスターリカバリー機能を必要とする最新の分散アプリケーションのための堅牢なソリューションになります。

分散PostgreSQLセットアップに関係するすべてのCluster リソースを変更することにより、以前のレプリカクラスター構成から分散トポロジにシームレスに移行できます。次の手順が実行されていることを確認します。

externalClusters セクションを構成して、分散トポロジに関係するすべてのクラスターを含めます。保守性と一貫性を維持するために、すべてのCluster リソースで同じ構成を使用することを強くお勧めします。
分散トポロジを反映するように.spec.replica スタンザのprimary およびsource フィールドを構成します。 primary フィールドには、分散トポロジの現在のプライマリクラスターの名前が含まれている必要がありますが、 source フィールドには、各Cluster リソースの複製元のクラスターの名前が含まれている必要があります。 enabled フィールドは、以前にtrue またはfalse に設定されていましたが、設定を解除するデフォルトにする必要があることに注意してください。

詳細については、レプリカクラスターから分散トポロジへを参照してください。

以前のマイナーバージョンから1.23へのアップグレード

ユーザー定義のレプリケーションスロット

CloudNativePGは、プライマリで定義されたすべてのレプリケーションスロットの自動同期を提供するようになりました。高可用性HAクラスター内のスタンバイ。

スタンバイでレプリケーションスロットを手動で管理する場合、これらのレプリケーションスロットを同期から除外することが重要です。これを行わないと、CloudNativePGがスタンバイから削除する場合があります。この除外を実装するには、次のYAML構成を利用します。この例では、 ’foo’で始まる名前のレプリケーションスロットは同期されません。

...
  replicationSlots:
    synchronizeReplicas:
      enabled: true
      excludePatterns:
      - "^foo"

または、同期メカニズムを完全に無効にする場合は、次の構成を使用します。

...
  replicationSlots:
    synchronizeReplicas:
      enabled: false

サーバーサイドでのマニフェストの適用

Kubernetes 1.29および次のバージョンとの互換性を保証するために、CloudNativePGは Server-side apply の使用を義務付けました

オペレーターマニフェストを展開するとき。

このインストール方法を採用することは、新しい展開に問題はありませんが、 --server-side オプションを使用して既存のオペレーターマニフェストを更新すると、以下の例のようなエラーが発生する場合があります。

Apply failed with 1 conflict: conflict with "kubectl-client-side-apply" using..

このようなエラーが発生した場合は、 --force-conflicts オプションを明示的に指定して競合解決を強制することにより解決できます。

kubectl apply --server-side --force-conflicts -f <OPERATOR_MANIFEST>

今後、 kube-apiserver はCRDの認識されたマネージャーとして自動的に認識され、この問題に関するさらなる手動介入の必要性がなくなります。