pal-e-docs

Subphase 4a: Barman Cloud Plugin Migration

phase-postgres-4a-barman-plugin-migration Phase

Project
Goal: Migrate from native barman-cloud (deprecated) to the Barman Cloud Plugin before CNPG 1.29 removes native support.
Owner: Dev agent
Repo: pal-e-platform (Helm values for CNPG operator + plugin deployment)
Priority: Must complete before upgrading CNPG operator to 1.29+

Context

CNPG 1.28.1 (current) shows this deprecation warning on every Cluster/Backup CRD that uses barmanObjectStore:
Native support for Barman Cloud backups and recovery is deprecated and will be completely removed in CloudNativePG 1.29.0. Please migrate existing clusters to the new Barman Cloud Plugin.
Discovered during Phase 4 restore testing (2026-03-06). Every recovery Cluster CRD triggered the warning.

What Changes

  • Install the barman-cloud plugin (separate Helm chart or kubectl plugin install)
  • Update pal-e-postgres Cluster CRD to use plugin-based backup config instead of native barmanObjectStore
  • Update ScheduledBackup CRD if needed
  • Update sop-postgres-restore recovery CRD template
  • Test backup + restore with plugin-based config

When

Before any CNPG operator upgrade to 1.29+. Not urgent while on 1.28.1, but must be done proactively.

See also

  • phase-postgres-4-backup-restore — parent phase where this was discovered
  • CNPG docs: Barman Cloud Plugin migration guide