feat: plugin-barman-cloud

README.md

@@ -116,8 +116,12 @@ control plane node in both Kubernetes clusters, run the following commands:
 kubectl cnpg install generate --control-plane | \
   kubectl --context kind-k8s-eu apply -f - --server-side
 
+kubectl --context kind-k8s-eu rollout status deployment -n cnpg-system cnpg-controller-manager
+
 kubectl cnpg install generate --control-plane | \
   kubectl --context kind-k8s-us apply -f - --server-side
+
+kubectl --context kind-k8s-us rollout status deployment -n cnpg-system cnpg-controller-manager
 ```
 
 These commands will deploy the CloudNativePG operator with server-side apply on
@@ -126,6 +130,26 @@ both the `kind-k8s-eu` and `kind-k8s-us` clusters.
 Ensure that you have the latest version of the `cnpg` plugin installed on your
 local machine.
 
+## To install the barman-cloud backup plugin
+
+Install [cert-manager](https://cert-manager.io/docs/installation/):
+
+```bash
+kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.16.2/cert-manager.yaml
+
+kubectl rollout status deployment -n cert-manager cert-manager
+kubectl rollout status deployment -n cert-manager cert-manager-cainjector
+kubectl rollout status deployment -n cert-manager cert-manager-webhook
+```
+
+Install the [barman-cloud plugin](https://github.com/cloudnative-pg/plugin-barman-cloud):
+
+```bash
+kubectl apply -f https://raw.githubusercontent.com/cloudnative-pg/plugin-barman-cloud/refs/heads/main/manifest.yaml
+
+kubectl rollout status deployment -n cnpg-system barman-cloud
+```
+
 ## Cleaning up the Learning Environment
 
 When you're ready to clean up and remove all resources from the learning
@@ -158,3 +182,23 @@ sudo sysctl fs.inotify.max_user_instances=512
 ```
 
 More information in the [relative ticket comment](https://github.com/kubernetes-sigs/kind/issues/3423#issuecomment-1872074526).
+
+## Using Rancher Desktop
+
+You may need to follow the instructions [in the Rancher Desktop
+Guide](https://docs.rancherdesktop.io/how-to-guides/increasing-open-file-limit/)
+to increase the open file limit.
+
+```
+provision:
+- mode: system
+  script: |
+    #!/bin/sh
+    cat <<'EOF' > /etc/security/limits.d/rancher-desktop.conf
+    * soft     nofile         82920
+    * hard     nofile         82920
+    EOF
+    sysctl -w vm.max_map_count=262144
+    sysctl fs.inotify.max_user_watches=524288
+    sysctl fs.inotify.max_user_instances=512
+```

examples/eu/pg-eu.yaml

@@ -43,19 +43,11 @@ spec:
       shared_memory_type: 'sysv'
       dynamic_shared_memory_type: 'sysv'
 
-  backup:
-    barmanObjectStore:
-      destinationPath: s3://backups/
-      endpointURL: http://minio-eu:9000
-      s3Credentials:
-        accessKeyId:
-          name: minio-eu
-          key: ACCESS_KEY_ID
-        secretAccessKey:
-          name: minio-eu
-          key: ACCESS_SECRET_KEY
-      wal:
-        compression: gzip
+  plugins:
+  - name: barman-cloud.cloudnative-pg.io
+    parameters:
+      barmanObjectName: minio-eu
+      serverName: pg-eu
 
   # See https://cloudnative-pg.io/documentation/current/replica_cluster/#distributed-topology
   replica:
@@ -65,42 +57,29 @@ spec:
 
   externalClusters:
   - name: pg-eu
-    barmanObjectStore:
-      serverName: pg-eu
-      destinationPath: s3://backups/
-      endpointURL: http://minio-eu:9000
-      s3Credentials:
-        accessKeyId:
-          name: minio-eu
-          key: ACCESS_KEY_ID
-        secretAccessKey:
-          name: minio-eu
-          key: ACCESS_SECRET_KEY
-      wal:
-        compression: gzip
+    plugin:
+      name: barman-cloud.cloudnative-pg.io
+      parameters:
+        barmanObjectName: minio-eu
+        serverName: pg-eu
   - name: pg-us
-    barmanObjectStore:
-      serverName: pg-us
-      destinationPath: s3://backups/
-      endpointURL: http://minio-us:9000
-      s3Credentials:
-        accessKeyId:
-          name: minio-us
-          key: ACCESS_KEY_ID
-        secretAccessKey:
-          name: minio-us
-          key: ACCESS_SECRET_KEY
-      wal:
-        compression: gzip
+    plugin:
+      name: barman-cloud.cloudnative-pg.io
+      parameters:
+        barmanObjectName: minio-us
+        serverName: pg-us
 ---
 # See https://cloudnative-pg.io/documentation/current/backup/#scheduled-backups
 apiVersion: postgresql.cnpg.io/v1
 kind: ScheduledBackup
 metadata:
   name: pg-eu-backup
 spec:
+  method: plugin
   schedule: '0 0 0 * * *'
   backupOwnerReference: self
   cluster:
     name: pg-eu
+  pluginConfiguration:
+    name: barman-cloud.cloudnative-pg.io
   immediate: true

examples/object-stores/minio-eu.yaml

@@ -0,0 +1,17 @@
+apiVersion: barmancloud.cnpg.io/v1
+kind: ObjectStore
+metadata:
+  name: minio-eu
+spec:
+  configuration:
+    destinationPath: s3://backups/
+    endpointURL: http://minio-eu:9000
+    s3Credentials:
+      accessKeyId:
+        name: minio-eu
+        key: ACCESS_KEY_ID
+      secretAccessKey:
+        name: minio-eu
+        key: ACCESS_SECRET_KEY
+    wal:
+      compression: gzip

examples/object-stores/minio-us.yaml

@@ -0,0 +1,17 @@
+apiVersion: barmancloud.cnpg.io/v1
+kind: ObjectStore
+metadata:
+  name: minio-us
+spec:
+  configuration:
+    destinationPath: s3://backups/
+    endpointURL: http://minio-us:9000
+    s3Credentials:
+      accessKeyId:
+        name: minio-us
+        key: ACCESS_KEY_ID
+      secretAccessKey:
+        name: minio-us
+        key: ACCESS_SECRET_KEY
+    wal:
+      compression: gzip

examples/us/pg-us.yaml

@@ -43,6 +43,12 @@ spec:
       shared_memory_type: 'sysv'
       dynamic_shared_memory_type: 'sysv'
 
+  plugins:
+  - name: barman-cloud.cloudnative-pg.io
+    parameters:
+      barmanObjectName: minio-us
+      serverName: pg-us
+
   backup:
     barmanObjectStore:
       destinationPath: s3://backups/
@@ -65,42 +71,29 @@ spec:
 
   externalClusters:
   - name: pg-eu
-    barmanObjectStore:
-      serverName: pg-eu
-      destinationPath: s3://backups/
-      endpointURL: http://minio-eu:9000
-      s3Credentials:
-        accessKeyId:
-          name: minio-eu
-          key: ACCESS_KEY_ID
-        secretAccessKey:
-          name: minio-eu
-          key: ACCESS_SECRET_KEY
-      wal:
-        compression: gzip
+    plugin:
+      name: barman-cloud.cloudnative-pg.io
+      parameters:
+        barmanObjectName: minio-eu
+        serverName: pg-eu
   - name: pg-us
-    barmanObjectStore:
-      serverName: pg-us
-      destinationPath: s3://backups/
-      endpointURL: http://minio-us:9000
-      s3Credentials:
-        accessKeyId:
-          name: minio-us
-          key: ACCESS_KEY_ID
-        secretAccessKey:
-          name: minio-us
-          key: ACCESS_SECRET_KEY
-      wal:
-        compression: gzip
+    plugin:
+      name: barman-cloud.cloudnative-pg.io
+      parameters:
+        barmanObjectName: minio-us
+        serverName: pg-us
 ---
 # See https://cloudnative-pg.io/documentation/current/backup/#scheduled-backups
 apiVersion: postgresql.cnpg.io/v1
 kind: ScheduledBackup
 metadata:
   name: pg-us-backup
 spec:
+  method: plugin
   schedule: '0 0 0 * * *'
   backupOwnerReference: self
   cluster:
     name: pg-us
+  pluginConfiguration:
+    name: barman-cloud.cloudnative-pg.io
   immediate: true