Skip to content

Commit 941e525

Browse files
committed
docs: import CloudNativePG main
1 parent df31450 commit 941e525

File tree

9 files changed

+384
-107
lines changed

9 files changed

+384
-107
lines changed

website/docs/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -64,7 +64,7 @@ container images for both the operator and PostgreSQL (the operand).
6464

6565
The CloudNativePG operator container images are available on the
6666
[`cloudnative-pg` project's GitHub Container Registry](https://github.com/cloudnative-pg/cloudnative-pg/pkgs/container/cloudnative-pg)
67-
in three different flavors:
67+
in two different flavors:
6868

6969
- Debian 12 distroless
7070
- Red Hat UBI 9 micro (suffix `-ubi9`)

website/docs/installation_upgrade.md

Lines changed: 3 additions & 68 deletions
Original file line numberDiff line numberDiff line change
@@ -267,22 +267,16 @@ removed before installing the new one. This won't affect user data but
267267
only the operator itself.
268268

269269

270-
### Upgrading to 1.28.0 or 1.27.x
270+
### Upgrading to 1.29.0 or 1.28.x
271271

272272
:::info[Important]
273273
We strongly recommend that all CloudNativePG users upgrade to version
274-
1.28.0, or at least to the latest stable version of your current minor release
275-
(e.g., 1.27.x).
274+
1.29.0, or at least to the latest stable version of your current minor release
275+
(e.g., 1.28.x).
276276
:::
277277

278278
### Upgrading to 1.27 from a previous minor version
279279

280-
:::info[Important]
281-
We strongly recommend that all CloudNativePG users upgrade to version
282-
1.27.0, or at least to the latest stable version of your current minor release
283-
(e.g., 1.26.1).
284-
:::
285-
286280
Version 1.27 introduces a change in the default behavior of the
287281
[liveness probe](instance_manager.md#liveness-probe): it now enforces the
288282
[shutdown of an isolated primary](instance_manager.md#primary-isolation)
@@ -299,65 +293,6 @@ spec:
299293
enabled: false
300294
```
301295
302-
### Upgrading to 1.26 from a previous minor version
303-
304-
:::warning
305-
Due to changes in the startup probe for the manager component
306-
([#6623](https://github.com/cloudnative-pg/cloudnative-pg/pull/6623)),
307-
upgrading the operator will trigger a restart of your PostgreSQL clusters,
308-
even if in-place updates are enabled (`ENABLE_INSTANCE_MANAGER_INPLACE_UPDATES=true`).
309-
Your applications will need to reconnect to PostgreSQL after the upgrade.
310-
:::
311-
312-
#### Deprecation of backup metrics and fields in the `Cluster` `.status`
313-
314-
With the transition to a backup and recovery agnostic approach based on CNPG-I
315-
plugins in CloudNativePG, which began with version 1.26.0 for Barman Cloud, we
316-
are starting the deprecation period for the following fields in the `.status`
317-
section of the `Cluster` resource:
318-
319-
- `firstRecoverabilityPoint`
320-
- `firstRecoverabilityPointByMethod`
321-
- `lastSuccessfulBackup`
322-
- `lastSuccessfulBackupByMethod`
323-
- `lastFailedBackup`
324-
325-
The following Prometheus metrics are also deprecated:
326-
327-
- `cnpg_collector_first_recoverability_point`
328-
- `cnpg_collector_last_failed_backup_timestamp`
329-
- `cnpg_collector_last_available_backup_timestamp`
330-
331-
:::warning
332-
If you have migrated to a plugin-based backup and recovery solution such as
333-
Barman Cloud, these fields and metrics are no longer synchronized and will
334-
not be updated. Users still relying on the in-core support for Barman Cloud
335-
and volume snapshots can continue to use these fields for the time being.
336-
:::
337-
338-
Under the new plugin-based approach, multiple backup methods can operate
339-
simultaneously, each with its own timeline for backup and recovery. For
340-
example, some plugins may provide snapshots without WAL archiving, while others
341-
support continuous archiving.
342-
343-
Because of this flexibility, maintaining centralized status fields in the
344-
`Cluster` resource could be misleading or confusing, as they would not
345-
accurately represent the state across all configured backup methods.
346-
For this reason, these fields are being deprecated.
347-
348-
Instead, each plugin is responsible for exposing its own backup status
349-
information and providing metrics back to the instance manager for monitoring
350-
and operational awareness.
351-
352-
#### Declarative Hibernation in the `cnpg` plugin
353-
354-
In this release, the `cnpg` plugin for `kubectl` transitions from an imperative
355-
to a [declarative approach for cluster hibernation](declarative_hibernation.md).
356-
The `hibernate on` and `hibernate off` commands are now convenient shortcuts
357-
that apply declarative changes to enable or disable hibernation.
358-
The `hibernate status` command has been removed, as its purpose is now
359-
fulfilled by the standard `status` command.
360-
361296
## Verifying release assets
362297
363298
CloudNativePG cryptographically signs all official release assets. Verifying these

website/docs/preview_version.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,15 +20,16 @@ intended for public testing prior to the final release.
2020

2121
## Current Preview Version
2222

23-
<!--
2423
There are currently no preview versions available.
25-
-->
24+
25+
<!--
2626
The current preview version is **1.29.0-rc1**.
2727
2828
For more information on the current preview version and how to test, please view the links below:
2929
3030
- [Announcement](https://cloudnative-pg.io/releases/cloudnative-pg-1-29.0-rc1-released/)
3131
- [Documentation](https://cloudnative-pg.io/docs/preview/)
32+
-->
3233

3334
## Purpose of Release Candidates
3435

website/docs/release_notes.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,16 +9,16 @@ title: Release notes
99

1010
History of user-visible changes for CloudNativePG, classified for each minor release.
1111

12-
- [CloudNativePG 1.29 - Release Candidate](release_notes/v1.29.md) (preview)
12+
- [CloudNativePG 1.29](release_notes/v1.29.md)
1313
- [CloudNativePG 1.28](release_notes/v1.28.md)
14-
- [CloudNativePG 1.27](release_notes/v1.27.md)
1514

1615
For information on the community support policy for CloudNativePG, please
1716
refer to ["Supported releases"](supported_releases.md).
1817

1918
Older releases:
2019

21-
- [CloudNativePG 1.26](release_notes/v1.26.md)
20+
- [CloudNativePG 1.27](release_notes/v1.27.md)
21+
- [CloudNativePG 1.26](release_notes/old/v1.26.md)
2222
- [CloudNativePG 1.25](release_notes/old/v1.25.md)
2323
- [CloudNativePG 1.24](release_notes/old/v1.24.md)
2424
- [CloudNativePG 1.23](release_notes/old/v1.23.md)

website/docs/release_notes/v1.27.md

Lines changed: 157 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,163 @@ For a complete list of changes, please refer to the
1111
[commits](https://github.com/cloudnative-pg/cloudnative-pg/commits/release-1.27)
1212
on the release branch in GitHub.
1313

14+
## Version 1.27.4
15+
16+
**Release date:** Mar 31, 2026
17+
18+
:::warning
19+
This is the final release in the 1.27.x series.
20+
Users are strongly encouraged to upgrade to a newer minor version, as 1.27
21+
is no longer supported.
22+
:::
23+
24+
### Important changes
25+
26+
- Updated the deprecation notice for native (in-tree) Barman Cloud support to
27+
reflect that it will now be removed in CloudNativePG 1.30.0, rather than
28+
1.29.0. Users are still encouraged to migrate to the Barman Cloud Plugin.
29+
([#10167](https://github.com/cloudnative-pg/cloudnative-pg/pull/10167)) <!-- 1.28 1.27 -->
30+
31+
### Enhancements
32+
33+
- Improved the `Pooler` CRD with support for granular configuration of TLS
34+
cipher suites and minimum/maximum TLS versions. This enables administrators
35+
to meet strict security compliance requirements for pooler-to-client and
36+
pooler-to-server connections.
37+
Contributed by @alex1989hu.
38+
([#9571](https://github.com/cloudnative-pg/cloudnative-pg/pull/9571)) <!-- 1.28 1.27 1.25 -->
39+
40+
- Improved the reliability of major upgrades by setting `BackoffLimit=0` on the
41+
upgrade job, preventing unnecessary retries of a failed `pg_upgrade`. The
42+
operator now automatically deletes the failed job when a user reverts the
43+
container image, allowing the cluster to restart gracefully on the original
44+
version.
45+
([#10104](https://github.com/cloudnative-pg/cloudnative-pg/pull/10104),
46+
[#10298](https://github.com/cloudnative-pg/cloudnative-pg/pull/10298)) <!-- 1.28 1.27 -->
47+
48+
- Improved role management by verifying the instance is the primary before
49+
each reconciliation cycle, avoiding unnecessary reconciliation attempts and
50+
spurious error messages on read-only replicas.
51+
([#9971](https://github.com/cloudnative-pg/cloudnative-pg/pull/9971)) <!-- 1.28 1.27 1.25 -->
52+
53+
- Extended the CRD schemas for `Cluster`, `ImageCatalog`, and
54+
`ClusterImageCatalog` to accept the `extensions`, `bin_path`, and `env`
55+
fields introduced in 1.29. The operator ignores these fields on older
56+
versions, but accepting them in the schema allows users to share a single
57+
manifest across clusters running different CNPG versions.
58+
([#10131](https://github.com/cloudnative-pg/cloudnative-pg/pull/10131),
59+
[#10387](https://github.com/cloudnative-pg/cloudnative-pg/pull/10387)) <!-- 1.28 1.27 -->
60+
61+
- The operator now honors the `primaryUpdateMethod` when adding new PVCs to a
62+
cluster, ensuring that the rollout strategy (e.g., switchover vs. restart) is
63+
respected during storage expansion or additions.
64+
([#9720](https://github.com/cloudnative-pg/cloudnative-pg/pull/9720)) <!-- 1.28 1.27 -->
65+
66+
### Security and Supply Chain
67+
68+
- **Security best practices integration**: integrated the OpenSSF baseline
69+
scanner and added a `SECURITY-INSIGHTS.yaml` file to the repository to align
70+
with industry-standard security reporting.
71+
([#10054](https://github.com/cloudnative-pg/cloudnative-pg/pull/10054), <!-- 1.28 1.27 1.25 -->
72+
[#10062](https://github.com/cloudnative-pg/cloudnative-pg/pull/10062)) <!-- 1.28 1.27 1.25 -->
73+
74+
- **SLSA provenance and SBOMs**: added SLSA (Supply-chain Levels for Software
75+
Artifacts) provenance to release binaries and container images. Additionally,
76+
enabled Software Bill of Materials (SBOM) generation within the GoReleaser
77+
pipeline for improved dependency transparency.
78+
([#10048](https://github.com/cloudnative-pg/cloudnative-pg/pull/10048), <!-- 1.28 1.27 1.25 -->
79+
[#10074](https://github.com/cloudnative-pg/cloudnative-pg/pull/10074)) <!-- 1.28 1.27 1.25 -->
80+
81+
- **Password leak prevention**: fixed a potential security risk where PostgreSQL
82+
could leak role passwords in the logs during specific reconciliation phases.
83+
([#9950](https://github.com/cloudnative-pg/cloudnative-pg/pull/9950)) <!-- 1.28 1.27 1.25 -->
84+
85+
### Changes
86+
87+
- Updated the default PostgreSQL version to 18.3 (image `18.3-system-trixie`).
88+
([#10090](https://github.com/cloudnative-pg/cloudnative-pg/pull/10090)) <!-- 1.28 1.27 1.25 -->
89+
90+
### Fixes
91+
92+
- Fixed an issue where fencing annotations could not be processed when the WAL
93+
disk was full, because the disk space check blocked the instance manager from
94+
starting. The check is now performed later in the lifecycle loop, after
95+
fencing is evaluated.
96+
([#10302](https://github.com/cloudnative-pg/cloudnative-pg/pull/10302)) <!-- 1.28 1.27 -->
97+
98+
- Fixed an issue where replicas would get stuck in a `Pending` state if the
99+
`VolumeSnapshot` used for the initial bootstrap had been deleted. The
100+
operator now validates snapshot existence before use; if a snapshot is missing,
101+
it attempts to use the next available candidate or falls back to
102+
`pg_basebackup`.
103+
([#10192](https://github.com/cloudnative-pg/cloudnative-pg/pull/10192)) <!-- 1.28 1.27 1.25 -->
104+
105+
- Prevented the "supervised primary" rollout strategy from consuming all
106+
available rollout slots, which previously caused delays in scheduled updates.
107+
Contributed by @ermakov-oleg.
108+
([#9977](https://github.com/cloudnative-pg/cloudnative-pg/pull/9977)) <!-- 1.28 1.27 1.25 -->
109+
110+
- Fixed an issue where certain hot-standby parameter changes were not being
111+
correctly applied to replica clusters.
112+
([#9952](https://github.com/cloudnative-pg/cloudnative-pg/pull/9952)) <!-- 1.28 1.27 1.25 -->
113+
114+
- Fixed a bug in the CNPG-I reconciler hook that could lead to skipping
115+
subsequent plugins when a "continue" result was returned.
116+
Contributed by @sharifmshaker.
117+
([#9978](https://github.com/cloudnative-pg/cloudnative-pg/pull/9978)) <!-- 1.28 1.27 -->
118+
119+
- Fixed a deadlock scenario that occurred when attempting to resize a
120+
filesystem on a PVC that was not currently attached to a Pod.
121+
Contributed by @jmealo.
122+
([#9981](https://github.com/cloudnative-pg/cloudnative-pg/pull/9981)) <!-- 1.28 1.27 -->
123+
124+
- Fixed webhook validation of bootstrap recovery sources to accept external
125+
clusters configured with `ConnectionParameters` (for `pg_basebackup`-based
126+
recovery). Previously, these were incorrectly rejected unless a Barman
127+
object store or CNPG-i plugin was also configured.
128+
([#10268](https://github.com/cloudnative-pg/cloudnative-pg/pull/10268)) <!-- 1.28 1.27 1.25 -->
129+
130+
- Volume names for extensions and tablespaces are now prefixed to avoid naming
131+
collisions with standard cluster volumes.
132+
([#9973](https://github.com/cloudnative-pg/cloudnative-pg/pull/9973)) <!-- 1.28 1.27 -->
133+
134+
- When hibernating a non-healthy cluster, the operator now reports a
135+
`WaitingForHealthy` condition, making the deferred hibernation state visible
136+
through `cnpg status`.
137+
([#10193](https://github.com/cloudnative-pg/cloudnative-pg/pull/10193)) <!-- 1.28 1.27 1.25 -->
138+
139+
- Fixed fencing to work correctly even when the target pod does not exist.
140+
Fencing operates on a cluster-level annotation and should not depend on pod
141+
existence; instance name validation is now performed only in the `cnpg
142+
fencing on` command.
143+
([#10035](https://github.com/cloudnative-pg/cloudnative-pg/pull/10035)) <!-- 1.28 1.27 1.25 -->
144+
145+
- Fixed the cluster and pooler service reconcilers to correctly handle changes
146+
to all spec fields when using the patch update strategy. The reconciler now
147+
uses RFC 7386 JSON Merge Patching, preventing cloud-provider-set fields
148+
(such as `loadBalancerClass`) from being inadvertently removed.
149+
([#10190](https://github.com/cloudnative-pg/cloudnative-pg/pull/10190),
150+
[#10311](https://github.com/cloudnative-pg/cloudnative-pg/pull/10311)) <!-- 1.28 1.27 1.25 -->
151+
152+
- Fixed a race condition in the deprecated in-tree Barman Cloud backup
153+
implementation affecting parallel WAL restore, where prefetched files could
154+
be read while still being downloaded, causing PostgreSQL recovery to fail
155+
with "invalid checkpoint record" errors.
156+
([#10285](https://github.com/cloudnative-pg/cloudnative-pg/pull/10285)) <!-- 1.28 1.27 1.25 -->
157+
158+
- Fixed the timeline history file validation to also apply to plugin-based WAL
159+
restore. Previously, the protection introduced in
160+
[#9650](https://github.com/cloudnative-pg/cloudnative-pg/pull/9650) only
161+
covered in-tree restores, allowing plugins to bypass the check and download
162+
future timeline history files, causing timeline mismatch errors on replicas.
163+
([#9849](https://github.com/cloudnative-pg/cloudnative-pg/pull/9849)) <!-- 1.28 1.27 1.25 -->
164+
165+
- `cnpg` plugin:
166+
167+
- The cnpg plugin now correctly propagates ImagePullSecrets to the
168+
`pgbench` Job pod template.
169+
([#10174](https://github.com/cloudnative-pg/cloudnative-pg/pull/10174)) <!-- 1.28 1.27 1.25 -->
170+
14171
## Version 1.27.3
15172

16173
**Release date:** Feb 5, 2026

0 commit comments

Comments
 (0)