Skip to content

docs(troubleshooting): explain the "no backup section" error - #1166

Merged
mnencia merged 2 commits into
cloudnative-pg:mainfrom
fjvbn2003:docs-troubleshooting-no-backup-section
Nov 9, 2026
Merged

mnencia merged 2 commits into
cloudnative-pg:mainfrom
fjvbn2003:docs-troubleshooting-no-backup-section

Conversation

@fjvbn2003

@fjvbn2003 fjvbn2003 commented Oct 16, 2026 •

Copy link
Copy Markdown
Contributor

Backups without method: plugin fall back to barmanObjectStore, which needs a .spec.backup section in the Cluster. A Cluster that uses the plugin usually has none, so the backup fails with "cannot proceed with the backup as the cluster has no backup section". Add this error to the "Backup job fails immediately" entries of the troubleshooting guide, with the fix for Backup, ScheduledBackup and kubectl cnpg backup.

Closes #1165

Assisted-by: Claude


Original description by the author:

Closes #1165

Adds the error cannot proceed with the backup as the cluster has no backup section to "Backup job fails immediately" in troubleshooting.md.

The cause is a Backup or ScheduledBackup without method: plugin: method
defaults to barmanObjectStore, and the operator then requires a
.spec.backup section that a Cluster using the plugin usually does not have
(internal/controller/backup_controller.go in the operator). The entry shows
the fix for the resources and for kubectl cnpg backup (-m plugin --plugin-name barman-cloud.cloudnative-pg.io), as discussed in #353.

How I checked: on CNPG 1.30, kubectl explain backup.spec.method and the
Backup and ScheduledBackup CRDs both show the barmanObjectStore default.
I hit the error with a ScheduledBackup after migrating to the plugin, and
adding method: plugin fixed it.

This change was drafted with AI assistance and reviewed by me.

🤖 Generated with Claude Code

A Backup or ScheduledBackup without method: plugin falls back to the
default barmanObjectStore method. The operator then requires a
.spec.backup section in the Cluster, which a Cluster using the plugin
usually does not have, and the backup fails with "cannot proceed with
the backup as the cluster has no backup section".

Add this to the list of immediate backup failures, with the fix for
Backup and ScheduledBackup resources and for kubectl cnpg backup, as
discussed in cloudnative-pg#353.

Assisted-by: Claude Opus 5.5
Signed-off-by: YoungjuKim <[email protected]>
@mnencia
mnencia force-pushed the docs-troubleshooting-no-backup-section branch from d2613f6 to 7123c82 Compare November 9, 2026 16:23
@mnencia
mnencia force-pushed the docs-troubleshooting-no-backup-section branch from 9fc626c to e3e226d Compare November 9, 2026 16:31
The failure is set on the Backup status and events, and the backup never
starts. The kubectl cnpg example now uses the long flags, like the usage
page.

Assisted-by: Claude Sonnet 5.5
Signed-off-by: Marco Nenciarini <[email protected]>
@mnencia
mnencia force-pushed the docs-troubleshooting-no-backup-section branch from e3e226d to 6c0269d Compare November 9, 2026 16:32
@mnencia
mnencia merged commit 21fee10 into cloudnative-pg:main Nov 9, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: troubleshooting does not cover "cannot proceed with the backup as the cluster has no backup section"

3 participants