Release notes for CloudNativePG 1.28 ==================================== CloudNativePG 1.28のリリースノート ================================== CloudNativePGの1.28マイナーリリースのユーザーに表示される変更の履歴。 変更の完全なリストについては、 `commits `_ を参照してください。 GitHubのリリースブランチで。 バージョン1.28.2 ---------------- **発売日** 2026年3月31日 重要な変更 ^^^^^^^^^^ - ネイティブツリー内Barman Cloudサポートの非推奨通知を更新して、1.29.0ではなくCloudNativePG 1.30.0で削除されることを反映しています。ユーザーは引き続きBarman Cloudプラグインに移行することをお勧めします。 ( `#10167 `_ ) 機能強化 ^^^^^^^^ - TLS暗号スイートと最小/最大TLSバージョンの詳細な構成のサポートにより\ ``Pooler`` CRDを改善しました。これにより、管理者は、プーラーからクライアント、およびプーラーからサーバーへの接続に関する厳密なセキュリティコンプライアンス要件を満たすことができます。 @alex1989huによる投稿。 ( `#9571 `_ ) - アップグレードジョブで\ ``BackoffLimit=0`` を設定することにより、メジャーアップグレードの信頼性が向上し、失敗した\ ``pg_upgrade`` の不必要な再試行を防止します。ユーザーがコンテナイメージを元に戻すときに、オペレーターは失敗したジョブを自動的に削除するため、クラスターが元のバージョンで正常に再起動できます。 ( `#10104 `_ 、 `#10298 `_ ) - 各調整サイクルの前にインスタンスがプライマリであることを確認することによりロール管理を向上させ、読み取り専用レプリカでの不要な調整試行と偽のエラーメッセージを回避します。 ( `#9971 `_ ) - 1.29で導入された\ ``extensions`` 、\ ``bin_path`` 、および\ ``env`` フィールドを受け入れるように\ ``Cluster`` 、\ ``ImageCatalog`` 、および\ ``ClusterImageCatalog`` のCRDスキーマを拡張しました。オペレーターは古いバージョンでこれらのフィールドを無視しますが、スキーマでそれらを受け入れることにより、ユーザーは異なるCNPGバージョンを実行しているクラスター間で単一のマニフェストを共有できます。 ( `#10131 `_ 、 `#10387 `_ ) - オペレーターは、クラスターに新しいPVCを追加するときに\ ``primaryUpdateMethod`` を優先するようになりました、ストレージの拡張または追加中にロールアウト戦略たとえば、スイッチオーバー対リスタートが尊重されるようにします。 ( `#9720 `_ ) - ``alpha.cnpg.io/unrecoverable`` アノテーションロジックを洗練して、\ ``Ready`` 状態にまだ到達していないポッドでも機能できるようにし、スタックしたインスタンスのリカバリーを容易にします。 ( `#9968 `_ ) セキュリティとサプライチェーン ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - **セキュリティベストプラクティスの統合** OpenSSFベースラインスキャナーを統合し、\ ``SECURITY-INSIGHTS.yaml`` ファイルをリポジトリに追加して、業界標準のセキュリティレポートと調整します。 ( `#10054 `_ , `#10062 `_ ) - **SLSA来歴とSBOM** リリースバイナリとコンテナイメージにSLSAサプライチェーンレベルソフトウェアアーティファクトの来歴を追加しました。さらに、GoReleaserパイプライン内のソフトウェア部品表SBOM生成を有効にして、依存関係の透明性を向上させました。 ( `#10048 `_ , `#10074 `_ ) - **パスワード漏洩防止** PostgreSQLが特定の調整フェーズ中にログにロールパスワードを漏洩する可能性がある潜在的なセキュリティリスクを修正しました。 ( `#9950 `_ ) 変更 ^^^^ - デフォルトのPostgreSQLバージョンを18.3イメージ ``18.3-system-trixie`` に更新しました。 ( `#10090 `_ ) 修正 ^^^^ - 同期レプリケーションを使用するクラスターに影響を与えるオペレーターのアップグレード中のデッドロックを修正しました。新旧のオペレーターバージョンを実行するポッドが異なるPostgreSQL構成ハッシュを計算し、均一性チェックが無期限にブロックされ、ローリング更新とインプレースアップグレードの両方の進行を防ぎます。 ( `#10342 `_ ) - ディスク領域チェックがインスタンスマネージャーの起動をブロックしたため、WALディスクがいっぱいになったときにフェンシングアノテーションを処理できない問題を修正しました。チェックは、ライフサイクルループの後半で、フェンシングが評価された後、実行されるようになりました。 ( `#10302 `_ ) - 初期ブートストラップに使用される\ ``VolumeSnapshot`` が削除されている場合、レプリカが\ ``Pending`` 状態でスタックしてしまう問題を修正しました。オペレーターは、使用前にスナップショットの存在を検証するようになりました。スナップショットが見つからない場合は、次の利用可能な候補を使用しようとするか、 ``pg_basebackup`` にフォールバックします。 ( `#10192 `_ ) - 「監視対象プライマリ」ロールアウト戦略が、以前にスケジュールされた更新の遅延を引き起こしていた、使用可能なすべてのロールアウトスロットを消費しないようにしました。 @ermakov-olegによる寄稿。 ( `#9977 `_ ) - 特定のホットスタンバイパラメーターの変更がレプリカクラスターに正しく適用されなかった問題を修正しました。 ( `#9952 `_ ) - 「Continue」結果が返されたときに後続のプラグインをスキップする可能性があるCNPG-Iリコンサイラーフックのバグを修正しました。 @sharifmshakerによる寄稿。 ( `#9978 `_ ) - 現在ポッドに接続されていないPVCのファイルシステムのサイズを変更しようとしたときに発生したデッドロックシナリオを修正しました。 @jmealoによる寄稿。 ( `#9981 `_ ) - ``ConnectionParameters`` で構成された外部クラスターを受け入れるようにブートストラップリカバリソースのWebhook検証を修正しました ``pg_basebackup`` ベースのリカバリーの場合。以前は、 BarmanオブジェクトストアまたはCNPG-iプラグインも構成されていない限り、これらは誤って拒否されました。 ( `#10268 `_ ) - 拡張機能とテーブルスペースのボリューム名に接頭辞が付けられ、標準のクラスターボリュームとの名前の衝突を回避します。 ( `#9973 `_ ) - 正常でないクラスターを冬眠させる場合、オペレーターは\ ``WaitingForHealthy`` 条件を報告するようになり、\ ``cnpg status`` を介して遅延されたハイバーネーション状態を可視化します。 ( `#10193 `_ ) - ターゲットポッドが存在しない場合でも、フェンシングが正しく動作するように修正しました。フェンシングはクラスターレベルのアノテーションで動作し、ポッドの存在に依存しないでください。インスタンス名の検証は、 ``cnpg fencing on`` コマンドでのみ実行されます。 ( `#10035 `_ ) - クラスターおよびプーラーサービスリコンサイラーを修正して、パッチ更新戦略を使用するときにすべての仕様フィールドの変更を正しく処理します。リコンサイラーはRFC 7386 JSONマージパッチを使用するようになり、クラウドプロバイダー設定フィールド ``loadBalancerClass`` など 誤って削除されるのを防ぎます。 ( `#10190 `_ 、 `#10311 `_ ) - パラレルWALリストアに影響を与える非推奨のツリー内Barman Cloudバックアップ実装の競合状態を修正しました。ここで、プリフェッチされたファイルはダウンロード中に読み取られる可能性があり、「invalid Checkpoint Record」エラーでPostgreSQLのリカバリーが失敗します。 ( `#10285 `_ ) - タイムライン履歴ファイルの検証を修正して、プラグインベースのWALリストアにも適用されます。以前は、 `#9650 `_ で導入された保護はツリー内リストアのみをカバーしており、プラグインがチェックをバイパスして将来のタイムライン履歴ファイルをダウンロードできるため、レプリカでタイムライン不一致エラーが発生していました。 ( `#9849 `_ ) - ``cnpg`` プラグイン - cnpgプラグインは、ImagePullSecretを\ ``pgbench`` ジョブポッドテンプレートに正しく伝播するようになりました。 ( `#10174 `_ ) バージョン1.28.1 ---------------- **発売日** 2026年2月5日 .. _機能強化-1: 機能強化 ^^^^^^^^ - バックアップおよびリカバリ操作のためのAzureの\ ``DefaultAzureCredential`` 認証メカニズムのサポートを追加しました。これは、バックアップ構成で\ ``azureCredentials.useDefaultAzureCredentials: true`` を設定することにより有効にでき、明示的なストレージアカウントキーまたはSASトークンを必要とせずにAzure環境での認証を簡素化します。 ( `#9468 `_ ) .. _修正-1: 修正 ^^^^ - アンダースコアを含むPostgreSQL拡張機能名の検証を修正しましたたとえば ``pg_partman`` 、\ ``pg_ivm`` 。アンダースコアを含む拡張機能名は、マウントパスに元の名前を保持しながら、Kubernetesボリューム名にハイフンを使用するように自動的にサニタイズされます。 Webhook検証は、サニタイズ後の名前の競合を防ぎます。 @shusaanさんからの投稿。 ( `#9386 `_ ) - メジャーバージョンのアップグレード後に、クラスターステータスの\ ``TimelineID`` が1にリセットされない重要な問題を修正しました。 ``pg_upgrade`` は新しいタイムラインを初期化するため、古いIDたとえばタイムライン2を保持すると、レプリカがオブジェクトストレージから互換性のない履歴ファイルを復元しようとし、致命的な「要求されたタイムラインはこのサーバーの履歴の子ではありません」エラーが発生しました。 ( `#9830 `_ ) - ``Pooler`` の古いTLSステータスフィールドが仕様から削除された後、クリアされなかった問題を修正しました。これは、\ ``ServerTLS`` フィールドが再利用され、PgBouncerが誤った証明書を使用し、すべてのアプリケーションの接続をブロックする「unsupportedcertificate」エラーが発生したv1.28.0にアップグレードする場合に特に重要でした。オペレーターは、構成されなくなった場合に\ ``ServerCA`` 、\ ``ClientCA`` 、\ ``ClientTLS`` 、および\ ``ServerTLS`` ステータスフィールドを明示的にクリアするようになりました。 `#9397 `_ - レプリカが将来のタイムラインからタイムライン履歴ファイルをダウンロードしようとすることにより、クラッシュループに入る可能性があるバグを修正しました。これは、古いファイルが以前のクラスターライフからWALアーカイブに残り、レプリカがリカバリ中に誤ってそれらを取得しようとした場合に発生しました。 ( `#9650 `_ ) - 指定されたプライマリ移行中の\ ``replica_cluster`` セットアップの競合状態を修正し、レプリカクラスターでの一時的な「プライマリなし」状態を防止します。 ( `#9601 `_ ) - バックアップコントローラは、一意のインスタンスセッションIDを使用して、インスタンスマネージャーの再起動を検出するようになりました。これにより、基になるコンテナがクラッシュして再起動した場合、オペレーターがバックアップがまだ進行中であると誤って仮定するのを防ぎます。これにより、以前は孤立したバックアップオブジェクトが発生しました。 ( `#9370 `_ ) - 明示的な資格情報ストレージキーまたはSASトークンなどを使用する場合に\ ``storageAccount`` が必要とされなかったAzureオブジェクトストア構成の検証ギャップを修正しました。オペレーターは、これらの場合にストレージアカウント名が提供され、\ ``connectionString`` が他の認証パラメーターと相互排他的であることを適用するようになりました。 ( `#9604 `_ ) - クラスターが削除対象としてマークされると、オペレーターがすぐにリソースのクリーンアップを開始するように、削除パスを最適化しました。これにより、内部調整ループの待機中にクラスターが\ ``Terminating`` ステータスに留まる時間が大幅に削減されます。 ( `#9555 `_ ) - 機能が無効になっている場合、またはクラスターが再構成されているときに、レプリケーションスロットがレプリカから適切にドロップされない問題を修正しました。これにより、未使用のスロットがプライマリでWALのビルドアップを発生させないようになります。 ( `#9381 `_ ) - ``Pooler`` 用に作成された\ ``ServiceAccount`` に\ ``imagePullSecrets`` が追加されない問題を修正しました。以前は、これらのシークレットは展開には適用されましたが、SAには適用されなかったため、特定のセキュリティポリシーを使用して制限された環境でイメージのプルに失敗しました。 ( `#9427 `_ ) - オペレーターが\ ``PodMonitor`` を削除する前に、所有権を確認するチェックを追加しました。これにより、オペレーターが、予想されるCNPGリソースと名前を共有する手動管理モニタリングリソースを誤って削除するのを防ぎます。 @juliamertzによる寄稿。 ( `#9340 `_ ) - ``pg_stat_archiver`` メトリックが、スイッチオーバー後にスタンバイインスタンスで古いデータを報告し続けるバグを修正しました。 PostgreSQLはプライマリで有効なアーカイバー統計のみを提供するため、エクスポーターはスタンバイでこれらのメトリックをスキップするようになりました。 ( `#9411 `_ ) - リカバリー\ ``targetTime`` のタイムスタンプ形式の解釈を明確にしました。明示的なタイムゾーンなしで提供されたタイムスタンプは、一貫してUTCとして解釈されるようになりました。 @pchovelonによる寄稿。 ( `#8937 `_ ) - バックアップステータスの更新を修正して、コンカレント更新中の「リソースが変更されました」エラーを防ぎます。 ( `#9551 `_ ) - バックアップポッドが見つからない場合に、正しいポッド名を使用するようにイベントレポートを修正しました。 ( `#9552 `_ ) - 非常に多くの履歴バックアップを持つクラスターのスケジュールされたバックアップ操作のパフォーマンスの向上。 ( `#9489 `_ ) - ``Database`` オブジェクトのファイナライザーを削除する際のエラー処理を修正しました。 ( `#9431 `_ ) - ``cnpg`` プラグイン: - ``skipWalArchiving`` アノテーションがクラスターに存在する場合に「Disabled」を表示するように\ ``status`` コマンドを更新しました。これは、WALアーカイブが意図的にバイパスされる場合の、混乱を招く「起動中」または「不明」状態を置き換えます。 `#9709 `_ !– 1.27 1.25 –> - ``logs --follow`` コマンドを修正して、現在のログストリームがすべて完了したときに途中で終了するのではなく、新しいポッドのポーリングを継続します。 ( `#9599 `_ ) バージョン1.28.0 ---------------- **発売日** 2025年12月9日 機能 ^^^^ - **クォーラムベースのフェイルオーバーが安定版に昇格** 1.27.0で実験的に導入されたクォーラムベースのフェイルオーバー機能を安定したAPIに昇格させました。このデータ駆動型フェイルオーバーメカニズムは、 ``spec.postgresql.synchronous.failoverQuorum`` フィールドを介して構成され、以前の\ ``alpha.cnpg.io/failoverQuorum`` アノテーションから卒業しました。 `#8589 `_ - **宣言的外部データ管理** ``Database`` CRDを拡張することにより、外部データラッパーFDWの包括的な宣言管理を導入しました。この機能は\ ``.spec.fdws`` および\ ``.spec.servers`` フィールドを追加し、FDW拡張機能とそれに対応する外部サーバーを\ ``Database`` リソースから直接管理できます。この作業は、LFXメンターシッププログラム2025第2期の一部として、Ying Zhu@EdwinaZhuによって実装されました。 `#7942 `_ 、 `#8401 `_ .. _変更-1: 変更 ^^^^ - デフォルトのPostgreSQLバージョンを\ ``18.1-system-trixie`` に更新しました。 ( `#9178 `_ ) - 新しい\ ``Pooler`` 展開用に、デフォルトのPgBouncerバージョンを **1.25.1** に更新しました。 ( `#9367 `_ ) .. _機能強化-2: 機能強化 ^^^^^^^^ - ``primaryUpdateMethod: restart`` を使用する場合のイメージと構成の同時変更が有効になり、同じ操作でコンテナイメージPostgreSQLバージョンまたは拡張機能を含むとPostgreSQL構成設定を更新できます。 ``primaryUpdateMethod: switchover`` を使用する場合でも、イメージと構成の変更を個別に実行して、スイッチオーバープロセス中の構成の不一致を回避する必要があることに注意してください。 `#8241 `_ - デフォルトの\ ``tcp_user_timeout`` を5秒に設定することにより、レプリカインスタンスのネットワーク障害の検出が向上しました。この変更により、レプリカはサイレントネットワークドロップをより迅速に検出および回復できます。以前は、レプリカはこのような障害を検出するまでに最大127秒待機することができました。新しいタイムアウトでは、5秒以内にプライマリに再接続します。以前の動作を保持するには、オペレーター構成で\ ``STANDBY_TCP_USER_TIMEOUT`` を\ ``0`` に設定します。 `#9317 `_ - CloudNativePGによって生成されたすべてのリソースクラスター、バックアップ、プーラーなどに標準のKubernetes推奨ラベルたとえば ``app.kubernetes.io/name`` を採用しました。 @JefeDavisによる寄稿。 `#8087 `_ - ポッドレベルで\ ``securityContext`` を導入し、個々のコンテナ用に\ ``containerSecurityContext`` を導入しました ``postgres`` 、\ ``init`` 、サイドカーを含むこれにより、セキュリティ設定の詳細な制御が提供され、以前のクラスター全体の\ ``postgres`` および\ ``operator`` ユーザー設定を置き換えます。 @x0ddfによる投稿。 `#6614 `_ - レプリカポッドの\ ``alpha.cnpg.io/unrecoverable=true`` アノテーションを導入しました。このアノテーションは、適用されると、ポッドとPVCを削除することによりインスタンスを完全に削除するようにオペレーターに指示します。その後、プライマリからレプリカを再作成します。 `#8178 `_ - ユーザー定義のモニタリングクエリーの新しいキャッシュレイヤーを導入して、PostgreSQLデータベースの負荷を削減します。 `#8003 `_ - ``auth_dbname`` を\ ``pgbouncer`` データベースに自動的に設定することによりPgBouncer統合を強化し、認証セットアップを簡素化します。 `#8671 `_ - データベースのインポート中にステージ固有の\ ``pg_restore`` オプション ``preRestore`` 、\ ``postRestore`` 、\ ``dataRestore`` を提供できます。 @hanshal101による寄稿。 `#7690 `_ - 識別と管理を簡単にするために、PostgreSQL ``majorVersion`` を\ ``Backup`` オブジェクトのステータスに追加しました。 ( `#8464 `_ ) - 復元プロセスを開始する前に、すべてのinitコンテナが完了するのを待機するようにクラスターの復元を強化しました。これにより、initコンテナで実行されているバックアップツールは、復元が開始される前にデータの準備を終了します。実装は、 ``RestartPolicy=Always`` を使用したサイドカーを無視することにより、Kubernetes initコンテナサイドカーを正しく処理します。 `#9026 `_ - ``PGBOUNCER_IMAGE_NAME`` オペレーター構成パラメーターを追加して、デフォルトのPgBouncerイメージをオーバーライドできるようにします。これは、エアギャップ環境または内部レジストリを使用する場合に役立ちます。 ( `#9232 `_ ) - ``cnpg`` プラグイン: - クラスターサイズの計算などのファイルシステム操作のタイムアウトを構成するための\ ``kubectl cnpg status`` コマンドに\ ``--timeout`` フラグを追加しました。デフォルトは10秒のままですが、操作に時間がかかる場合がある大規模なクラスターの場合、調整できます。 `#9201 `_ ) - ``cnpg report`` を改善して、よりシェルフレンドリーなファイル名を生成しました。 ( `#8984 `_ ) セキュリティ ^^^^^^^^^^^^ - PgBouncerの詳細なカスタムTLS構成を提供できます。 ``Pooler`` CRDは、 ``.spec.pgbouncer`` の下の\ ``clientTLSSecret`` 、\ ``clientCASecret`` 、\ ``serverTLSSecret`` 、および\ ``serverCASecret`` フィールドで拡張されました。これらのフィールドにより、ユーザーはクライアントからプーラー、およびプーラーからサーバーの両方の接続に独自の証明書を提供でき、オペレーターが生成した証明書よりも優先されます。 `#8692 `_ - オペレーターのメトリックサーバーポート8080にオプションのTLSサポートを追加しました。この機能はオプトインであり、 ``METRICS_CERT_DIR`` 環境変数を設定することにより有効にされます。これは、指定されたディレクトリで\ ``tls.crt`` および\ ``tls.key`` ファイルを探すようにオペレーターに指示します。設定しない場合、サーバーは下位互換性のためにHTTPを使用し続けます。 `#8997 `_ - オペレーターの展開のみを必要とすることにより、\ ``cnpg report operator`` が最小限の権限で動作できるようにしました。他のすべてのリソースポッド、シークレット、構成マップ、イベント、Webhook、およびOLMデータはオプショナルであり、ベストエフォートベースで収集されます。コマンドは、完全に失敗するのではなく、明確な警告をログに記録し、使用可能なデータでレポート生成を続行することにより、これらのリソースの権限エラーを適切に処理します。これにより、ユーザーが名前空間スコープの権限を制限できる最小特権アクセスが有効になります。 `#8982 `_ .. _修正-2: 修正 ^^^^ - 一時的なKubernetes APIサーバーの接続問題に対するすべてのプローブタイプライブネス、準備状況、およびスタートアップの復元力の向上。プローブは、短時間のネットワークの中断中にキャッシュされたクラスター定義にフォールバックするキャッシュメカニズムを使用するようになり、不必要なポッドの再起動とプローブの失敗を防ぎます。 ( `#9148 `_ ) - CNPG-Iバックアップ/WALプラグイン\ ``plugin-barman-cloud`` などを使用してボリュームスナップショットから復元するときに正しく実行されるように\ ``CheckEmptyWalArchive`` セーフガードを修正しました。以前は、このチェックはプラグインベースの実装でスキップされていました。 ( `#9306 `_ ) - ImageCatalogの取得が失敗した場合のエラー報告を改善しました。オペレーターはWarningイベントを発行し、\ ``NotFound`` エラーだけでなくすべての障害タイプのエラーをログに記録するようになり、構成の問題の可視性が向上しました。 ( `#9266 `_ ) - ``cnpg.io/pluginServerName`` アノテーションを追加することにより、CNPG-Iプラグインに接続する際のTLS証明書検証の問題を修正しました。これにより、プラグインの証明書がサービス名とは別のDNS名を使用する環境で、証明書の検証に使用されるDNS名をカスタマイズできます。 ( `#9222 `_ ) - インスタンスマネージャーコントローラがエラーの後に再起動に失敗し、「コントローラは既に存在します」メッセージを報告する問題を修正しました。コントローラは、後続の初期化試行に\ ``SkipNameValidation`` を使用するようになりました。 @mateusoliveira43による寄稿。 ( `#9123 `_ ) - 宛先パスが絶対である場合、プラグインでの誤ったWAL復元パスの処理を修正し、パスの重複の問題を防ぎます。 @Endevirによる寄稿。 ( `#9093 `_ ) - PostgreSQL 13+との下位互換性があるように、マルチテーブルパブリケーションの\ ``CREATE PUBLICATION`` SQL生成を修正しました。以前に生成された構文はPostgreSQL 15+でのみ有効であり、古いバージョンでは構文エラーが発生しました。 ( `#8888 `_ ) - インデックスではなく名前で\ ``postgres`` コンテナを確実に選択することにより、複雑なポッド定義でのバックアップの失敗を修正しました。 @Joda89による寄稿。 ( `#8964 `_ ) - ``cnpg`` プラグイン - ``cnpg report`` ログ収集、特に以前のログを取得する場合のバグを修正しました。コレクターは、以前のログと現在のログを別の要求で正しく取得し、欠落している以前のログたとえば、再起動履歴のないコンテナを適切に処理し、現在のログが常に収集されるようにします。 ( `#8992 `_ ) サポートされているバージョン ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - Kubernetes 1.34、1.33、および1.32 - PostgreSQL 18、17、16、15、および14 - PostgreSQL 18.1はデフォルトのイメージです