# CloudNativePG v1.30.2

2026-11-17 · [릴리스 노트 원문](https://github.com/cloudnative-pg/cloudnative-pg/releases/tag/v1.30.2) · [전체 정리](https://ratatosk.io/ko/releases/cloudnativepg/v1.30.2)

보안 2 · 호환성 변경 1 · 폐기 예정 1 · 중요 수정 6 · 기타 15

## 업그레이드 전 확인

### 알려진 문제

- **PostgreSQL 14 커뮤니티 수정 종료**: PostgreSQL 커뮤니티는 2026년 11월 12일에 PostgreSQL 14의 수정 사항 제공을 중단했습니다. PostgreSQL 15는 2027년 11월 11일부터 수정 사항을 더는 제공받지 못할 예정입니다.
  >   - **PostgreSQL 14 is no longer supported**: the PostgreSQL community stopped fixing PostgreSQL 14 on November 12, 2026, and CloudNativePG supports a major version only as long as PostgreSQL does. If you still run PostgreSQL 14, plan an upgrade to a newer major version. PostgreSQL 15 stops receiving fixes on November 11, 2027. ([\#11935](https://github.com/cloudnative-pg/cloudnative-pg/pull/11935)) <!-- 1.28 -->

## 보안 (2)

### `golang.org/x/net` HTTP/2 및 HTML 처리 결함 수정

- 영향 대상: 영향받는 `golang.org/x/net` HTTP/2 클라이언트 또는 서버 경로에 트래픽이 도달하는 구성
- [GO-2026-6603](https://osv.dev/vulnerability/GO-2026-6603), [GO-2026-6610](https://osv.dev/vulnerability/GO-2026-6610), [GO-2026-6611](https://osv.dev/vulnerability/GO-2026-6611), [GO-2026-6612](https://osv.dev/vulnerability/GO-2026-6612), [GO-2026-6617](https://osv.dev/vulnerability/GO-2026-6617), [GO-2026-6860](https://osv.dev/vulnerability/GO-2026-6860), [GO-2026-6866](https://osv.dev/vulnerability/GO-2026-6866)

업그레이드 전에는 피어가 스트림을 재설정하거나 설정 프레임을 반복해서 보내거나 트레일러 필드를 많이 선언할 때, 영향을 받는 HTTP/2 경로가 크래시를 일으키거나 흐름 제어 크레딧을 두 번 반환하거나 과도한 CPU를 사용하거나 프레이밍 관련 잘못된 헤더를 잘못 처리하거나 지나치게 많은 메모리를 할당할 수 있었습니다. 이번 업데이트는 특정 HTML 텍스트 입력으로 인한 이차적 메모리 할당과 렌더링 후 다시 파싱할 때 네임스페이스가 바뀌는 문제도 수정합니다. `x/net/html`은 CloudNativePG 코드에서 임포트하지 않는 간접 의존성입니다.

>   - Updated `golang.org/x/net` to v0.62.0, fixing GO-2026-6617, GO-2026-6612, GO-2026-6611, GO-2026-6610, GO-2026-6603, GO-2026-6860 and GO-2026-6866, and bumped the other `golang.org/x` modules. ([\#11631](https://github.com/cloudnative-pg/cloudnative-pg/pull/11631), <!-- 1.28 --> [\#11867](https://github.com/cloudnative-pg/cloudnative-pg/pull/11867)) <!-- 1.28 -->

### PostgreSQL 18.7 기본 오퍼랜드 이미지로 지정

- 영향 대상: 이미지를 지정하지 않은 신규 클러스터와 `imageName` 또는 `ImageCatalog`를 사용하는 기존 클러스터
- 추가 조치: 수정 사항을 적용하려면 기존 클러스터의 `imageName` 또는 `ImageCatalog`를 18.7, 17.12, 16.16 또는 15.20으로 변경해야 합니다.

업데이트된 이미지에는 여러 CVE 수정 사항이 포함되지만, 기존 클러스터의 이미지는 자동으로 변경되지 않습니다.

>   - **PostgreSQL 18.7 is the new default image**: the default operand image is now `18.7-system-trixie`, which fixes several CVEs. It applies only to new clusters that don't set an image. To get the fixes, update existing clusters to 18.7, 17.12, 16.16 or 15.20 by changing `imageName` or the `ImageCatalog`. Before updating, read the [PostgreSQL 18.7 announcement](https://www.postgresql.org/about/news/postgresql-187-1712-1616-1520-1425-and-19-rc-2-released-3442/) and the release notes it links. ([\#11833](https://github.com/cloudnative-pg/cloudnative-pg/pull/11833)) <!-- 1.28 -->

## 호환성 변경 (1)

### 기본 PgBouncer 이미지 1.26.1로 업데이트

- 영향 대상: 기본 PgBouncer 이미지를 사용하는 풀러

이전 기본 이미지는 1.25.2였습니다. 오퍼레이터를 업그레이드하면 이 풀러에 새 이미지가 롤아웃됩니다.

>   - Updated the default PgBouncer image from 1.25.2 to 1.26.1. Poolers that use the default image roll out the new version when the operator is upgraded. ([\#11571](https://github.com/cloudnative-pg/cloudnative-pg/pull/11571), <!-- 1.28 --> [\#11704](https://github.com/cloudnative-pg/cloudnative-pg/pull/11704)) <!-- 1.28 -->

## 폐기 예정 (1)

### `barmanObjectStore` 백업 제거 경고

- 영향 대상: `barmanObjectStore` 방식을 사용하는 `Backup` 및 `ScheduledBackup` 리소스
- 제거 시점: 1.32

이 경고는 1.32에서 네이티브 Barman Cloud 지원이 제거되는 것에 관한 내용입니다. `Cluster` 리소스는 이미 해당 지원을 제공하고 있었습니다. 이 경고 동작은 직전 릴리스에도 이미 있었으므로, 업그레이드해도 새로운 경고가 추가되지는 않습니다.

>   - `Backup` and `ScheduledBackup` resources that use the `barmanObjectStore` method now return an admission warning about the removal of native Barman Cloud support in 1.32, as `Cluster` resources already did. ([\#11725](https://github.com/cloudnative-pg/cloudnative-pg/pull/11725)) <!-- 1.28 -->

## 중요 수정 (6)

### 인스턴스 매니저, 확장 이미지에 없는 디렉터리 경로 제외

- 영향 대상: 기본 경로나 사용자 지정 경로가 설정된 확장 이미지를 사용하는 클러스터

기본 경로나 사용자 지정 경로가 가리키는 디렉터리가 확장 이미지에 없으면, 예를 들어 이미지에 `lib`만 있고 `share`가 없는 경우에도 생성된 `extension_control_path`와 `dynamic_library_path`에 해당 디렉터리가 포함됐습니다. PostgreSQL은 해당 경로를 조용히 무시했습니다. 이제 인스턴스 매니저는 사용자 지정 경로를 포함해 존재하지 않는 디렉터리를 오류 없이 경로 목록에서 제외합니다.

>   - `extension_control_path` and `dynamic_library_path` no longer list directories that are missing from an extension image, for example `share` in an image that ships only `lib`. ([\#11652](https://github.com/cloudnative-pg/cloudnative-pg/pull/11652))

### WAL 개수 및 크기 메트릭의 파일 집계 수정

- 영향 대상: WAL 개수 및 크기 메트릭을 사용하는 구성 (추정)

메트릭이 `.partial`, `.backup`, `.history` 파일까지 집계했습니다.

>   - Fixed the WAL count and size metrics counting `.partial`, `.backup` and `.history` files. ([\#9967](https://github.com/cloudnative-pg/cloudnative-pg/pull/9967)) <!-- 1.28 -->

### 복원된 Cluster의 primary Lease 처리 수정

- 영향 대상: `OwnerReferencesPermissionEnforcement`를 사용하는 Cluster

잔여 리소스가 남은 상태에서 Cluster를 다시 만들면 오퍼레이터가 기존 primary Lease를 가져오지 못해 Cluster가 `Unable to create required cluster objects` 상태에 머물렀습니다. 상태 정보가 없는 orphan PVC를 대상으로 복원할 때 소유자가 없는 오래된 Lease를 가져오면 새 primary가 Lease 기간만큼 늦어질 수 있었습니다. 이제 오퍼레이터는 해당 Lease를 삭제하고 새 Lease를 만든 뒤, 나머지 잔여 Lease는 가져옵니다. 이 작업이 동작하려면 수동으로 관리하는 RBAC에서 `leases`에 대한 `delete` 권한을 부여해야 합니다.

>   - The operator now needs the `delete` permission on `leases`. Users who manage the RBAC manually must add it. ([\#11609](https://github.com/cloudnative-pg/cloudnative-pg/pull/11609))
>   - Fixed a `Cluster` recreated over leftover resources (for example by a backup tool) staying in `Unable to create required cluster objects` with `cannot set an ownerRef on a resource you can't delete`. This happened with the `OwnerReferencesPermissionEnforcement` admission plugin. When restoring over orphan PVCs, the operator now deletes the stale primary `Lease`, so the new primary does not wait for it to expire. ([\#11609](https://github.com/cloudnative-pg/cloudnative-pg/pull/11609))

### `barman-cloud` 백업 카탈로그 조회 시 실패한 백업 건너뛰기

- 영향 대상: `barman-cloud`로 백업 카탈로그를 읽는 구성 (추정)

>   - Updated the `barman-cloud` library to v0.7.0, which skips failed backups when it reads the backup catalog. ([\#11711](https://github.com/cloudnative-pg/cloudnative-pg/pull/11711)) <!-- 1.28 -->

### 핫 스탠바이 파라미터 제거 후 레플리카 크래시 루프 수정

- 영향 대상: `max_connections` 같은 핫 스탠바이 파라미터를 사용하는 레플리카

.spec.postgresql.parameters에서 핫 스탠바이 파라미터를 제거한 뒤, 레플리카가 `recovery aborted because of insufficient parameter settings` 오류와 함께 크래시 루프에 빠질 수 있었습니다. 이제 이 상황에서 해당 오류로 크래시 루프에 빠지지 않습니다.

>   - Fixed replicas crash looping with `recovery aborted because of insufficient parameter settings` after a hot standby parameter such as `max_connections` was removed from `.spec.postgresql.parameters`. Contributed by @ichibahn. ([\#11236](https://github.com/cloudnative-pg/cloudnative-pg/pull/11236)) <!-- 1.28 -->

### 프리즈된 postmaster 대기 문제 수정

- 영향 대상: 프리즈 상태가 될 수 있는 postmaster를 실행하는 PostgreSQL 인스턴스

프리즈된 postmaster가 연결은 받아들이지만 응답하지 않으면, 인스턴스 매니저가 무기한 대기해 인스턴스 상태 확인, 메트릭 익스포터, 인트리 백업 전 검사가 막힐 수 있었습니다. 이제 로컬 연결 시도는 5초 후 타임아웃됩니다.

>   - Fixed the instance manager waiting forever on a frozen postmaster, one that accepts connections but never answers. This blocked the instance status, the metrics exporter and the check before an in-tree backup. Local connection attempts to PostgreSQL now time out after 5 seconds. ([\#11718](https://github.com/cloudnative-pg/cloudnative-pg/pull/11718)) <!-- 1.28 -->

## 기타 (15)

- 스탠바이 아카이브 복원에 따른 스트리밍 재시도
- S3 호환 오브젝트 스토어의 SSE-C 키 필드
- 일시적 연결 오류를 기록하는 `barman-cloud-wal-restore`
- 오퍼레이터 로그 라인의 기본 수준을 debug로 설정
- `kubectl cnpg status`의 `pods/exec` 권한 누락 처리
- 실행 중인 클러스터에서 사이드카 플러그인 Pod 재생성
- 온라인 스냅샷 복제본의 WAL 아카이브 복구 수정
- 부트스트랩 중인 리플리카를 스탠바이 슬롯 목록에서 제외
- CloudNativePG 오퍼레이터의 `status.phaseReason` 반복 업데이트 중단
- 인스턴스 상태 오류를 네트워크 장애로 간주한 재시도 중단
- WAL 복원 아카이브 종료 마커 적용 범위 수정
- 지연 없이 재큐잉하는 플러그인의 1초 후 재시도
- PostgreSQL 중지 상태에서 `pg_control`의 system ID를 읽는 상태 프로브
- 오래된 Backup 리컨실의 중복 시작 및 상태 롤백 방지
- 볼륨 스냅샷 백업 옵션에서 클러스터 설정 유지

---

정리 내용은 AI가 작성하므로 틀릴 수 있으며, 보증 없이 제공합니다.
