Merge branch 'main' into projected-volume

pha91 · web-flow · commit 7ec495191738 · 2026-03-10T11:09:15.000+01:00
diff --git a/.github/actions/deploy-cluster/action.yml b/.github/actions/deploy-cluster/action.yml
@@ -13,7 +13,7 @@ runs:
       env:
         NAMESPACE: ${{ inputs.namespace }}
       run: |
-        cat <<EOF | kubectl apply -f -
+        cat <<EOF | kubectl apply --server-side --validate=strict -f -
         # Example of PostgreSQL cluster
         apiVersion: postgresql.cnpg.io/v1
         kind: Cluster
diff --git a/.github/actions/deploy-operator/action.yml b/.github/actions/deploy-operator/action.yml
@@ -17,13 +17,12 @@ runs:
       env:
         NAMESPACE: ${{ inputs.namespace }}
         CLUSTER_WIDE: ${{ inputs.cluster-wide }}
-      run:
-        helm dependency update charts/cloudnative-pg
-
-        helm upgrade
-        --install 
-        --namespace $NAMESPACE
-        --create-namespace
-        --set config.clusterWide=$CLUSTER_WIDE
-        --wait
-        cnpg charts/cloudnative-pg
+      run: |
+        helm repo add cnpg https://cloudnative-pg.github.io/charts
+        helm upgrade \
+          --install \
+          --namespace $NAMESPACE \
+          --create-namespace \
+          --set config.clusterWide=$CLUSTER_WIDE \
+          --wait \
+          cnpg cnpg/cloudnative-pg
diff --git a/.github/workflows/release-pr.yml b/.github/workflows/release-pr.yml
@@ -22,11 +22,12 @@ jobs:
         id: create-pr
         env:
           GH_TOKEN: ${{ secrets.REPO_GHA_PAT }}
+          ACTOR: ${{ github.actor }}
         run: |
           TAG="${GITHUB_REF##*/}"
           TITLE="Release ${TAG}"
           BODY="Automated PR. Will trigger the ${TAG} release when approved."
           LABEL=release
-          ASSIGNEE=${{ github.actor }}
+          ASSIGNEE="${ACTOR}"
           gh pr create --title "${TITLE}" --body "${BODY}" --label "${LABEL}" --assignee "${ASSIGNEE}" ||
           gh pr edit --title "${TITLE}" --body "${BODY}" --add-label "${LABEL}"
diff --git a/.github/workflows/tests-cluster-chainsaw.yaml b/.github/workflows/tests-cluster-chainsaw.yaml
@@ -70,4 +70,6 @@ jobs:
             tenant minio-operator/tenant
 
       - name: Run Kyverno/Chainsaw
-        run: chainsaw test charts/cluster/test/${{matrix.test}}
+        env:
+          MATRIX_TEST: ${{ matrix.test }}
+        run: chainsaw test "charts/cluster/test/${MATRIX_TEST}"
diff --git a/.github/workflows/tests-plugin-barman-cloud.yaml b/.github/workflows/tests-plugin-barman-cloud.yaml
@@ -26,7 +26,9 @@ jobs:
     strategy:
       fail-fast: false
       matrix: ${{ fromJson(needs.test-list.outputs.tests) }}
-    name: ${{matrix.test}}
+    env:
+      MATRIX_TEST: ${{ matrix.test }}
+    name: ${{ env.MATRIX_TEST }}
     steps:
       - name: Checkout
         uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
@@ -73,4 +75,4 @@ jobs:
             tenant minio-operator/tenant
 
       - name: Run Kyverno/Chainsaw
