marco/plugin-barman-cloud
1
0
Fork 0
mirror of https://github.com/cloudnative-pg/plugin-barman-cloud.git synced 2026-01-12 05:33:11 +01:00
Code Issues Actions Packages Projects Releases Wiki Activity

docs: review

Browse Source 
Signed-off-by: Gabriele Bartolini <gabriele.bartolini@enterprisedb.com>
This commit is contained in:
Gabriele Bartolini 2025-05-09 08:38:41 +02:00
parent e89f09cced
commit 788d2a1cbc
1 changed files with 12 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
web/docs/migration.md
View File

@ -20,6 +20,7 @@ Cloud Plugin, with **no downtime**. Follow these steps:
- Modify the `Cluster` resource in a single atomic change to switch from - Modify the `Cluster` resource in a single atomic change to switch from
in-tree backup to the plugin in-tree backup to the plugin
- Update any `ScheduledBackup` resources to use the plugin - Update any `ScheduledBackup` resources to use the plugin
- Update the `externalClusters` configuration, where applicable
:::tip :::tip
For a working example, refer to [this commit](https://github.com/cloudnative-pg/cnpg-playground/commit/596f30e252896edf8f734991c3538df87630f6f7) For a working example, refer to [this commit](https://github.com/cloudnative-pg/cnpg-playground/commit/596f30e252896edf8f734991c3538df87630f6f7)
@ -175,22 +176,23 @@ spec:
--- ---
## Step 4: Update `externalClusters` configuration ## Step 4: Update the `externalClusters` configuration
If the cluster has external clusters that use the built-in Barman If your `Cluster` relies on one or more external clusters that use the in-tree
Cloud integration, you'll need to update those configurations as well. Barman Cloud integration, you need to update those configurations to use the
plugin-based architecture.
When a cluster is configured as a replica using an external Barman Cloud backup, When a replica cluster fetches WAL files or base backups from an external
you need to: source that used the built-in backup method, follow these steps:
1. Create an `ObjectStore` resource for the external cluster, similar to the one 1. Create a corresponding `ObjectStore` resource for the external cluster, as
created in [step 1](#step-1-define-the-objectstore) shown in [Step 1](#step-1-define-the-objectstore)
2. Update the `externalClusters` section in your replica cluster to reference 2. Update the `externalClusters` section of your replica cluster to use the
the plugin plugin instead of the in-tree `barmanObjectStore` field
### Example ### Example
Original external cluster configuration using in-tree backup: Consider the original configuration using in-tree Barman Cloud:
```yaml ```yaml
apiVersion: postgresql.cnpg.io/v1 apiVersion: postgresql.cnpg.io/v1