plugin-barman-cloud/web/docs
David Almgren 77113f68df feat: expose showAdditionalCommandArgs and listAdditionalCommandArgs
An ObjectStore lets users tack extra command-line flags onto four of
the six barman-cloud-* invocations the plugin shells out to:
barman-cloud-backup (data.additionalCommandArgs), -wal-archive
(wal.archiveAdditionalCommandArgs), -wal-restore
(wal.restoreAdditionalCommandArgs), and -restore (data.restoreAdditionalCommandArgs,
PR #914).

The remaining two -- barman-cloud-backup-show (post-write verification)
and barman-cloud-backup-list (retention pruning) -- had no equivalent,
which is the gap reported in #712. On strictly-vhost S3-compatible
endpoints users need `--addressing-style=virtual` on every cloud
command, and currently those two reject the user-provided args, marking
otherwise-successful backups as failed and silently disabling retention
pruning.

The library-side change adds the two new fields and helpers (sister PR
in cloudnative-pg/barman-cloud) and threads them through GetBackupList /
GetBackupByName. This plugin commit just exposes them via the CRD and
documents the new shape.

## Sister PR (must merge first)

The CRD field schema is generated from the BarmanObjectStoreConfiguration
Go type in cloudnative-pg/barman-cloud. The sister PR there adds:

- DataBackupConfiguration.ShowAdditionalCommandArgs []string
- DataBackupConfiguration.ListAdditionalCommandArgs []string
- AppendShowAdditionalCommandArgs / AppendListAdditionalCommandArgs helpers

Once that PR merges and a barman-cloud release is cut, controller-gen
here picks up the new fields automatically. Until then a developer
running \`go test ./...\` against this branch needs a local replace
directive in go.mod pointing at the barman-cloud branch (omitted from
this commit).

Closes #712

Signed-off-by: David Almgren <dalmgren@coreweave.com>
2026-05-26 12:19:13 +02:00
..
compression.md fix: add lz4 compression support for base backups (#868) 2026-04-21 19:23:45 +02:00
concepts.md docs: add migration guide from in-tree to plugin-based Barman Cloud (#316) 2025-05-07 10:41:51 +02:00
images.md docs: document the container images (#317) 2025-05-07 10:59:32 +02:00
installation.mdx docs: avoid using grep to parse kubectl output (#404) 2025-07-02 11:57:52 +02:00
intro.md docs: add troubleshooting section (#509) 2025-09-22 16:47:56 +02:00
migration.md docs: clarify observability metrics and migration to plugin-based ones (#621) 2025-10-27 16:39:14 +01:00
misc.md feat: expose showAdditionalCommandArgs and listAdditionalCommandArgs 2026-05-26 12:19:13 +02:00
object_stores.md Remove mention of objects never being deleted (#750) 2026-01-30 14:56:26 +01:00
observability.md docs: clarify observability metrics and migration to plugin-based ones (#621) 2025-10-27 16:39:14 +01:00
parameters.md docs: plugin parameters (#330) 2025-05-09 13:20:18 +02:00
plugin-barman-cloud.v1.md feat: introduce logLevel setting to control verbosity (#536) 2025-09-24 12:32:59 +02:00
resource-name-migration.md feat(rbac)!: prefix all resource names to avoid cluster conflicts (#593) 2025-10-27 15:08:11 +01:00
retention.md docs: add backup, WAL archive and recovery information (#291) 2025-05-06 11:49:09 +02:00
troubleshooting.md Remove mention of s3UsePathStyle setting (#745) 2026-01-29 17:42:20 +01:00
upgrades.mdx feat(rbac)!: prefix all resource names to avoid cluster conflicts (#593) 2025-10-27 15:08:11 +01:00
usage.md fix(docs): update broken link to CloudNativePG documentation (#904) 2026-05-12 10:46:04 +02:00