-        run: chainsaw test charts/plugin-barman-cloud/test/${{matrix.test}}
+        run: chainsaw test "charts/plugin-barman-cloud/test/${MATRIX_TEST}"
diff --git a/.gitignore b/.gitignore
@@ -16,8 +16,11 @@ charts/**/charts/*.tgz
 # Output of the go coverage tool, specifically when used with LiteIDE
 *.out
 
-# editor and IDE paraphernalia
+# Editor and IDE paraphernalia
 .idea
 *.swp
 *.swo
 *~
+
+# macOS
+.DS_Store
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -1,22 +1,10 @@
-# Contributing to Helm Charts
+# Contributing to CloudNativePG
 
-Please read the [code of conduct](CODE-OF-CONDUCT.md) first.
+Thank you for your interest in contributing! 💖
 
-## How to report a new issue
+To ensure consistency across the project, all CloudNativePG repositories follow
+a common set of guidelines regarding code of conduct, AI usage, and
+contribution workflows.
 
-Before reporting a new issue, please make sure you have:
-
-- read the documentation
-- checked that a similar issue has not been opened in the past
-
-## How to contribute
-
-You can contribute to charts by submitting a new pull request.
-
-Please:
-
-1. Open a new issue providing information about the feature you want to add
-2. Fork the project, develop the feature as a branch with the issue ID (e.g. dev/43) and test the code
-3. Submit a pull request
-
-Thank you.
+Please review the [CloudNativePG Project contributing guidelines](https://github.com/cloudnative-pg/governance/blob/main/CONTRIBUTING.md)
+before searching for issues, reporting bugs, or submitting a pull request.
diff --git a/LICENSE b/LICENSE
@@ -1,4 +1,3 @@
-
                                  Apache License
                            Version 2.0, January 2004
                         http://www.apache.org/licenses/
diff --git a/charts/cluster/Chart.yaml b/charts/cluster/Chart.yaml
@@ -21,7 +21,7 @@ name: cluster
 description: Deploys and manages a CloudNativePG cluster and its associated resources.
 icon: https://raw.githubusercontent.com/cloudnative-pg/artwork/main/cloudnativepg-logo.svg
 type: application
-version: 0.5.0
+version: 0.6.0
 sources:
   - https://github.com/cloudnative-pg/charts
 keywords:
diff --git a/charts/cluster/README.md b/charts/cluster/README.md
@@ -1,6 +1,6 @@
 # cluster
 
-![Version: 0.5.0](https://img.shields.io/badge/Version-0.5.0-informational?style=flat-square) ![Type: application](https://img.shields.io/badge/Type-application-informational?style=flat-square)
+![Version: 0.6.0](https://img.shields.io/badge/Version-0.6.0-informational?style=flat-square) ![Type: application](https://img.shields.io/badge/Type-application-informational?style=flat-square)
 
 > **Warning**
 > ### This chart is under active development.
@@ -68,7 +68,7 @@ Depending on the type the chart will use a different Docker image and fill in so
 
 The chart has three modes of operation. These are configured via the `mode` parameter:
 * `standalone` - Creates new or updates an existing CNPG cluster. This is the default mode.
-* `replica` - Creates a replica cluster from an existing CNPG cluster. **_Note_ that this mode is not yet supported.**
+* `replica` - Creates a replica cluster from an existing CNPG cluster.
 * `recovery` - Recovers a CNPG cluster from a backup, object store or via pg_basebackup.
 
 ### Backup configuration
@@ -93,9 +93,9 @@ backups:
       backupOwnerReference: self
 ```
 
-Each backup adapter takes it's own set of parameters, listed in the [Configuration options](#Configuration-options) section
-below. Refer to the table for the full list of parameters and place the configuration under the appropriate key: `backup.s3`,
-`backup.azure`, or `backup.google`.
+Each backup adapter takes it's own set of parameters, listed in the [Configuration options](#Configuration-options)
+section. Refer to the table for the full list of parameters and place the configuration under the appropriate key: `backups.s3`,
+`backups.azure`, or `backups.google`.
 
 Recovery
 --------
@@ -106,7 +106,7 @@ Examples
 --------
 
 There are several configuration examples in the [examples](examples) directory. Refer to them for a basic setup and
-refer to  the [CloudNativePG Documentation](https://cloudnative-pg.io/documentation/current/) for more advanced configurations.
+refer to the [CloudNativePG Documentation](https://cloudnative-pg.io/documentation/current/) for more advanced configurations.
 
 ## Values
 
diff --git a/charts/cluster/README.md.gotmpl b/charts/cluster/README.md.gotmpl
@@ -76,7 +76,7 @@ Depending on the type the chart will use a different Docker image and fill in so
 
 The chart has three modes of operation. These are configured via the `mode` parameter:
 * `standalone` - Creates new or updates an existing CNPG cluster. This is the default mode.
-* `replica` - Creates a replica cluster from an existing CNPG cluster. **_Note_ that this mode is not yet supported.**
+* `replica` - Creates a replica cluster from an existing CNPG cluster.
 * `recovery` - Recovers a CNPG cluster from a backup, object store or via pg_basebackup.
 
 ### Backup configuration
@@ -101,9 +101,9 @@ backups:
       backupOwnerReference: self
 ```
 
-Each backup adapter takes it's own set of parameters, listed in the [Configuration options](#Configuration-options) section
-below. Refer to the table for the full list of parameters and place the configuration under the appropriate key: `backup.s3`,
-`backup.azure`, or `backup.google`.
+Each backup adapter takes it's own set of parameters, listed in the [Configuration options](#Configuration-options)
+section. Refer to the table for the full list of parameters and place the configuration under the appropriate key: `backups.s3`,
+`backups.azure`, or `backups.google`.
 
 
 Recovery
@@ -116,7 +116,7 @@ Examples
 --------
 
 There are several configuration examples in the [examples](examples) directory. Refer to them for a basic setup and
-refer to  the [CloudNativePG Documentation](https://cloudnative-pg.io/documentation/current/) for more advanced configurations.
+refer to the [CloudNativePG Documentation](https://cloudnative-pg.io/documentation/current/) for more advanced configurations.
 
 
 {{ template "chart.requirementsSection" . }}
diff --git a/charts/cluster/docs/Getting Started.md b/charts/cluster/docs/Getting Started.md
@@ -4,14 +4,14 @@ The CNPG cluster chart follows a convention over configuration approach. This me
 CNPG setup with sensible defaults. However, you can override these defaults to create a more customized setup. Note that
 you still need to configure backups and monitoring separately. The chart will not install a Prometheus stack for you.
 
-_**Note,**_ that this is an opinionated chart. It does not support all configuration options that CNPG supports. If you
+_**Note**_ that this is an opinionated chart. It does not support all configuration options that CNPG supports. If you
 need a highly customized setup, you should manage your cluster via a Kubernetes CNPG cluster manifest instead of this chart.
 Refer to the [CNPG documentation](https://cloudnative-pg.io/documentation/current/) in that case.
 
 ## Installing the operator
 
-To begin, make sure you install the CNPG operator in you cluster. It can be installed via a Helm chart as shown below or
-ir can be installed via a Kubernetes manifest. For more information see the [CNPG documentation](https://cloudnative-pg.io/documentation/current/installation_upgrade/).
+To begin, make sure you install the CNPG operator in your cluster. It can be installed via a Helm chart as shown below or
+it can be installed via a Kubernetes manifest. For more information see the [CNPG documentation](https://cloudnative-pg.io/documentation/current/installation_upgrade/).
 
 ```console
 helm repo add cnpg https://cloudnative-pg.github.io/charts
@@ -39,12 +39,12 @@ Depending on the type the chart will use a different Docker image and fill in so
 The chart has three modes of operation. These are configured via the `mode` parameter. If this is your first cluster, you
 are likely looking for the `standalone` option.
 * `standalone` - Creates new or updates an existing CNPG cluster. This is the default mode.
-* `replica` - Creates a replica cluster from an existing CNPG cluster. **_Note_ that this mode is not yet supported.**
+* `replica` - Creates a replica cluster from an existing CNPG cluster.
 * `recovery` - Recovers a CNPG cluster from a backup, object store or via pg_basebackup.
 
 ### Backup configuration
 
-Most importantly you should configure your backup storage. 
+Most importantly you should configure your backup storage.
 
 CNPG implements disaster recovery via [Barman](https://pgbarman.org/). The following section configures the barman object
 store where backups will be stored. Barman performs backups of the cluster filesystem base backup and WALs. Both are
@@ -66,22 +66,22 @@ Additionally you can specify the following parameters:
         backupOwnerReference: self
   ```
 
-Each backup adapter takes it's own set of parameters, listed in the [Configuration options](../README.md#Configuration-options) section
-below. Refer to the table for the full list of parameters and place the configuration under the appropriate key: `backup.s3`,
-`backup.azure`, or `backup.google`.
+Each backup adapter takes it's own set of parameters, listed in the [Configuration options](../README.md#Configuration-options)
+section. Refer to the table for the full list of parameters and place the configuration under the appropriate key: `backups.s3`,
+`backups.azure`, or `backups.google`.
 
 ### Cluster configuration
 
 There are several important cluster options. Here are the most important ones:
 
 `cluster.instances` - The number of instances in the cluster. Defaults to `1`, but you should set this to `3` for production.
 `cluster.imageName` - This allows you to override the Docker image used for the cluster. The chart will choose a default
-  for you based on the setting you chose for `type`. If you need to run a configuration that is not supported, you can 
+  for you based on the setting you chose for `type`. If you need to run a configuration that is not supported, you can
   create your own Docker image. You can use the [postgres-containers](https://github.com/cloudnative-pg/postgres-containers)
   repository for a starting point.
   You will likely need to set your own repository access credentials via: `cluster.imagePullPolicy` and `cluster.imagePullSecrets`.
 `cluster.storage.size` - The size of the persistent volume claim for the cluster. Defaults to `8Gi`. Every instance will
-  have it's own persistent volume claim.
+  have its own persistent volume claim.
 `cluster.storage.storageClass` - The storage class to use for the persistent volume claim.
 `cluster.resources` - The resource limits and requests for the cluster. You are strongly advised to use the same values
   for both limits and requests to ensure a [Guaranteed QoS](https://kubernetes.io/docs/concepts/workloads/pods/pod-qos/#guaranteed).
@@ -93,7 +93,7 @@ There are several important cluster options. Here are the most important ones:
   cluster:
     postgresql:
       max_connections: "200"
-      shared_buffers: "2GB"  
+      shared_buffers: "2GB"
   ```
 `cluster.initSQL` - Allows you to run custom SQL queries during the cluster initialization. This is useful for creating
 extensions, schemas and databases. Note that these are as a superuser.
@@ -103,4 +103,4 @@ For a full list - refer to the Helm chart [configuration options](../README.md#C
 ## Examples
 
 There are several configuration examples in the [examples](../examples) directory. Refer to them for a basic setup and
-refer to  the [CloudNativePG Documentation](https://cloudnative-pg.io/documentation/current/) for more advanced configurations.
+refer to the [CloudNativePG Documentation](https://cloudnative-pg.io/documentation/current/) for more advanced configurations.
diff --git a/charts/cluster/docs/Recovery.md b/charts/cluster/docs/Recovery.md
@@ -16,9 +16,9 @@ When performing a recovery you are strongly advised to use the same configuratio
 
 To begin, create a `values.yaml` that contains the following:
 
-1. Set `mode: recovery` to indicate that you want to perform bootstrap the new cluster from an existing one.
+1. Set `mode: recovery` to indicate that you want to bootstrap the new cluster from an existing one.
 2. Set the `recovery.method` to the type of recovery you want to perform.
-3. Set either the `recovery.backupName` or the Barman Object Store configuration - i.e. `recovery.provider` and appropriate S3, Azure or GCS configuration. In case of `pg_basebackup` complete the `recovery.pgBaseBackup` section. 
+3. Set either the `recovery.backupName` or the Barman Object Store configuration - i.e. `recovery.provider` and appropriate S3, Azure or GCS configuration. In case of `pg_basebackup` complete the `recovery.pgBaseBackup` section.
 4. Optionally set the `recovery.pitrTarget.time` in RFC3339 format to perform a point-in-time recovery (not applicable for `pgBaseBackup`).
 5. Retain the identical PostgreSQL version and configuration as the original cluster.
 6. Make sure you don't use the same backup section name as the original cluster. We advise you change the `path` within the storage location if you want to reuse the same storage location/bucket.
diff --git a/charts/cluster/docs/runbooks/CNPGClusterHighPhysicalReplicationLagWarning.md b/charts/cluster/docs/runbooks/CNPGClusterHighPhysicalReplicationLagWarning.md
@@ -6,7 +6,7 @@ The `CNPGClusterHighPhysicalReplicationLagWarning` alert is triggered when physi
 
 ## Impact
 
-High physical replication lag can cause the cluster replicas to become out of sync. Queries to the `-r` and `-ro` endpoints may return stale data. In the event of a failover, the data that has not yet been replicated from the primary to the replicas may be lost during failover..
+High physical replication lag can cause the cluster replicas to become out of sync. Queries to the `-r` and `-ro` endpoints may return stale data. In the event of a failover, the data that has not yet been replicated from the primary to the replicas may be lost during failover.
 
 ## Diagnosis
 
@@ -34,7 +34,7 @@ Inspect the disk IO statistics using the [CloudNativePG Grafana Dashboard](https
 
 Inspect the `Stat Activity` section of the [CloudNativePG Grafana Dashboard](https://grafana.com/grafana/dashboards/20417-cloudnativepg/).
 
-- Suboptimal PostgreSQL configuration, e.g. too `few max_wal_senders`. Set this to at least the number of cluster instances (default 10 is usually sufficient).
+- Suboptimal PostgreSQL configuration, e.g. too few `max_wal_senders`. Set this to at least the number of cluster instances (default 10 is usually sufficient).
 
 Inspect the `PostgreSQL Parameters` section of the [CloudNativePG Grafana Dashboard](https://grafana.com/grafana/dashboards/20417-cloudnativepg/).
 
diff --git a/charts/cluster/docs/runbooks/CNPGClusterPhysicalReplicationLag.md b/charts/cluster/docs/runbooks/CNPGClusterPhysicalReplicationLag.md
@@ -175,7 +175,7 @@ SHOW max_replication_slots;
 
 ```bash
 # Check replication status
-kubectl exec -n <namespace> services/<cluster_name>-w -- psql -c "SELECT * FROM pg_stat_replication;"
+kubectl exec -n <namespace> services/<cluster_name>-rw -- psql -c "SELECT * FROM pg_stat_replication;"
 
 # Check resource usage
 kubectl top pods -n <namespace> -l cnpg.io/podRole=instance
diff --git a/charts/cluster/examples/custom-queries.yaml b/charts/cluster/examples/custom-queries.yaml
@@ -15,7 +15,7 @@ cluster:
         metrics:
           - datname:
               usage: "LABEL"
-              description: "Name of the database database"
+              description: "Name of the database"
           - ratio:
               usage: GAUGE
               description: "Cache hit ratio"
diff --git a/charts/cluster/monitoring/metrics-clusters_postgresql_cnpg_io.yaml b/charts/cluster/monitoring/metrics-clusters_postgresql_cnpg_io.yaml
@@ -86,7 +86,7 @@ spec:
                 primary: [status, currentPrimary]
 
         - name: "primary_failing_since_time"
-          help: "The timestamp when the primary was detected to be unhealthy This field is reported when .spec.failoverDelay is populated or during online upgrades"
+          help: "The timestamp when the primary was detected to be unhealthy. This field is reported when .spec.failoverDelay is populated or during online upgrades"
           each:
             type: Gauge
             gauge:
diff --git a/charts/cluster/prometheus_rules/cluster-low_disk_space-critical.yaml b/charts/cluster/prometheus_rules/cluster-low_disk_space-critical.yaml
@@ -7,15 +7,15 @@ annotations:
     CloudNativePG Cluster "{{ .namespace }}/{{ .cluster }}" is running extremely low on disk space. Check attached PVCs!
   runbook_url: https://github.com/cloudnative-pg/charts/blob/main/charts/cluster/docs/runbooks/CNPGClusterLowDiskSpaceCritical.md
 expr: |
-  max(max by(persistentvolumeclaim) (1 - kubelet_volume_stats_available_bytes{namespace="{{ .namespace }}", persistentvolumeclaim=~"{{ .podSelector }}"} / kubelet_volume_stats_capacity_bytes{namespace="{{ .namespace }}", persistentvolumeclaim=~"{{ .podSelector }}"})) > 0.9 OR
-  max(max by(persistentvolumeclaim) (1 - kubelet_volume_stats_available_bytes{namespace="{{ .namespace }}", persistentvolumeclaim=~"{{ .podSelector }}-wal"} / kubelet_volume_stats_capacity_bytes{namespace="{{ .namespace }}", persistentvolumeclaim=~"{{ .podSelector }}-wal"})) > 0.9 OR
+  max(max by(persistentvolumeclaim) (1 - kubelet_volume_stats_available_bytes{namespace="{{ .namespace }}", persistentvolumeclaim=~"{{ .podSelector }}"} / kubelet_volume_stats_capacity_bytes{namespace="{{ .namespace }}", persistentvolumeclaim=~"{{ .podSelector }}"})) * 100 > 90 OR
+  max(max by(persistentvolumeclaim) (1 - kubelet_volume_stats_available_bytes{namespace="{{ .namespace }}", persistentvolumeclaim=~"{{ .podSelector }}-wal"} / kubelet_volume_stats_capacity_bytes{namespace="{{ .namespace }}", persistentvolumeclaim=~"{{ .podSelector }}-wal"})) * 100 > 90 OR
   max(sum by (namespace,persistentvolumeclaim) (kubelet_volume_stats_used_bytes{namespace="{{ .namespace }}", persistentvolumeclaim=~"{{ .podSelector }}-tbs.*"})
       /
       sum by (namespace,persistentvolumeclaim) (kubelet_volume_stats_capacity_bytes{namespace="{{ .namespace }}", persistentvolumeclaim=~"{{ .podSelector }}-tbs.*"})
       *
       on(namespace, persistentvolumeclaim) group_left(volume)
       kube_pod_spec_volumes_persistentvolumeclaims_info{pod=~"{{ .podSelector }}"}
-  ) > 0.9
+  ) * 100 > 90
 for: 5m
 labels:
   severity: critical
diff --git a/charts/cluster/prometheus_rules/cluster-low_disk_space-warning.yaml b/charts/cluster/prometheus_rules/cluster-low_disk_space-warning.yaml
diff --git a/charts/cluster/templates/_barman_object_store.tpl b/charts/cluster/templates/_barman_object_store.tpl
diff --git a/charts/cluster/templates/_external_clusters.tpl b/charts/cluster/templates/_external_clusters.tpl
diff --git a/charts/cluster/templates/ca-bundle.yaml b/charts/cluster/templates/ca-bundle.yaml
diff --git a/charts/cluster/test/pooler/chainsaw-test.yaml b/charts/cluster/test/pooler/chainsaw-test.yaml

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,3 @@`
`1`		`-`
`2`	`1`	`Apache License`
`3`	`2`	`Version 2.0, January 2004`
`4`	`3`	`http://www.apache.org/licenses/`