cluster [Required]
-core/v1.LocalObjectReference
+core/v1.LocalObjectReference
The name of the PostgreSQL cluster that identifies the "subscriber"
diff --git a/assets/documentation/1.26/cluster_conf/index.html b/assets/documentation/1.26/cluster_conf/index.html
index c43f11816..2a16e52b1 100644
--- a/assets/documentation/1.26/cluster_conf/index.html
+++ b/assets/documentation/1.26/cluster_conf/index.html
@@ -5,7 +5,7 @@
- Instance pod configuration - CloudNativePG v1.26
+ Instance Pod configuration - CloudNativePG v1.26
@@ -13,7 +13,7 @@
@@ -45,7 +45,7 @@
@@ -312,7 +312,7 @@
- Instance pod configuration
+ Instance Pod configuration
@@ -321,7 +321,7 @@
-
Instance pod configuration
+
Instance Pod configuration
Projected volumes
diff --git a/assets/documentation/1.26/cncf-projects/cilium/index.html b/assets/documentation/1.26/cncf-projects/cilium/index.html
index e36623307..f024a71b7 100644
--- a/assets/documentation/1.26/cncf-projects/cilium/index.html
+++ b/assets/documentation/1.26/cncf-projects/cilium/index.html
@@ -45,7 +45,7 @@
diff --git a/assets/documentation/1.26/cncf-projects/external-secrets/index.html b/assets/documentation/1.26/cncf-projects/external-secrets/index.html
index 36eecf841..ad9e6030c 100644
--- a/assets/documentation/1.26/cncf-projects/external-secrets/index.html
+++ b/assets/documentation/1.26/cncf-projects/external-secrets/index.html
@@ -45,7 +45,7 @@
diff --git a/assets/documentation/1.26/cnpg_i/index.html b/assets/documentation/1.26/cnpg_i/index.html
index 9366f213f..7f5ca1552 100644
--- a/assets/documentation/1.26/cnpg_i/index.html
+++ b/assets/documentation/1.26/cnpg_i/index.html
@@ -45,7 +45,7 @@
@@ -465,6 +469,27 @@
Configuring TLS Certificates
You can provide your own certificate bundles, but the recommended method is
to use Cert-manager .
+
Customizing the Certificate DNS Name
+
By default, CloudNativePG uses the Service name as the server name for TLS
+verification when connecting to the plugin. If your environment requires the
+certificate to have a different DNS name (e.g., barman-cloud.svc), you can
+customize it using the cnpg.io/pluginServerName annotation:
+
apiVersion: v1
+kind: Service
+metadata:
+ annotations:
+ cnpg.io/pluginClientSecret: cnpg-i-plugin-example-client-tls
+ cnpg.io/pluginServerSecret: cnpg-i-plugin-example-server-tls
+ cnpg.io/pluginPort: "9090"
+ cnpg.io/pluginServerName: barman-cloud.svc
+ name: barman-cloud
+ namespace: postgresql-operator-system
+spec:
+ [...]
+
+
This allows the operator to verify the plugin's certificate against the
+specified DNS name instead of the default Service name. The server certificate
+must include this DNS name in its Subject Alternative Names (SAN).
Using a plugin
To enable a plugin, configure the .spec.plugins section in your Cluster
resource. Refer to the CloudNativePG API Reference for the full
diff --git a/assets/documentation/1.26/connection_pooling/index.html b/assets/documentation/1.26/connection_pooling/index.html
index 87b26ecad..2199ef5fa 100644
--- a/assets/documentation/1.26/connection_pooling/index.html
+++ b/assets/documentation/1.26/connection_pooling/index.html
@@ -5,7 +5,7 @@
-
Connection pooling - CloudNativePG v1.26
+
Connection Pooling - CloudNativePG v1.26
@@ -13,7 +13,7 @@
@@ -45,7 +45,7 @@
@@ -340,7 +340,7 @@
- Connection pooling
+ Connection Pooling
diff --git a/assets/documentation/1.26/container_images/index.html b/assets/documentation/1.26/container_images/index.html
index cdcc5f0f3..a2e41b3c0 100644
--- a/assets/documentation/1.26/container_images/index.html
+++ b/assets/documentation/1.26/container_images/index.html
@@ -45,7 +45,7 @@
diff --git a/assets/documentation/1.26/controller/index.html b/assets/documentation/1.26/controller/index.html
index 907da3df1..7d19205e9 100644
--- a/assets/documentation/1.26/controller/index.html
+++ b/assets/documentation/1.26/controller/index.html
@@ -45,7 +45,7 @@
diff --git a/assets/documentation/1.26/database_import/index.html b/assets/documentation/1.26/database_import/index.html
index c53d46b2d..a83acf5a3 100644
--- a/assets/documentation/1.26/database_import/index.html
+++ b/assets/documentation/1.26/database_import/index.html
@@ -45,7 +45,7 @@
diff --git a/assets/documentation/1.26/declarative_database_management/index.html b/assets/documentation/1.26/declarative_database_management/index.html
index e75bbe620..066fd9675 100644
--- a/assets/documentation/1.26/declarative_database_management/index.html
+++ b/assets/documentation/1.26/declarative_database_management/index.html
@@ -5,7 +5,7 @@
- PostgreSQL Database Management - CloudNativePG v1.26
+ PostgreSQL Database management - CloudNativePG v1.26
@@ -13,7 +13,7 @@
@@ -45,7 +45,7 @@
@@ -342,7 +342,7 @@
- PostgreSQL Database Management
+ PostgreSQL Database management
@@ -351,7 +351,7 @@
-
PostgreSQL Database Management
+
PostgreSQL Database management
CloudNativePG simplifies PostgreSQL database provisioning by automatically
@@ -629,7 +629,7 @@
Manual Changes
diff --git a/assets/documentation/1.26/declarative_hibernation/index.html b/assets/documentation/1.26/declarative_hibernation/index.html
index 854caa5a5..45ede8230 100644
--- a/assets/documentation/1.26/declarative_hibernation/index.html
+++ b/assets/documentation/1.26/declarative_hibernation/index.html
@@ -45,7 +45,7 @@
@@ -351,7 +351,7 @@ Hibernation
Cluster Summary
Name: cluster-example
Namespace: default
-PostgreSQL Image: ghcr.io/cloudnative-pg/postgresql:18.0-system-trixie
+PostgreSQL Image: ghcr.io/cloudnative-pg/postgresql:18.1-system-trixie
Primary instance: cluster-example-2
Status: Cluster in healthy state
Instances: 3
diff --git a/assets/documentation/1.26/declarative_role_management/index.html b/assets/documentation/1.26/declarative_role_management/index.html
index d9b0df7bd..fc1af2358 100644
--- a/assets/documentation/1.26/declarative_role_management/index.html
+++ b/assets/documentation/1.26/declarative_role_management/index.html
@@ -5,7 +5,7 @@
- PostgreSQL Role Management - CloudNativePG v1.26
+ PostgreSQL Role management - CloudNativePG v1.26
@@ -13,7 +13,7 @@
@@ -45,7 +45,7 @@
@@ -312,7 +312,7 @@
- PostgreSQL Role Management
+ PostgreSQL Role management
@@ -321,7 +321,7 @@
-
PostgreSQL Role Management
+
PostgreSQL Role management
From its inception, CloudNativePG has managed the creation of specific roles
@@ -539,7 +539,7 @@
Status of managed roles
diff --git a/assets/documentation/1.26/e2e/index.html b/assets/documentation/1.26/e2e/index.html
index d8a7fbef9..73f7ba523 100644
--- a/assets/documentation/1.26/e2e/index.html
+++ b/assets/documentation/1.26/e2e/index.html
@@ -45,7 +45,7 @@
diff --git a/assets/documentation/1.26/failover/index.html b/assets/documentation/1.26/failover/index.html
index 5fe304117..a1ed32a7d 100644
--- a/assets/documentation/1.26/failover/index.html
+++ b/assets/documentation/1.26/failover/index.html
@@ -45,7 +45,7 @@
diff --git a/assets/documentation/1.26/failure_modes/index.html b/assets/documentation/1.26/failure_modes/index.html
index 9fb9de3f6..d230998ad 100644
--- a/assets/documentation/1.26/failure_modes/index.html
+++ b/assets/documentation/1.26/failure_modes/index.html
@@ -45,7 +45,7 @@
@@ -394,7 +394,7 @@ Disabling Reconciliation
diff --git a/assets/documentation/1.26/faq/index.html b/assets/documentation/1.26/faq/index.html
index 65409f79b..6b8a09974 100644
--- a/assets/documentation/1.26/faq/index.html
+++ b/assets/documentation/1.26/faq/index.html
@@ -45,7 +45,7 @@
diff --git a/assets/documentation/1.26/fencing/index.html b/assets/documentation/1.26/fencing/index.html
index c0106cc76..5252cd37e 100644
--- a/assets/documentation/1.26/fencing/index.html
+++ b/assets/documentation/1.26/fencing/index.html
@@ -45,7 +45,7 @@
diff --git a/assets/documentation/1.26/image_catalog/index.html b/assets/documentation/1.26/image_catalog/index.html
index e8f2be61f..2454b8e4d 100644
--- a/assets/documentation/1.26/image_catalog/index.html
+++ b/assets/documentation/1.26/image_catalog/index.html
@@ -45,7 +45,7 @@
apiVersion: postgresql.cnpg.io/v1
@@ -361,7 +361,7 @@ Image Catalog
- major: 17
image: ghcr.io/cloudnative-pg/postgresql:17.6-system-trixie
- major: 18
- image: ghcr.io/cloudnative-pg/postgresql:18.0-system-trixie
+ image: ghcr.io/cloudnative-pg/postgresql:18.1-system-trixie
A Cluster resource has the flexibility to reference either an ImageCatalog
(like in the following example) or a ClusterImageCatalog to precisely specify
diff --git a/assets/documentation/1.26/index.html b/assets/documentation/1.26/index.html
index 154dc73d4..f66cb1ac4 100644
--- a/assets/documentation/1.26/index.html
+++ b/assets/documentation/1.26/index.html
@@ -61,7 +61,7 @@
@@ -402,7 +402,7 @@ Operands
want to plan a future migration to minimal or standard images with the
Barman Cloud plugin, or another supported backup solution.
-
By default, this version of CloudNativePG deploys ghcr.io/cloudnative-pg/postgresql:18.0-system-trixie.
+
By default, this version of CloudNativePG deploys ghcr.io/cloudnative-pg/postgresql:18.1-system-trixie.
All images are signed and shipped with SBOM and provenance attestations.
Weekly automated builds ensure that critical vulnerabilities (CVEs) are promptly fixed.
For details and support, see the postgres-containers project .
@@ -525,7 +525,7 @@
About this guide
@@ -570,5 +570,5 @@ About this guide
diff --git a/assets/documentation/1.26/installation_upgrade/index.html b/assets/documentation/1.26/installation_upgrade/index.html
index 2cbf2dd0e..5cfe578ab 100644
--- a/assets/documentation/1.26/installation_upgrade/index.html
+++ b/assets/documentation/1.26/installation_upgrade/index.html
@@ -45,7 +45,7 @@
@@ -358,10 +358,10 @@ Installation on Kubernetes
Directly using the operator manifest
The operator can be installed like any other resource in Kubernetes,
through a YAML manifest applied via kubectl.
-You can install the latest operator manifest
+
You can install the latest operator manifest
for this minor release as follows:
kubectl apply --server-side -f \
- https://raw.githubusercontent.com/cloudnative-pg/cloudnative-pg/release-1.26/releases/cnpg-1.26.2.yaml
+ https://raw.githubusercontent.com/cloudnative-pg/cloudnative-pg/release-1.26/releases/cnpg-1.26.3.yaml
You can verify that with:
kubectl rollout status deployment \
diff --git a/assets/documentation/1.26/instance_manager/index.html b/assets/documentation/1.26/instance_manager/index.html
index 896f09b03..682ed23ef 100644
--- a/assets/documentation/1.26/instance_manager/index.html
+++ b/assets/documentation/1.26/instance_manager/index.html
@@ -5,7 +5,7 @@
- Postgres instance manager - CloudNativePG v1.26
+ Postgres Instance Manager - CloudNativePG v1.26
@@ -13,7 +13,7 @@
@@ -45,7 +45,7 @@
@@ -328,7 +328,7 @@
- Postgres instance manager
+ Postgres Instance Manager
diff --git a/assets/documentation/1.26/kubectl-plugin/index.html b/assets/documentation/1.26/kubectl-plugin/index.html
index 7e5ba2eae..102ae3bdf 100644
--- a/assets/documentation/1.26/kubectl-plugin/index.html
+++ b/assets/documentation/1.26/kubectl-plugin/index.html
@@ -45,7 +45,7 @@
@@ -434,9 +434,9 @@ Using the Debian or RedHat packages
As a result, you can follow standard practices and instructions to install
them in your systems.
Debian packages
- For example, let's install the 1.26.2 release of the plugin, for an Intel based
+
For example, let's install the 1.26.3 release of the plugin, for an Intel based
64 bit server. First, we download the right .deb file.
- wget https://github.com/cloudnative-pg/cloudnative-pg/releases/download/v1.26.2/kubectl-cnpg_1.26.2_linux_x86_64.deb \
+wget https://github.com/cloudnative-pg/cloudnative-pg/releases/download/v1.26.3/kubectl-cnpg_1.26.3_linux_x86_64.deb \
--output-document kube-plugin.deb
Then, with superuser privileges, install from the local file using dpkg:
@@ -444,13 +444,13 @@ Debian packages
Selecting previously unselected package cnpg.
(Reading database ... 6688 files and directories currently installed.)
Preparing to unpack kube-plugin.deb ...
-Unpacking cnpg (1.26.2) ...
-Setting up cnpg (1.26.2) ...
+Unpacking cnpg (1.26.3) ...
+Setting up cnpg (1.26.3) ...
RPM packages
-
As in the example for .rpm packages, let's install the 1.26.2 release for an
+
As in the example for .rpm packages, let's install the 1.26.3 release for an
Intel 64 bit machine. Note the --output flag to provide a file name.
-
curl -L https://github.com/cloudnative-pg/cloudnative-pg/releases/download/v1.26.2/kubectl-cnpg_1.26.2_linux_x86_64.rpm \
+curl -L https://github.com/cloudnative-pg/cloudnative-pg/releases/download/v1.26.3/kubectl-cnpg_1.26.3_linux_x86_64.rpm \
--output kube-plugin.rpm
Then, with superuser privileges, install with yum, and you're ready to use:
@@ -461,7 +461,7 @@ RPM packages
Package Architecture Version Repository Size
====================================================================================================
Installing:
- cnpg x86_64 1.26.2 @commandline 20 M
+ cnpg x86_64 1.26.3 @commandline 20 M
Transaction Summary
====================================================================================================
@@ -652,9 +652,9 @@ Status
Instances status
Name Current LSN Replication role Status QoS Manager Version Node
---- ----------- ---------------- ------ --- --------------- ----
-sandbox-1 0/604DE38 Primary OK BestEffort 1.26.2 k8s-eu-worker
-sandbox-2 0/604DE38 Standby (async) OK BestEffort 1.26.2 k8s-eu-worker2
-sandbox-3 0/604DE38 Standby (async) OK BestEffort 1.26.2 k8s-eu-worker
+sandbox-1 0/604DE38 Primary OK BestEffort 1.26.3 k8s-eu-worker
+sandbox-2 0/604DE38 Standby (async) OK BestEffort 1.26.3 k8s-eu-worker2
+sandbox-3 0/604DE38 Standby (async) OK BestEffort 1.26.3 k8s-eu-worker
If you require more detailed status information, use the --verbose option (or
-v for short). The level of detail increases each time the flag is repeated:
@@ -703,9 +703,9 @@
Status
Instances status
Name Current LSN Replication role Status QoS Manager Version Node
---- ----------- ---------------- ------ --- --------------- ----
-sandbox-1 0/6053720 Primary OK BestEffort 1.26.2 k8s-eu-worker
-sandbox-2 0/6053720 Standby (async) OK BestEffort 1.26.2 k8s-eu-worker2
-sandbox-3 0/6053720 Standby (async) OK BestEffort 1.26.2 k8s-eu-worker
+sandbox-1 0/6053720 Primary OK BestEffort 1.26.3 k8s-eu-worker
+sandbox-2 0/6053720 Standby (async) OK BestEffort 1.26.3 k8s-eu-worker2
+sandbox-3 0/6053720 Standby (async) OK BestEffort 1.26.3 k8s-eu-worker
With an additional -v (e.g. kubectl cnpg status sandbox -v -v), you can
also view PostgreSQL configuration, HBA settings, and certificates.
@@ -873,12 +873,12 @@
report Operator
and previous logs are available, it will show them both.
====== Beginning of Previous Log =====
-2023-03-28T12:56:41.251711811Z {"level":"info","ts":"2023-03-28T12:56:41Z","logger":"setup","msg":"Starting CloudNativePG Operator","version":"1.26.2","build":{"Version":"1.26.2+dev107","Commit":"cc9bab17","Date":"2023-03-28"}}
+2023-03-28T12:56:41.251711811Z {"level":"info","ts":"2023-03-28T12:56:41Z","logger":"setup","msg":"Starting CloudNativePG Operator","version":"1.26.3","build":{"Version":"1.26.3+dev107","Commit":"cc9bab17","Date":"2023-03-28"}}
2023-03-28T12:56:41.251851909Z {"level":"info","ts":"2023-03-28T12:56:41Z","logger":"setup","msg":"Starting pprof HTTP server","addr":"0.0.0.0:6060"}
<snipped …>
====== End of Previous Log =====
-2023-03-28T12:57:09.854306024Z {"level":"info","ts":"2023-03-28T12:57:09Z","logger":"setup","msg":"Starting CloudNativePG Operator","version":"1.26.2","build":{"Version":"1.26.2+dev107","Commit":"cc9bab17","Date":"2023-03-28"}}
+2023-03-28T12:57:09.854306024Z {"level":"info","ts":"2023-03-28T12:57:09Z","logger":"setup","msg":"Starting CloudNativePG Operator","version":"1.26.3","build":{"Version":"1.26.3+dev107","Commit":"cc9bab17","Date":"2023-03-28"}}
2023-03-28T12:57:09.854363943Z {"level":"info","ts":"2023-03-28T12:57:09Z","logger":"setup","msg":"Starting pprof HTTP server","addr":"0.0.0.0:6060"}
If the operator hasn't been restarted, you'll still see the ====== Begin …
@@ -1178,7 +1178,7 @@
Launching psql
$ kubectl cnpg psql cluster-example
-psql (18.0 (Debian 18.0-1.pgdg110+1))
+psql (18.1 (Debian 18.1-1.pgdg110+1))
Type "help" for help.
postgres=#
@@ -1187,7 +1187,7 @@ Launching psql
select to work against a replica by using the --replica option:
$ kubectl cnpg psql --replica cluster-example
-psql (18.0 (Debian 18.0-1.pgdg110+1))
+psql (18.1 (Debian 18.1-1.pgdg110+1))
Type "help" for help.
@@ -1647,7 +1647,7 @@ Role examples
diff --git a/assets/documentation/1.26/kubernetes_upgrade/index.html b/assets/documentation/1.26/kubernetes_upgrade/index.html
index 8fd44d890..c8eb71621 100644
--- a/assets/documentation/1.26/kubernetes_upgrade/index.html
+++ b/assets/documentation/1.26/kubernetes_upgrade/index.html
@@ -5,7 +5,7 @@
- Kubernetes Upgrade and Maintenance - CloudNativePG v1.26
+ Kubernetes upgrade and maintenance - CloudNativePG v1.26
@@ -13,7 +13,7 @@
@@ -45,7 +45,7 @@
@@ -316,7 +316,7 @@
- Kubernetes Upgrade and Maintenance
+ Kubernetes upgrade and maintenance
@@ -325,7 +325,7 @@
-
Kubernetes Upgrade and Maintenance
+
Kubernetes upgrade and maintenance
Maintaining an up-to-date Kubernetes cluster is crucial for ensuring optimal
@@ -498,7 +498,7 @@
Single instance clu
diff --git a/assets/documentation/1.26/labels_annotations/index.html b/assets/documentation/1.26/labels_annotations/index.html
index 201f05153..78ba17986 100644
--- a/assets/documentation/1.26/labels_annotations/index.html
+++ b/assets/documentation/1.26/labels_annotations/index.html
@@ -5,7 +5,7 @@
- Labels and annotations - CloudNativePG v1.26
+ Labels and Annotations - CloudNativePG v1.26
@@ -13,7 +13,7 @@
@@ -45,7 +45,7 @@
@@ -310,7 +310,7 @@
- Labels and annotations
+ Labels and Annotations
@@ -319,7 +319,7 @@
-
Labels and annotations
+
Labels and Annotations
Resources in Kubernetes are organized in a flat structure, with no hierarchical
diff --git a/assets/documentation/1.26/logging/index.html b/assets/documentation/1.26/logging/index.html
index 62f414db3..bdee9a4f2 100644
--- a/assets/documentation/1.26/logging/index.html
+++ b/assets/documentation/1.26/logging/index.html
@@ -45,7 +45,7 @@
diff --git a/assets/documentation/1.26/logical_replication/index.html b/assets/documentation/1.26/logical_replication/index.html
index 70bbe3bb2..537aa7629 100644
--- a/assets/documentation/1.26/logical_replication/index.html
+++ b/assets/documentation/1.26/logical_replication/index.html
@@ -45,7 +45,7 @@
@@ -109,6 +109,8 @@
@@ -416,14 +418,41 @@ Publications
It includes all tables (spec.target.allTables: true) from the app
database (spec.dbname).
+Fine-grained control over publication tables
+While the allTables option provides a convenient way to replicate all tables
+in a database, PostgreSQL version 15 and later introduce enhanced flexibility
+through the CREATE PUBLICATION
+command. This allows you to precisely define which tables, or even which types
+of data changes, should be included in a publication.
Important
-
While allTables simplifies configuration, PostgreSQL offers fine-grained
-control for replicating specific tables or targeted data changes. For advanced
-configurations, consult the PostgreSQL documentation .
-Additionally, refer to the CloudNativePG API reference
-for details on declaratively customizing replication targets.
+
If you are using PostgreSQL versions earlier than 15, review the syntax and
+options available for CREATE PUBLICATION in your specific release. Some
+parameters and features may not be supported.
+For complex or tailored replication setups, refer to the
+PostgreSQL logical replication documentation .
+Additionally, refer to the CloudNativePG API reference
+for details on declaratively customizing replication targets.
+The following example defines a publication that replicates all tables in the
+portal schema of the app database, along with the users table from the
+access schema:
+ apiVersion: postgresql.cnpg.io/v1
+kind: Publication
+metadata:
+ name: publisher
+spec:
+ cluster:
+ name: freddie
+ dbname: app
+ name: publisher
+ target:
+ objects:
+ - tablesInSchema: portal
+ - table:
+ name: users
+ schema: access
+
Required Fields in the Publication Manifest
The following fields are required for a Publication object:
@@ -636,7 +665,7 @@ Step 1: Setting Up the Publishe
spec:
instances: 1
- imageName: ghcr.io/cloudnative-pg/postgresql:16
+ imageName: ghcr.io/cloudnative-pg/postgresql:16-standard-trixie
storage:
size: 1Gi
@@ -680,6 +709,8 @@ Step 2: Setting Up the Subscriber
spec:
instances: 1
+ imageName: ghcr.io/cloudnative-pg/postgresql:18-standard-trixie
+
storage:
size: 1Gi
diff --git a/assets/documentation/1.26/monitoring/index.html b/assets/documentation/1.26/monitoring/index.html
index 2dc9b41da..8047efac8 100644
--- a/assets/documentation/1.26/monitoring/index.html
+++ b/assets/documentation/1.26/monitoring/index.html
@@ -45,7 +45,7 @@
@@ -379,7 +379,7 @@ Monitoring Instances
Important
CloudNativePG, by default, installs a set of predefined metrics
-in a ConfigMap named default-monitoring.
+in a
ConfigMap named
cnpg-default-monitoring.
Info
@@ -583,7 +583,7 @@
Predefined set of metrics
# HELP cnpg_collector_postgres_version Postgres version
# TYPE cnpg_collector_postgres_version gauge
-cnpg_collector_postgres_version{cluster="cluster-example",full="18.0"} 18.0
+cnpg_collector_postgres_version{cluster="cluster-example",full="18.1"} 18.1
# HELP cnpg_collector_last_failed_backup_timestamp The last failed backup as a unix timestamp (Deprecated)
# TYPE cnpg_collector_last_failed_backup_timestamp gauge
@@ -1132,7 +1132,7 @@
Using curl
spec:
containers:
- name: curl
- image: curlimages/curl:8.16.0
+ image: curlimages/curl:8.17.0
command: ['sleep', '3600']
EOF
@@ -1194,7 +1194,7 @@
Auxiliary resources