Skip to content

docs: update s3 doc to indicate endpoint shouldn't include the bucket name prefix #11039

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

joobisb
Copy link

@joobisb joobisb commented Mar 28, 2025

… name prefix

What this PR does

Document the s3 object storage endpoint must not prefixed with the bucket name.

Which issue(s) this PR fixes or relates to

Fixes #9177

Checklist

  • Tests updated.
  • Documentation added.
  • CHANGELOG.md updated - the order of entries should be [CHANGE], [FEATURE], [ENHANCEMENT], [BUGFIX].
  • about-versioning.md updated with experimental features.

@joobisb joobisb requested review from tacole02 and a team as code owners March 28, 2025 07:16
@joobisb
Copy link
Author

joobisb commented Apr 2, 2025

@tacole02 could you please have a look at this PR?

@francoposa
Copy link
Member

from the Mimir dev team side, this is accurate, will wait for @tacole02's take from the docs side

@@ -83,6 +83,10 @@ ruler_storage:
bucket_name: mimir-ruler
```

{{< admonition type="note" >}}
The endpoint value must not be prefixed with your bucket name (e.g., if your bucket is "my-storage-bucket", the endpoint cannot be "my-storage-bucket.s3.amazonaws.com").
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The endpoint value must not be prefixed with your bucket name (e.g., if your bucket is "my-storage-bucket", the endpoint cannot be "my-storage-bucket.s3.amazonaws.com").
Don't prefix the endpoint value with your bucket name. For example, if your bucket is named "my-storage-bucket", you cannot name the endpoint "my-storage-bucket.s3.amazonaws.com").

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tacole02 I've addressed the comment, please have a look

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great! Thank you so much, @joobisb !

@tacole02
Copy link
Contributor

This PR looks good. Is there anything preventing its merge?

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.

"The endpoint must not prefixed with the bucket name" error when bucket name matches beginning of S3 endpoint
3 participants