diff --git a/config/crd/bases/barmancloud.cnpg.io_objectstores.yaml b/config/crd/bases/barmancloud.cnpg.io_objectstores.yaml index f8688ce0..5091f7dd 100644 --- a/config/crd/bases/barmancloud.cnpg.io_objectstores.yaml +++ b/config/crd/bases/barmancloud.cnpg.io_objectstores.yaml @@ -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: |- diff --git a/manifest.yaml b/manifest.yaml index 3b99c39b..676f89ee 100644 --- a/manifest.yaml +++ b/manifest.yaml @@ -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: |- diff --git a/web/docs/misc.md b/web/docs/misc.md index 0f03b284..1f6ac3c7 100644 --- a/web/docs/misc.md +++ b/web/docs/misc.md @@ -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.