From 2820f3ede58ec1f000632518eeb0498d97dbc5f3 Mon Sep 17 00:00:00 2001 From: Josh Heyer Date: Tue, 9 Dec 2025 05:35:25 +0000 Subject: [PATCH 1/2] Sync EnterpriseDB/cloud-native-postgres product/pg4k/v1.28.0-rc2 --- .../docs/postgres_for_kubernetes/1/index.mdx | 2 +- .../1/preview_version.mdx | 4 +- .../preview/backup.mdx | 2 +- .../preview/before_you_start.mdx | 2 +- .../preview/cluster_conf.mdx | 2 +- .../postgres_for_kubernetes/preview/cnp_i.mdx | 26 ++++ .../preview/connection_pooling.mdx | 2 +- .../declarative_database_management.mdx | 2 +- .../preview/declarative_role_management.mdx | 2 +- .../postgres_for_kubernetes/preview/index.mdx | 4 +- .../preview/installation_upgrade.mdx | 5 +- .../preview/instance_manager.mdx | 2 +- .../preview/kubectl-plugin.mdx | 30 ++--- .../preview/kubernetes_upgrade.mdx | 2 +- .../preview/labels_annotations.mdx | 2 +- .../preview/license_keys.mdx | 7 +- .../preview/monitoring.mdx | 2 +- .../preview/openshift.mdx | 7 +- .../preview/operator_conf.mdx | 3 +- .../preview/pg4k.v1/index.mdx | 114 +++++++++--------- .../{v1.28.0-rc1.mdx => v1.28.0-rc2.mdx} | 114 +++++++++--------- .../preview/postgis.mdx | 2 +- .../preview/postgres_upgrades.mdx | 2 +- .../preview/postgresql_conf.mdx | 21 ++-- .../preview/preview_version.mdx | 4 +- .../preview/private_edb_registries.mdx | 14 +-- .../preview/quickstart.mdx | 2 + ...rel_notes.mdx => 1_28_0-rc2_rel_notes.mdx} | 4 +- .../preview/rel_notes/index.mdx | 4 +- .../rel_notes/src/1.28.0_rel_notes.yml | 8 +- .../preview/replication.mdx | 2 +- .../preview/rolling_update.mdx | 2 +- .../preview/service_management.mdx | 2 +- 33 files changed, 214 insertions(+), 189 deletions(-) rename product_docs/docs/postgres_for_kubernetes/preview/pg4k.v1/{v1.28.0-rc1.mdx => v1.28.0-rc2.mdx} (98%) rename product_docs/docs/postgres_for_kubernetes/preview/rel_notes/{1_28_0-rc1_rel_notes.mdx => 1_28_0-rc2_rel_notes.mdx} (98%) diff --git a/product_docs/docs/postgres_for_kubernetes/1/index.mdx b/product_docs/docs/postgres_for_kubernetes/1/index.mdx index b7dc5f23dd..b180f54ee2 100644 --- a/product_docs/docs/postgres_for_kubernetes/1/index.mdx +++ b/product_docs/docs/postgres_for_kubernetes/1/index.mdx @@ -7,7 +7,7 @@ directoryDefaults: version: "1.27.1" displayBanner: | We're preparing the next release of {{name.ln}}, and a release candidate is available. - For more information, see the v1.28.0-rc1 documentation + For more information, see the v1.28.0-rc2 documentation navigation: - rel_notes - '!commercial_support.mdx' diff --git a/product_docs/docs/postgres_for_kubernetes/1/preview_version.mdx b/product_docs/docs/postgres_for_kubernetes/1/preview_version.mdx index 1c0abbc373..9b6f6c11af 100644 --- a/product_docs/docs/postgres_for_kubernetes/1/preview_version.mdx +++ b/product_docs/docs/postgres_for_kubernetes/1/preview_version.mdx @@ -38,9 +38,9 @@ are not backwards compatible and could be removed entirely. ## Current Preview Version -The current preview version is **1.28.0-rc1**. +The current preview version is **1.28.0-rc2**. For more information on the current preview version and how to test, please view the links below: -- [Announcement](/postgres_for_kubernetes/preview/rel_notes/1_28_0-rc1_rel_notes) +- [Announcement](/postgres_for_kubernetes/preview/rel_notes/1_28_0-rc2_rel_notes) - [Documentation](/postgres_for_kubernetes/preview/) diff --git a/product_docs/docs/postgres_for_kubernetes/preview/backup.mdx b/product_docs/docs/postgres_for_kubernetes/preview/backup.mdx index 60ed5e968f..d4f8535a37 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/backup.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/backup.mdx @@ -85,7 +85,7 @@ as they can simply rely on the WAL archive to synchronize across long distances, extending disaster recovery goals across different regions. When you [configure a WAL archive](wal_archiving.md), {{name.ln}} provides -out-of-the-box an [RPO](before_you_start.md#rpo) <= 5 minutes for disaster +out-of-the-box an [RPO](before_you_start.md#rpo) ≤ 5 minutes for disaster recovery, even across regions. !!! Important diff --git a/product_docs/docs/postgres_for_kubernetes/preview/before_you_start.mdx b/product_docs/docs/postgres_for_kubernetes/preview/before_you_start.mdx index 23ef332baa..6e22af47e7 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/before_you_start.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/before_you_start.mdx @@ -1,5 +1,5 @@ --- -title: 'Before You Start' +title: 'Before you start' originalFilePath: 'src/before_you_start.md' --- diff --git a/product_docs/docs/postgres_for_kubernetes/preview/cluster_conf.mdx b/product_docs/docs/postgres_for_kubernetes/preview/cluster_conf.mdx index 972c21eab7..b9ed7b08e4 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/cluster_conf.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/cluster_conf.mdx @@ -1,5 +1,5 @@ --- -title: 'Instance pod configuration' +title: 'Instance Pod configuration' originalFilePath: 'src/cluster_conf.md' --- diff --git a/product_docs/docs/postgres_for_kubernetes/preview/cnp_i.mdx b/product_docs/docs/postgres_for_kubernetes/preview/cnp_i.mdx index 755451a9dc..054661e5e0 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/cnp_i.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/cnp_i.mdx @@ -166,6 +166,32 @@ spec: You can provide your own certificate bundles, but the recommended method is to use [Cert-manager](https://cert-manager.io). +#### Customizing the Certificate DNS Name + +By default, {{name.ln}} 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 `k8s.enterprisedb.io/pluginServerName` annotation: + +```yaml +apiVersion: v1 +kind: Service +metadata: + annotations: + k8s.enterprisedb.io/pluginClientSecret: cnpg-i-plugin-example-client-tls + k8s.enterprisedb.io/pluginServerSecret: cnpg-i-plugin-example-server-tls + k8s.enterprisedb.io/pluginPort: "9090" + k8s.enterprisedb.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` diff --git a/product_docs/docs/postgres_for_kubernetes/preview/connection_pooling.mdx b/product_docs/docs/postgres_for_kubernetes/preview/connection_pooling.mdx index 6236cfe295..6784f7d03f 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/connection_pooling.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/connection_pooling.mdx @@ -1,5 +1,5 @@ --- -title: 'Connection pooling' +title: 'Connection Pooling' originalFilePath: 'src/connection_pooling.md' --- diff --git a/product_docs/docs/postgres_for_kubernetes/preview/declarative_database_management.mdx b/product_docs/docs/postgres_for_kubernetes/preview/declarative_database_management.mdx index dbb8fe9e66..276b1e0d75 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/declarative_database_management.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/declarative_database_management.mdx @@ -1,5 +1,5 @@ --- -title: 'PostgreSQL Database Management' +title: 'PostgreSQL Database management' originalFilePath: 'src/declarative_database_management.md' --- diff --git a/product_docs/docs/postgres_for_kubernetes/preview/declarative_role_management.mdx b/product_docs/docs/postgres_for_kubernetes/preview/declarative_role_management.mdx index 7615d372e4..f5c64d6b93 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/declarative_role_management.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/declarative_role_management.mdx @@ -1,5 +1,5 @@ --- -title: 'PostgreSQL Role Management' +title: 'PostgreSQL Role management' originalFilePath: 'src/declarative_role_management.md' --- diff --git a/product_docs/docs/postgres_for_kubernetes/preview/index.mdx b/product_docs/docs/postgres_for_kubernetes/preview/index.mdx index 029cf03852..e3209a144f 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/index.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/index.mdx @@ -4,7 +4,7 @@ description: The {{name.ln}} operator is a fork based on CloudNativePG™ which originalFilePath: src/index.md indexCards: none directoryDefaults: - version: "1.28.0-rc1" + version: "1.28.0-rc2" displayBanner: | This documentation covers the upcoming release of {{name.ln}}; you may want to read the docs for @@ -166,7 +166,7 @@ version for 12-18 months before upgrading. {{name.ln}} works with both PostgreSQL, EDB Postgres Extended and EDB Postgres Advanced server, and is available under the -[EDB Limited Use License](https://www.enterprisedb.com/limited-use-license). +[EDB End User License Agreement](https://www.enterprisedb.com/legal/EDB-Eula). You can [evaluate {{name.ln}} for free](evaluation.md) as part of a trial subscription. You need a valid EDB subscription to use {{name.ln}} in production. diff --git a/product_docs/docs/postgres_for_kubernetes/preview/installation_upgrade.mdx b/product_docs/docs/postgres_for_kubernetes/preview/installation_upgrade.mdx index 2987b103a8..19e2427f4c 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/installation_upgrade.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/installation_upgrade.mdx @@ -69,7 +69,7 @@ You can install the manifest for the latest version of the operator by running: ```sh kubectl apply --server-side -f \ - https://get.enterprisedb.io/pg4k/pg4k-1.28.0-rc1.yaml + https://get.enterprisedb.io/pg4k/pg4k-1.28.0-rc2.yaml ``` You can verify that with: @@ -155,8 +155,7 @@ plane for self-managed Kubernetes installations). ## Upgrades !!! Warning CRITICAL WARNING: UPGRADING OPERATORS - - OpenShift users, or any customer attempting an operator upgrade, MUST configure the new unified repository pull secret (docker.enterprisedb.com/k8s) before running the upgrade. If the old, deprecated repository path is still in use during the upgrade process, image pull failure will occur, leading to deployment failure and potential downtime. Follow the [Central Migration Guide](migrating_edb_registries) first. + OpenShift users, or any customer attempting an operator upgrade, MUST configure the new unified repository pull secret (docker.enterprisedb.com/k8s) before running the upgrade. If the old, deprecated repository path is still in use during the upgrade process, image pull failure will occur, leading to deployment failure and potential downtime. Follow the [Central Migration Guide](/postgres_for_kubernetes/latest/migrating_edb_registries) first. !!! Important Please carefully read the [release notes](rel_notes) diff --git a/product_docs/docs/postgres_for_kubernetes/preview/instance_manager.mdx b/product_docs/docs/postgres_for_kubernetes/preview/instance_manager.mdx index 105509650e..71b5d616cd 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/instance_manager.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/instance_manager.mdx @@ -1,5 +1,5 @@ --- -title: 'Postgres instance manager' +title: 'Postgres Instance Manager' originalFilePath: 'src/instance_manager.md' --- diff --git a/product_docs/docs/postgres_for_kubernetes/preview/kubectl-plugin.mdx b/product_docs/docs/postgres_for_kubernetes/preview/kubectl-plugin.mdx index 41b6e6ec3c..4e8ece9c77 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/kubectl-plugin.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/kubectl-plugin.mdx @@ -35,11 +35,11 @@ them in your systems. #### Debian packages -For example, let's install the 1.28.0-rc1 release of the plugin, for an Intel based +For example, let's install the 1.28.0-rc2 release of the plugin, for an Intel based 64 bit server. First, we download the right `.deb` file. ```sh -wget https://github.com/EnterpriseDB/kubectl-cnp/releases/download/v1.28.0-rc1/kubectl-cnp_1.28.0-rc1_linux_x86_64.deb \ +wget https://github.com/EnterpriseDB/kubectl-cnp/releases/download/v1.28.0-rc2/kubectl-cnp_1.28.0-rc2_linux_x86_64.deb \ --output-document kube-plugin.deb ``` @@ -50,17 +50,17 @@ $ sudo dpkg -i kube-plugin.deb Selecting previously unselected package cnp. (Reading database ... 6688 files and directories currently installed.) Preparing to unpack kube-plugin.deb ... -Unpacking kubectl-cnp (1.28.0-rc1) ... -Setting up kubectl-cnp (1.28.0-rc1) ... +Unpacking kubectl-cnp (1.28.0-rc2) ... +Setting up kubectl-cnp (1.28.0-rc2) ... ``` #### RPM packages -As in the example for `.rpm` packages, let's install the 1.28.0-rc1 release for an +As in the example for `.rpm` packages, let's install the 1.28.0-rc2 release for an Intel 64 bit machine. Note the `--output` flag to provide a file name. ```sh -curl -L https://github.com/EnterpriseDB/kubectl-cnp/releases/download/v1.28.0-rc1/kubectl-cnp_1.28.0-rc1_linux_x86_64.rpm \ +curl -L https://github.com/EnterpriseDB/kubectl-cnp/releases/download/v1.28.0-rc2/kubectl-cnp_1.28.0-rc2_linux_x86_64.rpm \ --output kube-plugin.rpm ``` @@ -74,7 +74,7 @@ Dependencies resolved. Package Architecture Version Repository Size ==================================================================================================== Installing: - cnp x86_64 1.28.0-rc1-1 @commandline 20 M + cnp x86_64 1.28.0-rc2-1 @commandline 20 M Transaction Summary ==================================================================================================== @@ -243,9 +243,9 @@ sandbox-3 0/604DE38 0/604DE38 0/604DE38 0/604DE38 00:00:00 00:00:00 00 Instances status Name Current LSN Replication role Status QoS Manager Version Node ---- ----------- ---------------- ------ --- --------------- ---- -sandbox-1 0/604DE38 Primary OK BestEffort 1.28.0-rc1 k8s-eu-worker -sandbox-2 0/604DE38 Standby (async) OK BestEffort 1.28.0-rc1 k8s-eu-worker2 -sandbox-3 0/604DE38 Standby (async) OK BestEffort 1.28.0-rc1 k8s-eu-worker +sandbox-1 0/604DE38 Primary OK BestEffort 1.28.0-rc2 k8s-eu-worker +sandbox-2 0/604DE38 Standby (async) OK BestEffort 1.28.0-rc2 k8s-eu-worker2 +sandbox-3 0/604DE38 Standby (async) OK BestEffort 1.28.0-rc2 k8s-eu-worker ``` If you require more detailed status information, use the `--verbose` option (or @@ -299,9 +299,9 @@ sandbox-primary primary 1 1 1 Instances status Name Current LSN Replication role Status QoS Manager Version Node ---- ----------- ---------------- ------ --- --------------- ---- -sandbox-1 0/6053720 Primary OK BestEffort 1.28.0-rc1 k8s-eu-worker -sandbox-2 0/6053720 Standby (async) OK BestEffort 1.28.0-rc1 k8s-eu-worker2 -sandbox-3 0/6053720 Standby (async) OK BestEffort 1.28.0-rc1 k8s-eu-worker +sandbox-1 0/6053720 Primary OK BestEffort 1.28.0-rc2 k8s-eu-worker +sandbox-2 0/6053720 Standby (async) OK BestEffort 1.28.0-rc2 k8s-eu-worker2 +sandbox-3 0/6053720 Standby (async) OK BestEffort 1.28.0-rc2 k8s-eu-worker ``` With an additional `-v` (e.g. `kubectl cnp status sandbox -v -v`), you can @@ -524,12 +524,12 @@ Archive: report_operator_.zip ```output ====== Begin of Previous Log ===== -2023-03-28T12:56:41.251711811Z {"level":"info","ts":"2023-03-28T12:56:41Z","logger":"setup","msg":"Starting EDB Postgres for Kubernetes Operator","version":"1.28.0-rc1","build":{"Version":"1.28.0-rc1+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 EDB Postgres for Kubernetes Operator","version":"1.28.0-rc2","build":{"Version":"1.28.0-rc2+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"} ====== End of Previous Log ===== -2023-03-28T12:57:09.854306024Z {"level":"info","ts":"2023-03-28T12:57:09Z","logger":"setup","msg":"Starting EDB Postgres for Kubernetes Operator","version":"1.28.0-rc1","build":{"Version":"1.28.0-rc1+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 EDB Postgres for Kubernetes Operator","version":"1.28.0-rc2","build":{"Version":"1.28.0-rc2+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"} ``` diff --git a/product_docs/docs/postgres_for_kubernetes/preview/kubernetes_upgrade.mdx b/product_docs/docs/postgres_for_kubernetes/preview/kubernetes_upgrade.mdx index 297818dc7d..7e59246a83 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/kubernetes_upgrade.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/kubernetes_upgrade.mdx @@ -1,5 +1,5 @@ --- -title: 'Kubernetes Upgrade and Maintenance' +title: 'Kubernetes upgrade and maintenance' originalFilePath: 'src/kubernetes_upgrade.md' --- diff --git a/product_docs/docs/postgres_for_kubernetes/preview/labels_annotations.mdx b/product_docs/docs/postgres_for_kubernetes/preview/labels_annotations.mdx index f3b331a2b0..46ccab72d1 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/labels_annotations.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/labels_annotations.mdx @@ -1,5 +1,5 @@ --- -title: 'Labels and annotations' +title: 'Labels and Annotations' originalFilePath: 'src/labels_annotations.md' --- diff --git a/product_docs/docs/postgres_for_kubernetes/preview/license_keys.mdx b/product_docs/docs/postgres_for_kubernetes/preview/license_keys.mdx index 2a6e9d1450..c9c9946e9d 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/license_keys.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/license_keys.mdx @@ -8,8 +8,7 @@ License keys are a legacy management mechanism for {{name.ln}}. You do not need If you are not using an EDB subscription token and installing from public repositories, then you will need a license key. The only exception is when you run the operator with Community PostgreSQL: in this case, if the license key is unset, a cluster will be started with the default trial license - which automatically expires after 30 days. This is not the recommended way of trialing {{name.ln}} - see the [installation guide](installation_upgrade.md) for the recommended options. !!! Warning CRITICAL WARNING: UPGRADING OPERATORS - - OpenShift users, or any customer attempting an operator upgrade, MUST configure the new unified repository pull secret (docker.enterprisedb.com/k8s) before running the upgrade. If the old, deprecated repository path is still in use during the upgrade process, image pull failure will occur, leading to deployment failure and potential downtime. Follow the [Central Migration Guide](migrating_edb_registries) first. + OpenShift users, or any customer attempting an operator upgrade, MUST configure the new unified repository pull secret (docker.enterprisedb.com/k8s) before running the upgrade. If the old, deprecated repository path is still in use during the upgrade process, image pull failure will occur, leading to deployment failure and potential downtime. Follow the [Central Migration Guide](/postgres_for_kubernetes/latest/migrating_edb_registries) first. The following documentation is only for users who have installed the operator using a license key. @@ -96,8 +95,8 @@ This field will take precedence over `licenseKey`: it will be refreshed when you change the secret, in order to extend the expiration date, or switching from a trial license to a production license. -{{name.ln}} is distributed under the EDB Limited Usage License -Agreement, available at [enterprisedb.com/limited-use-license](https://www.enterprisedb.com/limited-use-license). +{{name.ln}} is distributed under the EDB End User License +Agreement, available at [enterprisedb.com/legal/EDB-Eula](https://www.enterprisedb.com/legal/EDB-Eula). {{name.ln}}: Copyright (C) 2019-2022 EnterpriseDB Corporation. diff --git a/product_docs/docs/postgres_for_kubernetes/preview/monitoring.mdx b/product_docs/docs/postgres_for_kubernetes/preview/monitoring.mdx index 3ce3fb8cce..9008a6b6a3 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/monitoring.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/monitoring.mdx @@ -247,7 +247,7 @@ cnp_collector_up{cluster="cluster-example"} 1 # HELP cnp_collector_postgres_version Postgres version # TYPE cnp_collector_postgres_version gauge -cnp_collector_postgres_version{cluster="cluster-example",full="17.6"} 17.6 +cnp_collector_postgres_version{cluster="cluster-example",full="18.1"} 18.1 # HELP cnp_collector_last_failed_backup_timestamp The last failed backup as a unix timestamp (Deprecated) # TYPE cnp_collector_last_failed_backup_timestamp gauge diff --git a/product_docs/docs/postgres_for_kubernetes/preview/openshift.mdx b/product_docs/docs/postgres_for_kubernetes/preview/openshift.mdx index b97fe36e27..131efec5be 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/openshift.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/openshift.mdx @@ -3,7 +3,6 @@ title: 'Red Hat OpenShift' originalFilePath: 'src/openshift.md' --- - {{name.ln}} is certified to run on [Red Hat OpenShift Container Platform (OCP) version 4.x](https://www.openshift.com/products/container-platform) and is available directly from the @@ -243,8 +242,7 @@ release. Please refer to ["Accessing EDB private image registries"](private_edb_registries.md) for further details. !!! Warning CRITICAL WARNING: UPGRADING OPERATORS - - OpenShift users, or any customer attempting an operator upgrade, MUST configure the new unified repository pull secret (docker.enterprisedb.com/k8s) before running the upgrade. If the old, deprecated repository path is still in use during the upgrade process, image pull failure will occur, leading to deployment failure and potential downtime. Follow the [Central Migration Guide](migrating_edb_registries) first. + OpenShift users, or any customer attempting an operator upgrade, MUST configure the new unified repository pull secret (docker.enterprisedb.com/k8s) before running the upgrade. If the old, deprecated repository path is still in use during the upgrade process, image pull failure will occur, leading to deployment failure and potential downtime. Follow the [Central Migration Guide](/postgres_for_kubernetes/latest/migrating_edb_registries) first. The OpenShift install will use pull secrets in order to access the operand and operator images, which are held in a private repository. @@ -385,8 +383,7 @@ different projects. In this case, make sure you read for information on how to install the `oc` command-line interface. !!! Warning CRITICAL WARNING: UPGRADING OPERATORS - - OpenShift users, or any customer attempting an operator upgrade, MUST configure the new unified repository pull secret (docker.enterprisedb.com/k8s) before running the upgrade. If the old, deprecated repository path is still in use during the upgrade process, image pull failure will occur, leading to deployment failure and potential downtime. Follow the [Central Migration Guide](migrating_edb_registries) first. + OpenShift users, or any customer attempting an operator upgrade, MUST configure the new unified repository pull secret (docker.enterprisedb.com/k8s) before running the upgrade. If the old, deprecated repository path is still in use during the upgrade process, image pull failure will occur, leading to deployment failure and potential downtime. Follow the [Central Migration Guide](/postgres_for_kubernetes/latest/migrating_edb_registries) first. Instead of using the OpenShift Container Platform web console, you can install the {{name.ln}} Operator from the OperatorHub and create a diff --git a/product_docs/docs/postgres_for_kubernetes/preview/operator_conf.mdx b/product_docs/docs/postgres_for_kubernetes/preview/operator_conf.mdx index 2cf42fdce9..73dd9b1e26 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/operator_conf.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/operator_conf.mdx @@ -59,9 +59,10 @@ The operator looks for the following environment variables to be defined in the | `MONITORING_QUERIES_CONFIGMAP` | The name of a ConfigMap in the operator's namespace with a set of default queries (to be specified under the key `queries`) to be applied to all created Clusters | | `MONITORING_QUERIES_SECRET` | The name of a Secret in the operator's namespace with a set of default queries (to be specified under the key `queries`) to be applied to all created Clusters | | `OPERATOR_IMAGE_NAME` | The name of the operator image used to bootstrap Pods. Defaults to the image specified during installation. | +| `PGBOUNCER_IMAGE_NAME` | The name of the PgBouncer image used by default for new poolers. Defaults to the version specified in the operator. | | `POSTGRES_IMAGE_NAME` | The name of the PostgreSQL image used by default for new clusters. Defaults to the version specified in the operator. | | `PULL_SECRET_NAME` | Name of an additional pull secret to be defined in the operator's namespace and to be used to download images | -| `STANDBY_TCP_USER_TIMEOUT` | Defines the [`TCP_USER_TIMEOUT` socket option](https://www.postgresql.org/docs/current/runtime-config-connection.html#GUC-TCP-USER-TIMEOUT) for replication connections from standby instances to the primary. Default is 0 (system's default). | +| `STANDBY_TCP_USER_TIMEOUT` | Defines the [`TCP_USER_TIMEOUT` socket option](https://www.postgresql.org/docs/current/runtime-config-connection.html#GUC-TCP-USER-TIMEOUT) in milliseconds for replication connections from standby instances to the primary. Default is 5000 (5 seconds). Set to `0` to use the system's default. | | `DRAIN_TAINTS` | Specifies the taint keys that should be interpreted as indicators of node drain. By default, it includes the taints commonly applied by [kubectl](https://kubernetes.io/docs/concepts/scheduling-eviction/taint-and-toleration/), [Cluster Autoscaler](https://github.com/kubernetes/autoscaler), and [Karpenter](https://github.com/aws/karpenter-provider-aws): `node.kubernetes.io/unschedulable`, `ToBeDeletedByClusterAutoscaler`, `karpenter.sh/disrupted`, `karpenter.sh/disruption`. | Values in `INHERITED_ANNOTATIONS` and `INHERITED_LABELS` support path-like wildcards. For example, the value `example.com/*` will match diff --git a/product_docs/docs/postgres_for_kubernetes/preview/pg4k.v1/index.mdx b/product_docs/docs/postgres_for_kubernetes/preview/pg4k.v1/index.mdx index 480d183f27..ab84738ba0 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/pg4k.v1/index.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/pg4k.v1/index.mdx @@ -1,9 +1,9 @@ --- -title: API Reference - v1.28.0-rc1 +title: API Reference - v1.28.0-rc2 originalFilePath: src/pg4k.v1.md navTitle: API Reference navigation: - - v1.28.0-rc1 + - v1.28.0-rc2 - v1.27.1 - v1.27.0 - v1.26.1 @@ -137,7 +137,7 @@ navigation: apiVersion [Required]
stringpostgresql.k8s.enterprisedb.io/v1 kind [Required]
stringBackup metadata [Required]
-meta/v1.ObjectMeta +meta/v1.ObjectMeta No description provided.Refer to the Kubernetes API documentation for the fields of the metadata field. @@ -175,7 +175,7 @@ managed by {{name.ln}}.

apiVersion [Required]
stringpostgresql.k8s.enterprisedb.io/v1 kind [Required]
stringCluster metadata [Required]
-meta/v1.ObjectMeta +meta/v1.ObjectMeta No description provided.Refer to the Kubernetes API documentation for the fields of the metadata field. @@ -212,7 +212,7 @@ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api- apiVersion [Required]
stringpostgresql.k8s.enterprisedb.io/v1 kind [Required]
stringClusterImageCatalog metadata [Required]
-meta/v1.ObjectMeta +meta/v1.ObjectMeta No description provided.Refer to the Kubernetes API documentation for the fields of the metadata field. @@ -240,7 +240,7 @@ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api- apiVersion [Required]
stringpostgresql.k8s.enterprisedb.io/v1 kind [Required]
stringDatabase metadata [Required]
-meta/v1.ObjectMeta +meta/v1.ObjectMeta No description provided.Refer to the Kubernetes API documentation for the fields of the metadata field. @@ -282,7 +282,7 @@ an update.

apiVersion [Required]
stringpostgresql.k8s.enterprisedb.io/v1 kind [Required]
stringFailoverQuorum metadata [Required]
-meta/v1.ObjectMeta +meta/v1.ObjectMeta No description provided.Refer to the Kubernetes API documentation for the fields of the metadata field. @@ -309,7 +309,7 @@ an update.

apiVersion [Required]
stringpostgresql.k8s.enterprisedb.io/v1 kind [Required]
stringImageCatalog metadata [Required]
-meta/v1.ObjectMeta +meta/v1.ObjectMeta No description provided.Refer to the Kubernetes API documentation for the fields of the metadata field. @@ -337,7 +337,7 @@ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api- apiVersion [Required]
stringpostgresql.k8s.enterprisedb.io/v1 kind [Required]
stringPooler metadata [Required]
-meta/v1.ObjectMeta +meta/v1.ObjectMeta No description provided.Refer to the Kubernetes API documentation for the fields of the metadata field. @@ -374,7 +374,7 @@ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api- apiVersion [Required]
stringpostgresql.k8s.enterprisedb.io/v1 kind [Required]
stringPublication metadata [Required]
-meta/v1.ObjectMeta +meta/v1.ObjectMeta No description provided.Refer to the Kubernetes API documentation for the fields of the metadata field. @@ -406,7 +406,7 @@ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api- apiVersion [Required]
stringpostgresql.k8s.enterprisedb.io/v1 kind [Required]
stringScheduledBackup metadata [Required]
-meta/v1.ObjectMeta +meta/v1.ObjectMeta No description provided.Refer to the Kubernetes API documentation for the fields of the metadata field. @@ -443,7 +443,7 @@ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api- apiVersion [Required]
stringpostgresql.k8s.enterprisedb.io/v1 kind [Required]
stringSubscription metadata [Required]
-meta/v1.ObjectMeta +meta/v1.ObjectMeta No description provided.Refer to the Kubernetes API documentation for the fields of the metadata field. @@ -503,7 +503,7 @@ More info: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/

nodeAffinity
-core/v1.NodeAffinity +core/v1.NodeAffinity

NodeAffinity describes node affinity scheduling rules for the pod. @@ -511,7 +511,7 @@ More info: https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-no tolerations
-[]core/v1.Toleration +[]core/v1.Toleration

Tolerations is a list of Tolerations that should be set for all the pods, in order to allow them to run @@ -532,7 +532,7 @@ https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/#inter-p additionalPodAntiAffinity
-core/v1.PodAntiAffinity +core/v1.PodAntiAffinity

AdditionalPodAntiAffinity allows to specify pod anti-affinity terms to be added to the ones generated @@ -540,7 +540,7 @@ by the operator if EnablePodAntiAffinity is set to true (default) or to be used additionalPodAffinity
-core/v1.PodAffinity +core/v1.PodAffinity

AdditionalPodAffinity allows to specify pod affinity terms to be passed to all the cluster's pods.

@@ -947,14 +947,14 @@ parameter is omitted

startedAt
-meta/v1.Time +meta/v1.Time

When the backup was started

stoppedAt
-meta/v1.Time +meta/v1.Time

When the backup was terminated

@@ -1686,7 +1686,7 @@ and digests for deterministic and repeatable deployments imagePullPolicy
-core/v1.PullPolicy +core/v1.PullPolicy

Image pull policy. @@ -1830,7 +1830,7 @@ contains a pull secret that secret will be automatically included.

ephemeralVolumeSource
-core/v1.EphemeralVolumeSource +core/v1.EphemeralVolumeSource

EphemeralVolumeSource allows the user to configure the source of ephemeral volumes.

@@ -1906,7 +1906,7 @@ ceiling(livenessProbe / 10).

topologySpreadConstraints
-[]core/v1.TopologySpreadConstraint +[]core/v1.TopologySpreadConstraint

TopologySpreadConstraints specifies how to spread matching pods among the given topology. @@ -1915,7 +1915,7 @@ https://kubernetes.io/docs/concepts/scheduling-eviction/topology-spread-constrai resources
-core/v1.ResourceRequirements +core/v1.ResourceRequirements

Resources requirements of every generated Pod. Please refer to @@ -1984,7 +1984,7 @@ the license agreement that comes with the operator.

licenseKeySecret
-core/v1.SecretKeySelector +core/v1.SecretKeySelector

The reference to the license key. When this is set it take precedence over LicenseKey.

@@ -2012,7 +2012,7 @@ the license agreement that comes with the operator.

projectedVolumeTemplate
-core/v1.ProjectedVolumeSource +core/v1.ProjectedVolumeSource

Template to be used to define projected volumes, projected volumes will be mounted @@ -2020,7 +2020,7 @@ under /projected base folder

env
-[]core/v1.EnvVar +[]core/v1.EnvVar

Env follows the Env format to pass environment variables @@ -2028,7 +2028,7 @@ to the pods created in the cluster

envFrom
-[]core/v1.EnvFromSource +[]core/v1.EnvFromSource

EnvFrom follows the EnvFrom format to pass environment variables @@ -2043,7 +2043,7 @@ sources to the pods to be used by Env

seccompProfile
-core/v1.SeccompProfile +core/v1.SeccompProfile

The SeccompProfile applied to every Pod and Container. @@ -2051,7 +2051,7 @@ Defaults to: RuntimeDefault

podSecurityContext
-core/v1.PodSecurityContext +core/v1.PodSecurityContext

Override the PodSecurityContext applied to every Pod of the cluster. @@ -2061,7 +2061,7 @@ This field doesn't have any effect if SecurityContextConstraints are present.

securityContext
-core/v1.SecurityContext +core/v1.SecurityContext

Override the SecurityContext applied to every Container in the Pod of the cluster. @@ -2331,7 +2331,7 @@ This field is calculated from the content of FirstRecoverabilityPointByMethod. firstRecoverabilityPointByMethod
-map[BackupMethod]meta/v1.Time +map[BackupMethod]meta/v1.Time

The first recoverability point, stored as a date in RFC3339 format, per backup method type.

@@ -2348,7 +2348,7 @@ This field is calculated from the content of LastSuccessfulBackupByMethod.

lastSuccessfulBackupByMethod
-map[BackupMethod]meta/v1.Time +map[BackupMethod]meta/v1.Time

Last successful backup, stored as a date in RFC3339 format, per backup method type.

@@ -2414,7 +2414,7 @@ This field is reported when .spec.failoverDelay is populated or dur conditions
-[]meta/v1.Condition +[]meta/v1.Condition

Conditions for cluster object

@@ -2535,21 +2535,21 @@ PostgreSQL cluster from an existing storage

FieldDescription storage [Required]
-core/v1.TypedLocalObjectReference +core/v1.TypedLocalObjectReference

Configuration of the storage of the instances

walStorage
-core/v1.TypedLocalObjectReference +core/v1.TypedLocalObjectReference

Configuration of the storage for PostgreSQL WAL (Write-Ahead Log)

tablespaceStorage
-map[string]core/v1.TypedLocalObjectReference +map[string]core/v1.TypedLocalObjectReference

Configuration of the storage for PostgreSQL tablespaces

@@ -2686,7 +2686,7 @@ PostgreSQL.

FieldDescription cluster [Required]
-core/v1.LocalObjectReference +core/v1.LocalObjectReference

The name of the PostgreSQL cluster hosting the database.

@@ -3074,7 +3074,7 @@ PostgreSQL extensions to the Cluster.

image [Required]
-core/v1.ImageVolumeSource +core/v1.ImageVolumeSource

The image containing the extension, required

@@ -3178,7 +3178,7 @@ external cluster which is used in the other sections of the configuration

sslCert
-core/v1.SecretKeySelector +core/v1.SecretKeySelector

The reference to an SSL certificate to be used to connect to this @@ -3186,7 +3186,7 @@ instance

sslKey
-core/v1.SecretKeySelector +core/v1.SecretKeySelector

The reference to an SSL private key to be used to connect to this @@ -3194,7 +3194,7 @@ instance

sslRootCert
-core/v1.SecretKeySelector +core/v1.SecretKeySelector

The reference to an SSL CA public key to be used to connect to this @@ -3202,7 +3202,7 @@ instance

password
-core/v1.SecretKeySelector +core/v1.SecretKeySelector

The reference to the password to be used to connect to the server. @@ -3357,7 +3357,7 @@ this object the latest time.

FieldDescription TypedLocalObjectReference
-core/v1.TypedLocalObjectReference +core/v1.TypedLocalObjectReference (Members of TypedLocalObjectReference are embedded into this type.) No description provided. @@ -3734,7 +3734,7 @@ the bind+search LDAP authentication process

bindPassword
-core/v1.SecretKeySelector +core/v1.SecretKeySelector

Secret with the password for the user to bind to the directory

@@ -4606,7 +4606,7 @@ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api- spec
-core/v1.PodSpec +core/v1.PodSpec

Specification of the desired behavior of the pod. @@ -4791,7 +4791,7 @@ Pooler name should never match with any cluster name within the same namespace.< deploymentStrategy
-apps/v1.DeploymentStrategy +apps/v1.DeploymentStrategy

The deployment strategy to use for pgbouncer to replace existing pods with new ones

@@ -5176,7 +5176,7 @@ to be injected in the PostgreSQL Pods

FieldDescription cluster [Required]
-core/v1.LocalObjectReference +core/v1.LocalObjectReference

The name of the PostgreSQL cluster that identifies the "publisher"

@@ -5668,7 +5668,7 @@ connections the role can make. -1 (the default) means no limit.

validUntil
-meta/v1.Time +meta/v1.Time

Date and time after which the role's password is no longer valid. @@ -5910,21 +5910,21 @@ Overrides the default settings specified in the cluster '.backup.volumeSnapshot. FieldDescription lastCheckTime
-meta/v1.Time +meta/v1.Time

The latest time the schedule

lastScheduleTime
-meta/v1.Time +meta/v1.Time

Information when was the last time that backup was successfully scheduled.

nextScheduleTime
-meta/v1.Time +meta/v1.Time

Next time we will run a backup

@@ -6201,7 +6201,7 @@ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api- spec
-core/v1.ServiceSpec +core/v1.ServiceSpec

Specification of the desired behavior of the service. @@ -6291,7 +6291,7 @@ Size cannot be decreased.

pvcTemplate
-core/v1.PersistentVolumeClaimSpec +core/v1.PersistentVolumeClaimSpec

Template to be used to generate the Persistent Volume Claim

@@ -6326,7 +6326,7 @@ Size cannot be decreased.

FieldDescription cluster [Required]
-core/v1.LocalObjectReference +core/v1.LocalObjectReference

The name of the PostgreSQL cluster that identifies the "subscriber"

@@ -6636,28 +6636,28 @@ quorum based replication or a priority list

secretKeyRef
-core/v1.SecretKeySelector +core/v1.SecretKeySelector

Reference to the secret that contains the encryption key

wrapCommand
-core/v1.SecretKeySelector +core/v1.SecretKeySelector

WrapCommand is the encrypt command provided by the user

unwrapCommand
-core/v1.SecretKeySelector +core/v1.SecretKeySelector

UnwrapCommand is the decryption command provided by the user

passphraseCommand
-core/v1.SecretKeySelector +core/v1.SecretKeySelector

PassphraseCommand is the command executed to get the passphrase that will be diff --git a/product_docs/docs/postgres_for_kubernetes/preview/pg4k.v1/v1.28.0-rc1.mdx b/product_docs/docs/postgres_for_kubernetes/preview/pg4k.v1/v1.28.0-rc2.mdx similarity index 98% rename from product_docs/docs/postgres_for_kubernetes/preview/pg4k.v1/v1.28.0-rc1.mdx rename to product_docs/docs/postgres_for_kubernetes/preview/pg4k.v1/v1.28.0-rc2.mdx index 991e15c754..7a04bc48b9 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/pg4k.v1/v1.28.0-rc1.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/pg4k.v1/v1.28.0-rc2.mdx @@ -1,6 +1,6 @@ --- -title: API Reference - v1.28.0-rc1 -navTitle: v1.28.0-rc1 +title: API Reference - v1.28.0-rc2 +navTitle: v1.28.0-rc2 pdfExclude: 'true' --- @@ -32,7 +32,7 @@ pdfExclude: 'true' apiVersion [Required]
stringpostgresql.k8s.enterprisedb.io/v1 kind [Required]
stringBackup metadata [Required]
-meta/v1.ObjectMeta +meta/v1.ObjectMeta No description provided.Refer to the Kubernetes API documentation for the fields of the metadata field. @@ -70,7 +70,7 @@ managed by {{name.ln}}.

apiVersion [Required]
stringpostgresql.k8s.enterprisedb.io/v1 kind [Required]
stringCluster metadata [Required]
-meta/v1.ObjectMeta +meta/v1.ObjectMeta No description provided.Refer to the Kubernetes API documentation for the fields of the metadata field. @@ -107,7 +107,7 @@ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api- apiVersion [Required]
stringpostgresql.k8s.enterprisedb.io/v1 kind [Required]
stringClusterImageCatalog metadata [Required]
-meta/v1.ObjectMeta +meta/v1.ObjectMeta No description provided.Refer to the Kubernetes API documentation for the fields of the metadata field. @@ -135,7 +135,7 @@ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api- apiVersion [Required]
stringpostgresql.k8s.enterprisedb.io/v1 kind [Required]
stringDatabase metadata [Required]
-meta/v1.ObjectMeta +meta/v1.ObjectMeta No description provided.Refer to the Kubernetes API documentation for the fields of the metadata field. @@ -177,7 +177,7 @@ an update.

apiVersion [Required]
stringpostgresql.k8s.enterprisedb.io/v1 kind [Required]
stringFailoverQuorum metadata [Required]
-meta/v1.ObjectMeta +meta/v1.ObjectMeta No description provided.Refer to the Kubernetes API documentation for the fields of the metadata field. @@ -204,7 +204,7 @@ an update.

apiVersion [Required]
stringpostgresql.k8s.enterprisedb.io/v1 kind [Required]
stringImageCatalog metadata [Required]
-meta/v1.ObjectMeta +meta/v1.ObjectMeta No description provided.Refer to the Kubernetes API documentation for the fields of the metadata field. @@ -232,7 +232,7 @@ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api- apiVersion [Required]
stringpostgresql.k8s.enterprisedb.io/v1 kind [Required]
stringPooler metadata [Required]
-meta/v1.ObjectMeta +meta/v1.ObjectMeta No description provided.Refer to the Kubernetes API documentation for the fields of the metadata field. @@ -269,7 +269,7 @@ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api- apiVersion [Required]
stringpostgresql.k8s.enterprisedb.io/v1 kind [Required]
stringPublication metadata [Required]
-meta/v1.ObjectMeta +meta/v1.ObjectMeta No description provided.Refer to the Kubernetes API documentation for the fields of the metadata field. @@ -301,7 +301,7 @@ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api- apiVersion [Required]
stringpostgresql.k8s.enterprisedb.io/v1 kind [Required]
stringScheduledBackup metadata [Required]
-meta/v1.ObjectMeta +meta/v1.ObjectMeta No description provided.Refer to the Kubernetes API documentation for the fields of the metadata field. @@ -338,7 +338,7 @@ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api- apiVersion [Required]
stringpostgresql.k8s.enterprisedb.io/v1 kind [Required]
stringSubscription metadata [Required]
-meta/v1.ObjectMeta +meta/v1.ObjectMeta No description provided.Refer to the Kubernetes API documentation for the fields of the metadata field. @@ -398,7 +398,7 @@ More info: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/

nodeAffinity
-core/v1.NodeAffinity +core/v1.NodeAffinity

NodeAffinity describes node affinity scheduling rules for the pod. @@ -406,7 +406,7 @@ More info: https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-no tolerations
-[]core/v1.Toleration +[]core/v1.Toleration

Tolerations is a list of Tolerations that should be set for all the pods, in order to allow them to run @@ -427,7 +427,7 @@ https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/#inter-p additionalPodAntiAffinity
-core/v1.PodAntiAffinity +core/v1.PodAntiAffinity

AdditionalPodAntiAffinity allows to specify pod anti-affinity terms to be added to the ones generated @@ -435,7 +435,7 @@ by the operator if EnablePodAntiAffinity is set to true (default) or to be used additionalPodAffinity
-core/v1.PodAffinity +core/v1.PodAffinity

AdditionalPodAffinity allows to specify pod affinity terms to be passed to all the cluster's pods.

@@ -842,14 +842,14 @@ parameter is omitted

startedAt
-meta/v1.Time +meta/v1.Time

When the backup was started

stoppedAt
-meta/v1.Time +meta/v1.Time

When the backup was terminated

@@ -1581,7 +1581,7 @@ and digests for deterministic and repeatable deployments imagePullPolicy
-core/v1.PullPolicy +core/v1.PullPolicy

Image pull policy. @@ -1725,7 +1725,7 @@ contains a pull secret that secret will be automatically included.

ephemeralVolumeSource
-core/v1.EphemeralVolumeSource +core/v1.EphemeralVolumeSource

EphemeralVolumeSource allows the user to configure the source of ephemeral volumes.

@@ -1801,7 +1801,7 @@ ceiling(livenessProbe / 10).

topologySpreadConstraints
-[]core/v1.TopologySpreadConstraint +[]core/v1.TopologySpreadConstraint

TopologySpreadConstraints specifies how to spread matching pods among the given topology. @@ -1810,7 +1810,7 @@ https://kubernetes.io/docs/concepts/scheduling-eviction/topology-spread-constrai resources
-core/v1.ResourceRequirements +core/v1.ResourceRequirements

Resources requirements of every generated Pod. Please refer to @@ -1879,7 +1879,7 @@ the license agreement that comes with the operator.

licenseKeySecret
-core/v1.SecretKeySelector +core/v1.SecretKeySelector

The reference to the license key. When this is set it take precedence over LicenseKey.

@@ -1907,7 +1907,7 @@ the license agreement that comes with the operator.

projectedVolumeTemplate
-core/v1.ProjectedVolumeSource +core/v1.ProjectedVolumeSource

Template to be used to define projected volumes, projected volumes will be mounted @@ -1915,7 +1915,7 @@ under /projected base folder

env
-[]core/v1.EnvVar +[]core/v1.EnvVar

Env follows the Env format to pass environment variables @@ -1923,7 +1923,7 @@ to the pods created in the cluster

envFrom
-[]core/v1.EnvFromSource +[]core/v1.EnvFromSource

EnvFrom follows the EnvFrom format to pass environment variables @@ -1938,7 +1938,7 @@ sources to the pods to be used by Env

seccompProfile
-core/v1.SeccompProfile +core/v1.SeccompProfile

The SeccompProfile applied to every Pod and Container. @@ -1946,7 +1946,7 @@ Defaults to: RuntimeDefault

podSecurityContext
-core/v1.PodSecurityContext +core/v1.PodSecurityContext

Override the PodSecurityContext applied to every Pod of the cluster. @@ -1956,7 +1956,7 @@ This field doesn't have any effect if SecurityContextConstraints are present.

securityContext
-core/v1.SecurityContext +core/v1.SecurityContext

Override the SecurityContext applied to every Container in the Pod of the cluster. @@ -2226,7 +2226,7 @@ This field is calculated from the content of FirstRecoverabilityPointByMethod. firstRecoverabilityPointByMethod
-map[BackupMethod]meta/v1.Time +map[BackupMethod]meta/v1.Time

The first recoverability point, stored as a date in RFC3339 format, per backup method type.

@@ -2243,7 +2243,7 @@ This field is calculated from the content of LastSuccessfulBackupByMethod.

lastSuccessfulBackupByMethod
-map[BackupMethod]meta/v1.Time +map[BackupMethod]meta/v1.Time

Last successful backup, stored as a date in RFC3339 format, per backup method type.

@@ -2309,7 +2309,7 @@ This field is reported when .spec.failoverDelay is populated or dur conditions
-[]meta/v1.Condition +[]meta/v1.Condition

Conditions for cluster object

@@ -2430,21 +2430,21 @@ PostgreSQL cluster from an existing storage

FieldDescription storage [Required]
-core/v1.TypedLocalObjectReference +core/v1.TypedLocalObjectReference

Configuration of the storage of the instances

walStorage
-core/v1.TypedLocalObjectReference +core/v1.TypedLocalObjectReference

Configuration of the storage for PostgreSQL WAL (Write-Ahead Log)

tablespaceStorage
-map[string]core/v1.TypedLocalObjectReference +map[string]core/v1.TypedLocalObjectReference

Configuration of the storage for PostgreSQL tablespaces

@@ -2581,7 +2581,7 @@ PostgreSQL.

FieldDescription cluster [Required]
-core/v1.LocalObjectReference +core/v1.LocalObjectReference

The name of the PostgreSQL cluster hosting the database.

@@ -2969,7 +2969,7 @@ PostgreSQL extensions to the Cluster.

image [Required]
-core/v1.ImageVolumeSource +core/v1.ImageVolumeSource

The image containing the extension, required

@@ -3073,7 +3073,7 @@ external cluster which is used in the other sections of the configuration

sslCert
-core/v1.SecretKeySelector +core/v1.SecretKeySelector

The reference to an SSL certificate to be used to connect to this @@ -3081,7 +3081,7 @@ instance

sslKey
-core/v1.SecretKeySelector +core/v1.SecretKeySelector

The reference to an SSL private key to be used to connect to this @@ -3089,7 +3089,7 @@ instance

sslRootCert
-core/v1.SecretKeySelector +core/v1.SecretKeySelector

The reference to an SSL CA public key to be used to connect to this @@ -3097,7 +3097,7 @@ instance

password
-core/v1.SecretKeySelector +core/v1.SecretKeySelector

The reference to the password to be used to connect to the server. @@ -3252,7 +3252,7 @@ this object the latest time.

FieldDescription TypedLocalObjectReference
-core/v1.TypedLocalObjectReference +core/v1.TypedLocalObjectReference (Members of TypedLocalObjectReference are embedded into this type.) No description provided. @@ -3629,7 +3629,7 @@ the bind+search LDAP authentication process

bindPassword
-core/v1.SecretKeySelector +core/v1.SecretKeySelector

Secret with the password for the user to bind to the directory

@@ -4501,7 +4501,7 @@ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api- spec
-core/v1.PodSpec +core/v1.PodSpec

Specification of the desired behavior of the pod. @@ -4686,7 +4686,7 @@ Pooler name should never match with any cluster name within the same namespace.< deploymentStrategy
-apps/v1.DeploymentStrategy +apps/v1.DeploymentStrategy

The deployment strategy to use for pgbouncer to replace existing pods with new ones

@@ -5071,7 +5071,7 @@ to be injected in the PostgreSQL Pods

FieldDescription cluster [Required]
-core/v1.LocalObjectReference +core/v1.LocalObjectReference

The name of the PostgreSQL cluster that identifies the "publisher"

@@ -5563,7 +5563,7 @@ connections the role can make. -1 (the default) means no limit.

validUntil
-meta/v1.Time +meta/v1.Time

Date and time after which the role's password is no longer valid. @@ -5805,21 +5805,21 @@ Overrides the default settings specified in the cluster '.backup.volumeSnapshot. FieldDescription lastCheckTime
-meta/v1.Time +meta/v1.Time

The latest time the schedule

lastScheduleTime
-meta/v1.Time +meta/v1.Time

Information when was the last time that backup was successfully scheduled.

nextScheduleTime
-meta/v1.Time +meta/v1.Time

Next time we will run a backup

@@ -6096,7 +6096,7 @@ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api- spec
-core/v1.ServiceSpec +core/v1.ServiceSpec

Specification of the desired behavior of the service. @@ -6186,7 +6186,7 @@ Size cannot be decreased.

pvcTemplate
-core/v1.PersistentVolumeClaimSpec +core/v1.PersistentVolumeClaimSpec

Template to be used to generate the Persistent Volume Claim

@@ -6221,7 +6221,7 @@ Size cannot be decreased.

FieldDescription cluster [Required]
-core/v1.LocalObjectReference +core/v1.LocalObjectReference

The name of the PostgreSQL cluster that identifies the "subscriber"

@@ -6531,28 +6531,28 @@ quorum based replication or a priority list

secretKeyRef
-core/v1.SecretKeySelector +core/v1.SecretKeySelector

Reference to the secret that contains the encryption key

wrapCommand
-core/v1.SecretKeySelector +core/v1.SecretKeySelector

WrapCommand is the encrypt command provided by the user

unwrapCommand
-core/v1.SecretKeySelector +core/v1.SecretKeySelector

UnwrapCommand is the decryption command provided by the user

passphraseCommand
-core/v1.SecretKeySelector +core/v1.SecretKeySelector

PassphraseCommand is the command executed to get the passphrase that will be diff --git a/product_docs/docs/postgres_for_kubernetes/preview/postgis.mdx b/product_docs/docs/postgres_for_kubernetes/preview/postgis.mdx index 90b28df474..4163661461 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/postgis.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/postgis.mdx @@ -122,7 +122,7 @@ values from the ones in this document): ```console $ kubectl cnpg psql postgis-example -- app -psql (17.6 (Debian 17.6-1.pgdg13+3)) +psql (18.0 (Debian 18.0-1.pgdg13+3)) Type "help" for help. app=# SELECT * FROM pg_available_extensions WHERE name ~ '^postgis' ORDER BY 1; diff --git a/product_docs/docs/postgres_for_kubernetes/preview/postgres_upgrades.mdx b/product_docs/docs/postgres_for_kubernetes/preview/postgres_upgrades.mdx index dd51deb3e7..e309ac3560 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/postgres_upgrades.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/postgres_upgrades.mdx @@ -1,5 +1,5 @@ --- -title: 'PostgreSQL Upgrades' +title: 'PostgreSQL upgrades' originalFilePath: 'src/postgres_upgrades.md' --- diff --git a/product_docs/docs/postgres_for_kubernetes/preview/postgresql_conf.mdx b/product_docs/docs/postgres_for_kubernetes/preview/postgresql_conf.mdx index 0a2b1307ef..df4d749afd 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/postgresql_conf.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/postgresql_conf.mdx @@ -170,19 +170,20 @@ role within the cluster. These parameters are effectively applied only when the instance is operating as a replica. ```text -primary_conninfo = 'host= user=postgres dbname=postgres' +primary_conninfo = 'host= user=postgres dbname=postgres tcp_user_timeout=5000' recovery_target_timeline = 'latest' ``` -The [`STANDBY_TCP_USER_TIMEOUT` operator configuration setting](operator_conf.md#available-options), -if specified, sets the `tcp_user_timeout` parameter on all standby instances -managed by the operator. - -The `tcp_user_timeout` parameter determines how long transmitted data can -remain unacknowledged before the TCP connection is forcibly closed. Adjusting -this value allows you to fine-tune the responsiveness of standby instances to -network disruptions. For more details, refer to the -[PostgreSQL documentation](https://www.postgresql.org/docs/current/runtime-config-connection.html#GUC-TCP-USER-TIMEOUT). +!!! Important + By default, every standby sets `tcp_user_timeout` to **5 seconds**, as shown + above. This parameter defines how long transmitted data may remain + unacknowledged before the TCP connection is forcibly closed. Adjusting it lets + you control how quickly a standby reacts to network issues. + If the default value does not meet your requirements, you can override it + for all standbys managed by the operator using the + [`STANDBY_TCP_USER_TIMEOUT` operator configuration option](operator_conf.md#available-options). + For additional details on `tcp_user_timeout`, refer to the + [PostgreSQL documentation](https://www.postgresql.org/docs/current/runtime-config-connection.html#GUC-TCP-USER-TIMEOUT). ### Log control settings diff --git a/product_docs/docs/postgres_for_kubernetes/preview/preview_version.mdx b/product_docs/docs/postgres_for_kubernetes/preview/preview_version.mdx index 35a6d307d0..f1f5d785f6 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/preview_version.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/preview_version.mdx @@ -38,9 +38,9 @@ are not backwards compatible and could be removed entirely. ## Current Preview Version -The current preview version is **1.28.0-rc1**. +The current preview version is **1.28.0-rc2**. For more information on the current preview version and how to test, please view the links below: -- [Announcement](rel_notes/1_28_0-rc1_rel_notes) +- [Announcement](rel_notes/1.28.0-rc2_rel_notes) - [Documentation](/postgres_for_kubernetes/preview/) diff --git a/product_docs/docs/postgres_for_kubernetes/preview/private_edb_registries.mdx b/product_docs/docs/postgres_for_kubernetes/preview/private_edb_registries.mdx index e0ca2ac38b..1363fad6d6 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/private_edb_registries.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/private_edb_registries.mdx @@ -1,5 +1,5 @@ --- -title: 'EDB private container registry' +title: 'EDB private container registries' originalFilePath: 'src/private_edb_registries.md' --- @@ -25,9 +25,9 @@ operands, are kept in a private container image registry under Collect the following information: -1. Your [EDB account token](/repos/getting_started/with_web/get_your_token/) -2. The name of the repository, which will be `k8s` -3. The repository server, which will be `docker.enterprisedb.com` +1. Your [EDB account token](/repos/getting_started/with_web/get_your_token/) +2. The name of the repository, which will be `k8s` +3. The repository server, which will be `docker.enterprisedb.com` For clarity, the following examples assume your token is in an environment variable named `EDB_SUBSCRIPTION_TOKEN`. @@ -35,9 +35,9 @@ For clarity, the following examples assume your token is in an environment varia You can log in via Docker from your terminal. In this context, -- The server is `docker.enterprisedb.com` -- The username is the repository, `k8s` -- The password is your EDB account token (stored in `$EDB_SUBSCRIPTION_TOKEN`) +- The server is `docker.enterprisedb.com` +- The username is the repository, `k8s` +- The password is your EDB account token (stored in `$EDB_SUBSCRIPTION_TOKEN`) ```sh docker login docker.enterprisedb.com \ diff --git a/product_docs/docs/postgres_for_kubernetes/preview/quickstart.mdx b/product_docs/docs/postgres_for_kubernetes/preview/quickstart.mdx index 31f20e54cc..023cad72bc 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/quickstart.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/quickstart.mdx @@ -3,6 +3,8 @@ title: 'Quickstart' originalFilePath: 'src/quickstart.md' --- + + This section guides you through testing a PostgreSQL cluster on your local machine by deploying {{name.ln}} on a local Kubernetes cluster using either [Kind](https://kind.sigs.k8s.io/) or diff --git a/product_docs/docs/postgres_for_kubernetes/preview/rel_notes/1_28_0-rc1_rel_notes.mdx b/product_docs/docs/postgres_for_kubernetes/preview/rel_notes/1_28_0-rc2_rel_notes.mdx similarity index 98% rename from product_docs/docs/postgres_for_kubernetes/preview/rel_notes/1_28_0-rc1_rel_notes.mdx rename to product_docs/docs/postgres_for_kubernetes/preview/rel_notes/1_28_0-rc2_rel_notes.mdx index a7941136cf..fb47d3a95c 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/rel_notes/1_28_0-rc1_rel_notes.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/rel_notes/1_28_0-rc2_rel_notes.mdx @@ -1,7 +1,7 @@ --- # IMPORTANT: Do not edit this file directly - it is generated from yaml source. -title: EDB CloudNativePG Cluster 1.28.0-rc1 release notes -navTitle: Version 1.28.0-rc1 +title: EDB CloudNativePG Cluster 1.28.0-rc2 release notes +navTitle: Version 1.28.0-rc2 originalFilePath: product_docs/docs/postgres_for_kubernetes/preview/rel_notes/src/1.28.0_rel_notes.yml editTarget: originalFilePath --- diff --git a/product_docs/docs/postgres_for_kubernetes/preview/rel_notes/index.mdx b/product_docs/docs/postgres_for_kubernetes/preview/rel_notes/index.mdx index 5fe5fa2e1d..b38609316b 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/rel_notes/index.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/rel_notes/index.mdx @@ -7,7 +7,7 @@ indexCards: none redirects: - ../release_notes navigation: - - 1_28_0-rc1_rel_notes + - 1.28.0-rc2_rel_notes - 1_27_1_rel_notes - 1_27_0_rel_notes - 1_26_2_rel_notes @@ -134,7 +134,7 @@ The EDB Postgres for Kubernetes documentation describes the major version of EDB | Version | Release date | Upstream merges | |---|---|---| -| [1.28.0-rc1](./1_28_0-rc1_rel_notes) | 07 Nov 2025 | Upstream [1.28.0-rc1](https://cloudnative-pg.io/documentation/preview/release_notes/v1.28/) | +| [1.28.0-rc2](./1.28.0-rc2_rel_notes) | 07 Nov 2025 | Upstream [1.28.0-rc2](https://cloudnative-pg.io/documentation/preview/release_notes/v1.28/) | | [1.27.1](./1_27_1_rel_notes) | 24 Oct 2025 | Upstream [1.27.1](https://cloudnative-pg.io/documentation/1.27/release_notes/v1.27/) | | [1.27.0](./1_27_0_rel_notes) | 19 Aug 2025 | Upstream [1.27.0](https://cloudnative-pg.io/documentation/1.27/release_notes/v1.27/) | | [1.26.2](./1_26_2_rel_notes) | 24 Oct 2025 | Upstream [1.26.2](https://cloudnative-pg.io/documentation/1.26/release_notes/v1.26/) | diff --git a/product_docs/docs/postgres_for_kubernetes/preview/rel_notes/src/1.28.0_rel_notes.yml b/product_docs/docs/postgres_for_kubernetes/preview/rel_notes/src/1.28.0_rel_notes.yml index 407626afa9..a7f9d87f76 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/rel_notes/src/1.28.0_rel_notes.yml +++ b/product_docs/docs/postgres_for_kubernetes/preview/rel_notes/src/1.28.0_rel_notes.yml @@ -1,13 +1,13 @@ # yaml-language-server: $schema=https://raw.githubusercontent.com/EnterpriseDB/docs/refs/heads/develop/tools/automation/generators/relgen/relnote-schema.json product: EDB CloudNativePG Cluster -version: 1.28.0-rc1 +version: 1.28.0-rc2 date: 7 November 2025 intro: | This release includes the following: components: - "Operator": 1.28.0-rc1 - "CNP plugin": 1.28.0-rc1 - upstream-merge: Upstream [1.28.0-rc1](https://cloudnative-pg.io/documentation/preview/release_notes/v1.28/) + "Operator": 1.28.0-rc2 + "CNP plugin": 1.28.0-rc2 + upstream-merge: Upstream [1.28.0-rc2](https://cloudnative-pg.io/documentation/preview/release_notes/v1.28/) highlights: | We've consolidated our [private container registry](../private_edb_registries) into a single location. This change simplifies access and deployment. Starting with v1.28.0, any customer attempting an operator upgrade, MUST configure the new unified repository pull secret! diff --git a/product_docs/docs/postgres_for_kubernetes/preview/replication.mdx b/product_docs/docs/postgres_for_kubernetes/preview/replication.mdx index b896450ead..0fd726b12e 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/replication.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/replication.mdx @@ -505,7 +505,7 @@ ANY q (pod1, pod2, ...) Where: - `q` is an integer automatically calculated by the operator to be: - `1 <= minSyncReplicas <= q <= maxSyncReplicas <= readyReplicas` + `1 ≤ minSyncReplicas ≤ q ≤ maxSyncReplicas ≤ readyReplicas` - `pod1, pod2, ...` is the list of all PostgreSQL pods in the cluster !!! Warning diff --git a/product_docs/docs/postgres_for_kubernetes/preview/rolling_update.mdx b/product_docs/docs/postgres_for_kubernetes/preview/rolling_update.mdx index a0193821df..231a331f3b 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/rolling_update.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/rolling_update.mdx @@ -1,5 +1,5 @@ --- -title: 'Rolling Updates' +title: 'Rolling updates' originalFilePath: 'src/rolling_update.md' --- diff --git a/product_docs/docs/postgres_for_kubernetes/preview/service_management.mdx b/product_docs/docs/postgres_for_kubernetes/preview/service_management.mdx index 0c18de2b00..443fb94bfd 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/service_management.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/service_management.mdx @@ -1,5 +1,5 @@ --- -title: 'Service Management' +title: 'Service management' originalFilePath: 'src/service_management.md' --- From b7a4841c2733a9f1c0787e85bd3e7addbc55a409 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Tue, 9 Dec 2025 05:36:16 +0000 Subject: [PATCH 2/2] update generated release notes --- .../docs/postgres_for_kubernetes/preview/rel_notes/index.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/product_docs/docs/postgres_for_kubernetes/preview/rel_notes/index.mdx b/product_docs/docs/postgres_for_kubernetes/preview/rel_notes/index.mdx index b38609316b..084b79414c 100644 --- a/product_docs/docs/postgres_for_kubernetes/preview/rel_notes/index.mdx +++ b/product_docs/docs/postgres_for_kubernetes/preview/rel_notes/index.mdx @@ -7,7 +7,7 @@ indexCards: none redirects: - ../release_notes navigation: - - 1.28.0-rc2_rel_notes + - 1_28_0-rc2_rel_notes - 1_27_1_rel_notes - 1_27_0_rel_notes - 1_26_2_rel_notes @@ -134,7 +134,7 @@ The EDB Postgres for Kubernetes documentation describes the major version of EDB | Version | Release date | Upstream merges | |---|---|---| -| [1.28.0-rc2](./1.28.0-rc2_rel_notes) | 07 Nov 2025 | Upstream [1.28.0-rc2](https://cloudnative-pg.io/documentation/preview/release_notes/v1.28/) | +| [1.28.0-rc2](./1_28_0-rc2_rel_notes) | 07 Nov 2025 | Upstream [1.28.0-rc2](https://cloudnative-pg.io/documentation/preview/release_notes/v1.28/) | | [1.27.1](./1_27_1_rel_notes) | 24 Oct 2025 | Upstream [1.27.1](https://cloudnative-pg.io/documentation/1.27/release_notes/v1.27/) | | [1.27.0](./1_27_0_rel_notes) | 19 Aug 2025 | Upstream [1.27.0](https://cloudnative-pg.io/documentation/1.27/release_notes/v1.27/) | | [1.26.2](./1_26_2_rel_notes) | 24 Oct 2025 | Upstream [1.26.2](https://cloudnative-pg.io/documentation/1.26/release_notes/v1.26/) |