Skip to content
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

deprecate mc quota #1294

Merged
merged 2 commits into from
Aug 8, 2024
Merged

deprecate mc quota #1294

merged 2 commits into from
Aug 8, 2024

Conversation

feorlen
Copy link
Collaborator

@feorlen feorlen commented Aug 7, 2024

Bucket quotas don't work the way people think they work, as they cannot enforce hard limits. Deprecate in docs while we sort out what to do with the commands.

The future replacement is MinIO Enterprise Catalog.

Staged:
http://192.241.195.202:9000/staging/deprecate-bucket-quota/linux/reference/minio-mc-deprecated.html

See:
minio/mc#5011
minio/mc#5012

@@ -51,6 +51,22 @@ Table of Deprecated Commands
- :mc-cmd:`mc ilm rule rm`
- mc RELEASE.2022-12-24T15-21-38Z

* - ``mc quota``
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Not entirely sure what to do about mc quota itself. There's important information there about how bucket quota works (and why it's not what people think it is). So I don't want to just drop its page.

Maybe put that information into the deprecated mc quota set page instead? 🤔

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Ok, did the above so there's no mc quota page under deprecated.

Comment on lines +26 to +34
When a bucket with a quota configured reaches the specified limit, as determined by the MinIO object scanner, MinIO rejects further ``PUT`` requests for the bucket.

Each time the MinIO :ref:`object scanner <minio-lifecycle-management-scanner>` scans a bucket for pending :ref:`object lifecycle transitions <minio-lifecycle-management>`, it also checks if the bucket has exceeded a configured quota.

.. admonition:: Quota enforcement is not immediate
:class: note

Bucket quotas are not intended to enforce a strict hard limit on a bucket's size.
If a bucket exceeds its quota between scanner passes, MinIO continues to accept ``PUT`` requests for that bucket until _after_ the next scanner pass identifies the quota violation.
Copy link
Collaborator Author

@feorlen feorlen Aug 7, 2024

Choose a reason for hiding this comment

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

New content here, which is hard to tell because GitHub thinks the whole page is "new"

@feorlen feorlen marked this pull request as draft August 7, 2024 23:08
@feorlen feorlen marked this pull request as ready for review August 8, 2024 20:48
@feorlen feorlen merged commit 5865c3b into main Aug 8, 2024
@feorlen feorlen deleted the deprecate-bucket-quota branch August 8, 2024 20:58
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.

None yet

2 participants