Releases: EnterpriseDB/kubectl-cnp
v1.19.5
Release date: Oct 18, 2023
!!! Warning Version 1.19 will reach its End-of-Life (EOL) on November 9, 2023. If you haven't done it yet, please start planning an upgrade as soon as possible.
Important Changes:
- Change the default value of
stopDelay
to 1800 seconds instead of 30 seconds (#2848) - Introduce a new parameter, called
smartShutdownTimeout
, to control the window of time reserved for the smart shutdown of Postgres to complete; the general formula to compute the overall timeout to stop Postgres ismax(stopDelay - smartShutdownTimeout, 30)
(#2848) - Change the default value of
startDelay
to 3600, instead of 30 seconds (#2847) - Replace the livenessProbe initial delay with a more proper Kubernetes startup probe to deal with the start of a Postgres server (#2847)
- Change the default value of
switchoverDelay
to 3600 seconds instead of 40000000 seconds (#2846) - Stop supporting the
postgresql
label - replaced byk8s.enterprisedb.io/cluster
in 1.18 (#2744)
Security:
- Add a default
seccompProfile
to the operator deployment (#2926)
Enhancements:
- Introduce the
k8s.enterprisedb.io/coredumpFilter
annotation to control the content of a core dump generated in the unlikely event of a PostgreSQL crash, by default set to exclude shared memory segments from the dump (#2733) - Allow to configure ephemeral-storage limits for the shared memory and temporary data ephemeral volumes (#2830)
- Validate resource limits and requests through the webhook (#2663)
- Ensure that PostgreSQL's
shared_buffers
are coherent with the pods' allocated memory resources (#2840) - Add
uri
andjdbc-uri
fields in the credential secrets to facilitate developers when connecting their applications to the database (#2186) - Add a new phase
Waiting for the instances to become active
for finer control of a cluster's state waiting for the replicas to be ready (#2612) - Improve detection of Pod rollout conditions through the
podSpec
annotation (#2243) - Add primary timestamp and uptime to the kubectl plugin's
status
command (#2953)
Fixes:
-
Ensure that the primary instance is always recreated first by prioritizing ready PVCs with a primary role (#2544)
-
Honor the
k8s.enterprisedb.io/skipEmptyWalArchiveCheck
annotation during recovery to bypass the check for an empty WAL archive (#2731) -
Prevent a cluster from being stuck when the PostgreSQL server is down but the pod is up on the primary (#2966)
-
Avoid treating the designated primary in a replica cluster as a regular HA replica when replication slots are enabled (#2960)
-
Reconcile services every time the selectors change or when labels/annotations need to be changed (#2918)
-
Defaults to
app
both the owner and database during recovery bootstrap (#2957) -
Avoid write-read concurrency on cached cluster (#2884)
-
Remove empty items, make them unique and sort in the
ResourceName
sections of the generated roles (#2875) -
Ensure that the
ContinuousArchiving
condition is properly set to 'failed' in case of errors (#2625) -
Make the
Backup
resource reconciliation cycle more resilient on interruptions by stopping only if the backup is completed or failed (#2591) -
Reconcile PodMonitor
labels
andannotations
(#2583) -
Fix backup failure due to missing RBAC
resourceNames
on theRole
object (#2956) -
Observability:
- Add TCP port label to default
pg_stat_replication
metric (#2961) - Fix the
pg_wal_stat
default metric for Prometheus (#2569) - Improve the
pg_replication
default metric for Prometheus (#2744 and #2750) - Use
alertInstanceLabelFilter
instead ofalertName
in the provided Grafana dashboard - Enforce
standard_conforming_strings
in metric collection (#2888)
- Add TCP port label to default
Changes:
- Set the default operand image to PostgreSQL 16.0
- Fencing now uses PostgreSQL's fast shutdown instead of smart shutdown to halt an instance (#3051)
- Rename webhooks from kb.io to k8s.enterprisedb.io group (#2851)
- Let the
cnp hibernate
plugin command use theClusterManifestAnnotationName
andPgControldataAnnotationName
annotations on PVCs (#2657) - Add the
k8s.enterprisedb.io/instanceRole
label while deprecating the existingrole
label (#2915)
Technical enhancements:
- Replace
k8s-api-docgen
withgen-crd-api-reference-docs
to automatically build the API reference documentation (#2606)
Release 1.19.4
Release date: July 27, 2023
Enhancements:
- New
logs
command in the kubectl plugin, to retrieve or follow the logs of all pods in a cluster (#2375) - Add support for specifying priorityClassName in pods, helping Kubernetes make scheduling decisions (#2043)
- Add a metric and status field to monitor node usage by a EDB Postgres for Kubernetes cluster (#2257)
- Various enhancements to the documentation:
- Add troubleshooting instructions relating to hugepages (#1390)
- Extend the FAQs page (#2344)
Technical enhancements:
- Add a check at the start of the restore process to ensure it can proceed; give improved error diagnostics if it cannot (#2419)
Fixes:
- Ensure the logic of setting the recovery target matches that of Postgres (#2460)
- Prevent taking over service accounts not owned by the cluster, by setting ownerMetadata only during service account creation (#2462)
- Ensure correct permissions of the PGDATA directory for initdb and restore (#2384)
- Prevent a possible crash of the instance manager during the configuration reload (#2393)
- Prevent the LastFailedArchiveTime alert from triggering if a new backup has been successful after the failed ones (#1751)
- Prevent services from targeting non-instance pods (#2336)
Security:
- Updated all project dependencies to the latest versions
Release 1.19.3
Release date: June 12, 2023
Enhancements:
- Add the
snapshot
command to thecnp
plugin to create a consistent cold backup of the cluster from a standby using the KubernetesVolumeSnapshot
standard resource (#1960) - First implementation of recovery from a set of CSI VolumeSnapshot resources via the
.spec.bootstrap.recovery.volumeSnapshot
stanza (#1960) - Add
pg_failover_slots
to managed extensions (#2057) - Improved Grafana dashboard with updated instructions in the documentation and the quickstart guide (#1916)
- Introduce the
schemaOnly
option in theimport
stanza, to avoid exporting and importing data when you bootstrap a new Postgres Cluster from one or more existing databases (#2234) - Add support for TopologySpreadConstraints to manage scheduling of instance pods (#2202)
- Add
PodMonitor
support to thePooler
for PgBouncer (#2034) - Add option to override the default Kubernetes scheduler (#2013)
- Allow configuration of deployment strategy of a
Pooler
resource (#1983) - Update default PostgreSQL version to 15.3 (#2022)
- Use PgBouncer 1.19 by default (#2018)
Technical enhancements:
- Updated k8s kind tested versions (#2054)
- Use separate transactions to reconcile role credentials. Before this patch, the operator would revert the synchronization of all roles if one failed (#2004)
- Ensure fencing is removed during cluster restore (#1987)
- Improve logging when deleting Pods (#2136)
Fixes:
- Fix unbound variable with k3s engine which could prevent setup on K3’s (#2157)
- Report the correct PG version in the metrics (#2126)
- Use the correct walStorage key in the documentation (#2140)
- Halt reconciliation when the operator cannot connect with the instances, and provide a clear diagnostic on such occasions. This will help clarify cases where network issues obstruct normal operation of EDB Postgres for Kubernetes (#2145), (#2233), and (#2242)
v1.19.2
Release date: April 27, 2023
Enhancements:
- Improve the
--logs
option of thereport
command of thecnp
plugin forkubectl
to also include the previous logs where available (#1811) - The
-any
service is now disabled by default (#1755)
Security:
- Enable customization of
SeccompProfile
through override via a local file (#1827)
Fixes:
- Apply the PostgreSQL configuration provided by the user during the
initdb
bootstrap phase, before the server is started the first time (#1858)
v1.19.1
Release date: March 20, 2023
Enhancements:
- Allow overriding the default backup target policy (#1602): previously, all backups and scheduled backups would use the cluster-level target policy
- Extend the
debug
cluster's log level to theinitdb
job (#1503) - Support IPv6 and custom
pg_hba
for the PgBouncer pooler (#1395) - Enhance observability of backups with two new metrics and additional information in the status (#1428)
- Document API calls from the instance manager (#1641)
- Clarify deployment name via Helm (#1505)
- Add the
psql
command to thecnp
plugin forkubectl
(#1668) allowing the user to start apsql
session with a pod (the primary by default)
Technical enhancements:
- Adopt Renovate for dependency tracking/updating (#1367, #1473)
- Inject binaries for all supported architectures in the operator image (#1513)
- Use the backup name to match resources in the backup object store (#1650) Leverages the
--name
option introduced with Barman 3.3 to make the association betwen backups and the object store more robust.
Fixes:
- Prevent panic with error handling in the probes (#1716)
- Ensure that the HTTP package and controller runtime logs are in JSON format (#1442)
- Adds WAL storage to a cluster in a single instance Cluster (#1570)
- Various improvements to make backup code more robust (#1536, #1564, #1588, #1466, #1647)
- Properly show WAL archiving information with
status
command of thecnp
plugin (#1666) - Ensure
nodeAffinity
is applied even ifAdditionalPodAffinity
andAdditionalPodAntiAffinity
are not set (#1663) - Introduce failover delay during OnlineUpgrading phase (#1728) Previously, the online upgrade process could trigger failover logic unnecessarily.
v1.19.0
Release date: Feb 14, 2023
Important announcements:
- PostgreSQL version 10 is no longer supported as it has reached its EOL. Versions 11 and newer are supported. Please plan your migration to PostgreSQL 15 as soon as possible. Refer to "Importing Postgres databases" for more information on PostgreSQL major offline upgrades.
Features:
- Backup from a standby: introduce the
.spec.backup.target
option accepting that when set toprefer-standby
will run take the physical base backup from the most aligned replica (#1162) - Delayed failover: introduce the
failoverDelay
parameter to delay the failover process once the primary has been detected unhealthy (#1366)
Enhancements:
- Introduce support for Kubernetes' projected volumes (#1269)
- Introduce support custom environment variables for finer control of the PostgreSQL server process (#1275)
- Introduce the
backup
command in thecnp
plugin forkubectl
to issue a new base backup of the cluster (#1348) - Improve support for the separate WAL volume feature by enabling users to move WAL files to a dedicated volume on an existing Postgres cluster (#1066)
- Enhance WAL observability with additional metrics for the Prometheus exporter, including values equivalent to the
min_wal_size
,max_wal_size
,keep_wal_size
,wal_keep_segments
, as well as the maximum number of WALs that can be stored in the dedicated volume (#1382) - Add a database comment on the
streaming_replica
user (#1349) - Document the firewall issues with webhooks on GKE (#1364)
- Add note about postgresql.conf in
recovery
(#1211) - Add instructions on installing plugin using packages (#1357)
- Specify Postgres versions supported by each minor release (#1355)
- Clarify the meaning of PVC group in EDB Postgres for Kubernetes (#1344)
- Add an example of the DigitalOcean S3-compatible Spaces (#1289)
- Update default PostgreSQL version for new cluster definitions to 15.2 (#1430)
- Cover the Kubernetes layer in greater detail in the Architecture documentation (#1432)
Technical enhancements:
- Added daily end-to-end smoke test for release branches (#1235)
Fixes:
- Skip executing a
CHECKPOINT
as thestreaming_replica
user (#1408) - Make
waitForWalArchiveWorking
resilient to connection errors (#1399) - Ensure that the PVC roles are always consistent (#1380)
- Permit
walStorage
resize when usingpvcTemplate
(#1315) - Ensure
ExecCommand
obeys timeout (#1242) - Avoid
PodMonitor
reconcile if Prometheus is not installed (#1238) - Avoid looking for
PodMonitor
when not needed (#1213)
v1.18.13
Release date: Jun 13, 2024
!!! Warning This is expected to be the last release in the 1.18.X series. Users are encouraged to update to a newer minor version soon.
Enhancements:
- Enabled the configuration of the liveness probe timeout via the
.spec.livenessProbeTimeout
option (#4719)
Fixes:
-
Prevented fenced instances from entering an unnecessary loop and consuming all available CPU (#4625)
-
Resolved an issue where the instance manager on the primary would indefinitely wait for the instance to start after encountering a failure following a stop operation (#4434)
-
Fixed a panic in the backup controller that occurred when pod container statuses were missing (#4765)
-
Prevented unnecessary shutdown of the instance manager (#4670)
-
Prevented unnecessary reloads of PostgreSQL configuration when unchanged (#4531)
-
Prevented unnecessary reloads of the ident map by ensuring a consistent and unique method of writing its content (#4648)
-
Avoided conflicts during phase registration by patching the status of the resource instead of updating it (#4637)
-
Implemented a timeout when restarting PostgreSQL and lifting fencing (#4504)
-
Ensured that a replica cluster is restarted after promotion to properly set the archive mode (#4399)
-
Ensured correct parsing of the additional rows field returned when the
pgaudit.log_rows
option was enabled, preventing audit logs from being incorrectly routed to the normal log stream (#4394)
Changes
- Default operand image set to PostgreSQL 16.3 (#4584)
- Removed all RBAC requirements on namespace objects (#4753)
v1.18.12
Release date: Apr 18, 2024
Enhancements
– Upgrade process from 1.18.x LTS to 1.22.x LTS (#702,#683,#676) – Documentation for Kubernetes 1.29.x or above (#3729)
Fixes
– Properly handle LSN sorting when is empty on a replica (#4283) – Avoid stopping reconciliation loop when there is no instance status available (#4132) – Wait for elected replica to be in streaming mode before a switchover (#4288) – Allow backup hooks to be called while using Velero backup (#655) – Wait for the Restic init container to be completed (#670) – Ensure pods with no ownership are deleted during cluster restore (#4141)
Security
– Update all Go dependencies to fix any latest security issue (#700)
v1.18.11
Release date: Mar 22, 2024
Enhancements
- Allow customization of the
wal_level
GUC in PostgreSQL (#4020) - Add the
cnpg.io/skipWalArchiving
annotation to disable WAL archiving when set toenabled
(#4055) - Enrich the
cnpg
plugin forkubectl
with thepublication
andsubscription
command groups to imperatively set up PostgreSQL native logical replication (#4052) - Allow customization of
CERTIFICATE_DURATION
andEXPIRING_CHECK_THRESHOLD
for automated management of TLS certificates handled by the operator (#3686) - Retrieve the correct architecture's binary from the corresponding catalog in the running operator image during in-place updates, enabling the operator to inject the correct binary into any Pod with a supported architecture (#3840)
Fixes
- Properly synchronize PVC group labels with those on the pods, a critical aspect when all pods are deleted and the operator needs to decide which Pod to recreate first (#3930)
- Disable
wal_sender_timeout
when cloning a replica to prevent timeout errors due to slow connections (#4080) - Ensure backup are ready before initiating recovery bootstrap procedures, preventing an error condition where recovery with incomplete backups could enter an error loop (#3663)
- Resolve a corner case in hibernation where the instance pod has been deleted, but the cluster status still has the hibernation condition set to false (#3970)
- Correctly detect Google Cloud capabilities for Barman Cloud (#3931)
Security
- Use
Role
instead ofClusterRole
for operator permissions in OLM, requiring fewer privileges when installed on a per-namespace basis (#3855, #3990) - Enforce fully-qualified object names in SQL queries for the PgBouncer pooler (#4080)
Changes
- Set the default operand image to PostgreSQL 16.2 (#3823).
v1.18.10
Release date: Feb 2, 2024
Enhancements:
- Tailor ephemeral volume storage in a Postgres cluster using a claim template through the
ephemeralVolumeSource
option (#3678) - Introduce the
pgadmin4
command in thecnp
plugin forkubectl
, providing a straightforward method to demonstrate connecting to a given database cluster and navigate its content in a local environment such as kind - for evaluation purposes only (#3701) - Allow customization of PostgreSQL's ident map file via the
.spec.postgresql.pg_ident
stanza, through a list of user name maps (#3534)
Fixes:
- Prevent an unrecoverable issue with
pg_rewind
failing due topostgresql.auto.conf
being read-only on clusters where theALTER SYSTEM
SQL command is disabled - the default (#3728) - Reduce the risk of disk space shortage when using the import facility of the
initdb
bootstrap method, by disabling the durability settings in the PostgreSQL instance for the duration of the import process (#3743) - Avoid pod restart due to erroneous resource quantity comparisons, e.g. "1 != 1000m" (#3706)
- Properly escape reserved characters in
pgpass
connection fields (#3713) - Prevent systematic rollout of pods due to considering zero and nil different values in
.spec.projectedVolumeTemplate.sources
(#3647) - Ensure configuration coherence by pruning from
postgresql.auto.conf
any options now incorporated intooverride.conf
(#3773)