Skip to content

Conversation

@lindhe
Copy link
Contributor

@lindhe lindhe commented Jan 26, 2026

This PR attempts to document the required S3 bucket policies required by the Barman Cloud plugin to work as intended.

Relevant documentation:

@lindhe
Copy link
Contributor Author

lindhe commented Jan 28, 2026

Doing some trial-and-error, these actions seems to be required:

  • s3:DeleteObject*
  • s3:GetObject
  • s3:ListBucket
  • s3:PutObject

I've also added these:

  • s3:AbortMultipartUpload
  • s3:ListMultipartUploadParts

I think it would make sense for Barman to utilize mutlipart uploads, but I'm not sure. Perhaps it does its own chunking and never requires large files?

* I've not seen a delete operation first-hand, but everyone I've spoken to seems to agree that retention policy can delete objects.

@lindhe lindhe marked this pull request as ready for review January 29, 2026 19:19
@lindhe lindhe requested a review from a team as a code owner January 29, 2026 19:19
@dosubot dosubot bot added size:M This PR changes 30-99 lines, ignoring generated files. documentation Improvements or additions to documentation labels Jan 29, 2026
@lindhe
Copy link
Contributor Author

lindhe commented Jan 29, 2026

After a few rounds of discussions and comments, and some trial-and-error on my side, I think this is ready for review.

I'm still not sure if actions for multi-part uploads are required or not. Maintainers help?

@lindhe
Copy link
Contributor Author

lindhe commented Jan 30, 2026

I just ran into an error with multipart upload! It is required. I'll add it.

Relevant docs:

Signed-off-by: Andreas Lindhé <7773090+lindhe@users.noreply.github.com>
Signed-off-by: Andreas Lindhé <7773090+lindhe@users.noreply.github.com>
Signed-off-by: Andreas Lindhé <7773090+lindhe@users.noreply.github.com>
@lindhe lindhe force-pushed the lindhe/s3-policy-docs branch from 0a79751 to 313b5cc Compare January 30, 2026 14:44
@lindhe
Copy link
Contributor Author

lindhe commented Jan 30, 2026

Strange, I'm still seeing the same errors:

ERROR: Backup failed uploading data (An error occurred (AccessDenied) when calling the CreateMultipartUpload operation: Access Denied)
ERROR: Backup failed uploading backup.info file (An error occurred (AccessDenied) when calling the PutObject operation: Access Denied)

EDIT: Oops, I had a typo in the username. 🙈 It works for me now, but I'm not 100% confident if the newly added permissions are strictly required or not anymore.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size:M This PR changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants