Releases: EnterpriseDB/kubectl-cnp
v1.18.9
Release date: Dec 22, 2023
Security
- By default, TLSv1.3 is now enforced on all PostgreSQL 12 or higher installations. Additionally, users can configure the
ssl_ciphers
,ssl_min_protocol_version
, andssl_max_protocol_version
GUCs (#3408). - Integration of Docker image scanning with Dockle to enhance security measures.
Enhancements
- Improved reconciliation of external clusters (#3533).
- Introduction of the ability to enable/disable the
ALTER SYSTEM
command (#3535). - Support for Prometheus' dynamic relabeling through the
podMonitorMetricRelabelings
andpodMonitorRelabelings
options in the.spec.monitoring
stanza of theCluster
andPooler
resources (#3075). - Elimination of the use of the
PGPASSFILE
environment variable when establishing a network connection to PostgreSQL (#3522). - Improved
cnp report
plugin command by collecting a cluster's PVCs (#3357). - Connection pooler:
- Scaling down instances of a
Pooler
resource to 0 is now possible (#3517). - Addition of the
k8s.enterprisedb.io/podRole
label with a value of 'pooler' to every pooler deployment, differentiating them from instance pods (#3396).
- Scaling down instances of a
Fixes
- Reconciliation of metadata, annotations, and labels of
PodDisruptionBudget
resources (#3312 and #3434). - Reconciliation of the metadata of the managed credential secrets (#3316).
- Disabling of wal_sender_timeout when joining through pg_basebackup (#3586)
- Reloading of secrets used by external clusters (#3565)
- Connection pooler:
- Ensuring the controller watches all secrets owned by a
Pooler
resource (#3428). - Reconciliation of
RoleBinding
forPooler
resources (#3391). - Reconciliation of
imagePullSecret
forPooler
resources (#3389). - Reconciliation of the service of a
Pooler
and addition of the required labels (#3349). - Extension of
Pooler
labels to the deployment as well, not just the pods (#3350).
- Ensuring the controller watches all secrets owned by a
Changes
- Default operand image set to PostgreSQL 16.1 (#3270).
v1.18.8
Release date: Nov 8, 2023
Enhancements:
- Enhance the
status
command of thecnp
plugin forkubectl
with progress information on active streaming base backups (#3101) - Allow the configuration of
max_prepared_statements
with the pgBouncerPooler
resource (#3174)
Fixes:
- Suspend WAL archiving during a switchover and resume it when it is completed (#3227)
- Ensure that the instance manager always uses
synchronous_commit = local
when managing the PostgreSQL cluster (#3143) - Custom certificates for streaming replication user through
.spec.certificates.replicationTLSSecret
are now working (#3209) - Set the
k8s.enterprisedb.io/cluster
label to thePooler
pods (#3153)
Changes:
- Stop using the
postgresql.auto.conf
file inside PGDATA to control Postgres replication settings, and replace it with a file namedoverride.conf
(#2812)
Technical enhancements:
- Use extended query protocol for PostgreSQL in the instance manager (#3152)
v1.18.7
Release date: Oct 18, 2023
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)
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) -
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)
- 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.18.6
Release date: July 27, 2023
Enhancements:
- Add a metric and status field to monitor node usage by a CloudNativePG 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)
- 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)
Security:
- Updated all project dependencies to the latest versions
Release 1.18.5
Release date: June 12, 2023
!!! Warning Version 1.18 has reached End-of-Life (EOL). Version 1.18.5 is the last that will be released for the 1.18 minor version.
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)
Release 1.18.4
Release date: April 27, 2023
!!! Warning Version 1.18 will reach its End-of-Life (EOL) on May 27, 2023. If you haven't upgraded yet, please start planning an upgrade as soon as possible.
!!! Important EDB Postgres for Kubernetes is dropping support for PostgreSQL 10, as PostgreSQL 10 reached End-of-Life (EOL) in November 2022. 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.
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.18.3
Release date: March 20, 2023
Enhancements:
- 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)
v1.18.2
Release date: Feb 14, 2023
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)
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.1
Release date: Dec 21, 2022
Important announcements:
- Alert on the impending deprecation of
postgresql
as a label to identify the CNP cluster. In the remote case you have used this label, please start using thek8s.enterprisedb.io/cluster
label instead (#1130) - Recognizing Armando Ruocco (@armru) as a new EDB Postgres for Kubernetes maintainer for his consistent and impactful contributions (#1167)
- Remove ARMv7 support (#1092)
- FINAL patch release for 1.16: 1.16.5. Release 1.16 reaches end of life.
Enhancements:
- Customize labels and annotations for the service account: add a service account template that can be used, for example, to make authentication easier via identity management on GKE or EKS via IRSA (#1105)
- Add
nodeAffinity
support (#1182) - allows for richer scheduling options - Improve compatibility with Istio: add support for Istio’s quit endpoint so that jobs with Istio sidecars do not run indefinitely (#967)
- Allow fields remapping in JSON logs: helpful for use cases where the
level
andts
fields might interfere with the existing logging (#843) - Add
fio
command to the kubectl-cnp plugin (#1097) - Add rpm/deb package for kubectl-cnp plugin (#1008)
- Update default PostgreSQL version for new cluster definitions to 15.1 (#908)
- Documentation
- Remove references to CNP sandbox (#1120) - the CNP sandbox has been deprecated, in favor of instructions on monitoring in the Quickstart documentation
- Link to the "Release updates" discussion (#1148) - the release updates discussion will become the default channel for release announcements and discussions
- Document emeritus status for maintainers in GOVERNANCE.md (#1033) - explains how maintainers should proceed if they are not ready to continue contributing
- Improve instructions on creating pull requests (#1132)
- Troubleshooting emergency backup instructions (#1184)
Fixes:
- Ensure PGDATA permissions on bootstrap are properly set to 750 (#1164)
- Ensure the PVC containing WALs is deleted when scaling down the cluster (#1135)
- Fix missing ApiVersion and Kind in the pgbench manifest when using
--dry-run
(#1088) - Ensure that we create secrets and services only when not found (#1145)
- Respect configured pg-wal when restoring (#1216)
- Filter out replicas from nodeToClusters map (#1194)
Technical enhancements:
- Use
ciclops
for test summary (#1064): rely on the ciclops GitHub action to provide summaries of the E2E suite, inheriting improvements from that project - Add backport pull request workflow (#965) - automatically backport patches to release branches if they are so annotated
- Make the operator log level configurable in e2e test suite (#1094)
- Enable test execution based on labels (#951)
- Update Go version from 1.18 to 1.19 (#1166)
v1.18.0
Release date: Nov 10, 2022
Features:
- Cluster-managed physical replication slots for High Availability: automatically manages physical replication slots for each hot standby replica in the High Availability cluster, both in the primary and the standby (#740)
- Postgres cluster hibernation: introduces cluster hibernation via the plugin, with a new subcommand
kubectl cnp hibernate on/off/status <cluster-name>
. Hibernation destroys all the resources generated by the cluster, except the PVCs that belong to the PostgreSQL primary instance (#782)
Security:
- Add
SeccomProfile
to Pods and Containers (#888)
Enhancements:
- Allow omitting the storage size in the cluster spec if there is a size request in the
pvcTemplate
(#914) status
command for thecnp
plugin:- Add replication slots information (#873)
- Clarify display for fenced clusters (#886)
- Improve display for replica clusters (#871)
- Documentation:
- Improve monitoring page, providing instructions on how to evaluate the observability capabilities of EDB Postgres for Kubernetes on a local system using Prometheus and Grafana (#968)
- Add page on design reasons for custom controller (#918)
- Updates to the End-to-End Test Suite page (#945)
- New subcommands in the
cnp
plugin:pgbench
generates a job definition executingpgbench
against a cluster (#958)install
generates an installation manifest for the operator (#944)
- Set PostgreSQL 15.0 as the new default version (#821)
Fixes:
- Import a database with
plpgsql
functions (#974) - Properly find the closest backup when doing Point-in-time recovery (#949)
- Clarify that the
ScheduledBackup
format does not follow KubernetesCronJob
format (#883) - Bases the failover logic on the Postgres information from the instance manager, rather than Kubernetes pod readiness, which could be stale (#890)
- Ensure we have a WAL to archive for every newly created cluster. The lack could prevent backups from working (#897)
- Correct YAML key names for
barmanObjectStore
in documentation (#877) - Fix
krew
release (#866)