marco/plugin-barman-cloud
1
0
Fork 0
mirror of https://github.com/cloudnative-pg/plugin-barman-cloud.git synced 2026-07-06 17:52:21 +02:00
Code Issues Packages Projects Releases Wiki Activity

Merge 77113f68df into 0bb78879ce

Browse Source
This commit is contained in:
David Almgren 2026-05-28 16:32:20 +02:00 committed by GitHub
commit 9581ac8a1f
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
3 changed files with 73 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
config/crd/bases/barmancloud.cnpg.io_objectstores.yaml
View File

@ -176,6 +176,37 @@ spec:
format: int32
minimum: 1
type: integer
listAdditionalCommandArgs:
description: |-
ListAdditionalCommandArgs represents additional arguments that can be appended
to the 'barman-cloud-backup-list' command-line invocation. This command is
used internally for retention-policy enforcement; flags relevant to the
underlying S3 client (e.g. `--addressing-style=virtual` for strictly
virtual-hosted S3-compatible endpoints) generally belong here as well.
Note:
It's essential to ensure that the provided arguments are valid and supported
by the 'barman-cloud-backup-list' command, to avoid potential errors or
unintended behavior during execution.
items:
type: string
type: array
showAdditionalCommandArgs:
description: |-
ShowAdditionalCommandArgs represents additional arguments that can be appended
to the 'barman-cloud-backup-show' command-line invocation. This command is
used after a successful upload to verify and record metadata about the
freshly-written backup, so flags relevant to the underlying S3 client
(e.g. `--addressing-style=virtual` for strictly virtual-hosted S3-compatible
endpoints) generally belong here as well.
Note:
It's essential to ensure that the provided arguments are valid and supported
by the 'barman-cloud-backup-show' command, to avoid potential errors or
unintended behavior during execution.
items:
type: string
type: array
type: object
destinationPath:
description: |-

31
manifest.yaml
View File

@ -175,6 +175,37 @@ spec:
format: int32
minimum: 1
type: integer
listAdditionalCommandArgs:
description: |-
ListAdditionalCommandArgs represents additional arguments that can be appended
to the 'barman-cloud-backup-list' command-line invocation. This command is
used internally for retention-policy enforcement; flags relevant to the
underlying S3 client (e.g. `--addressing-style=virtual` for strictly
virtual-hosted S3-compatible endpoints) generally belong here as well.
Note:
It's essential to ensure that the provided arguments are valid and supported
by the 'barman-cloud-backup-list' command, to avoid potential errors or
unintended behavior during execution.
items:
type: string
type: array
showAdditionalCommandArgs:
description: |-
ShowAdditionalCommandArgs represents additional arguments that can be appended
to the 'barman-cloud-backup-show' command-line invocation. This command is
used after a successful upload to verify and record metadata about the
freshly-written backup, so flags relevant to the underlying S3 client
(e.g. `--addressing-style=virtual` for strictly virtual-hosted S3-compatible
endpoints) generally belong here as well.
Note:
It's essential to ensure that the provided arguments are valid and supported
by the 'barman-cloud-backup-show' command, to avoid potential errors or
unintended behavior during execution.
items:
type: string
type: array
type: object
destinationPath:
description: |-

15
web/docs/misc.md
View File

@ -32,15 +32,22 @@ spec:
[...]
```
## Extra Options for Backup and WAL Archiving
## Extra Options for Backup, WAL Archiving, Show, and List
You can pass additional command-line arguments to `barman-cloud-backup` and
`barman-cloud-wal-archive` using the `additionalCommandArgs` field in the
`ObjectStore` configuration.
You can pass additional command-line arguments to each barman-cloud
invocation the plugin shells out to, using the matching
`additionalCommandArgs` fields in the `ObjectStore` configuration.
- `.spec.configuration.data.additionalCommandArgs`: for `barman-cloud-backup`
- `.spec.configuration.data.showAdditionalCommandArgs`: for `barman-cloud-backup-show` (post-write verification)
- `.spec.configuration.data.listAdditionalCommandArgs`: for `barman-cloud-backup-list` (retention pruning)
- `.spec.configuration.wal.archiveAdditionalCommandArgs`: for `barman-cloud-wal-archive`
If you need a flag that applies to every cloud command — such as
`--addressing-style=virtual` for an S3-compatible endpoint that only
accepts virtual-hosted-style requests — set it on all of the above so
both writes and the post-write read-back / retention steps honor it.
Each field accepts a list of string arguments. If an argument is already
configured elsewhere in the plugin, the duplicate will be ignored.