add doc for ceph pool quota

[Muyan0828]

Summary by CodeRabbit

Documentation

• Added comprehensive guide for configuring storage pool quotas in Ceph, including step-by-step instructions for File, Block, and Object pool types with practical command examples, prerequisites, and validation procedures for administrators.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Walkthrough

A new documentation file has been added detailing how to configure storage pool quotas in Ceph for File, Block, and Object pools. The documentation includes command examples, parameter descriptions, prerequisites, and validation methods.

Changes

Cohort / File(s)	Summary
Ceph Storage Pool Quota Documentation docs/en/storage/storagesystem_ceph/how_to/pool_quota.mdx	New documentation file explaining how to set quotas on Ceph storage pools using kubectl patch with JSON patch syntax, covering pool types, parameters, and verification commands

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

• Straightforward documentation addition with no code or logic changes
• Review focus: verify technical accuracy of Ceph quota configuration commands and examples

Poem

A hop through docs so neat and bright,
Pool quotas written just right! 📚
From Ceph's commands, clear as day,
Quota wisdom comes to stay. 🐰✨

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'add doc for ceph pool quota' directly and clearly describes the main change: adding documentation for Ceph pool quota functionality.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch ceph-pool-quota

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 2

🧹 Nitpick comments (3)

docs/en/storage/storagesystem_ceph/how_to/pool_quota.mdx (3)

10-13: Consider adding kubectl access as a prerequisite.

The documentation assumes kubectl access to the cluster but doesn't explicitly list it as a prerequisite. Users should be aware they need cluster admin or appropriate RBAC permissions.

Consider adding:

- kubectl CLI access to the Ceph cluster with appropriate permissions

---

110-117: Clarify Ceph terminal access and improve validation example correlation.

The validation section assumes users can access a Ceph terminal but doesn't explain how. Additionally, the example output doesn't clearly correlate the pools shown to the quotas set in the earlier examples.

Consider:

1. Adding a note about how to access the Ceph terminal (e.g., via kubectl exec into a Ceph pod)
2. Explaining the relationship between the examples (e.g., the 107374182400 bytes shown equals 100Gi from the examples)
3. Making pool names in the validation example match the earlier command examples

---

1-117: Consider documenting quota modification and removal workflows.

The documentation successfully explains how to set quotas but doesn't cover modifying or removing them. Consider adding sections for:

1. Modifying a quota: How to change an existing quota value (would the "add" operation need to become "replace"?)
2. Removing a quota: How to unset a quota entirely
3. Quota behavior: What happens when a pool reaches its quota (rejected writes? warnings?)

These are optional enhancements that can improve the documentation's completeness.

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 9c5839d and c7bba8f.

📒 Files selected for processing (1)

• docs/en/storage/storagesystem_ceph/how_to/pool_quota.mdx (1 hunks)

[cloudflare-workers-and-pages]

Deploying alauda-container-platform with    Cloudflare Pages

Latest commit:	c7bba8f
Status:	✅  Deploy successful!
Preview URL:	https://f5d1dfc8.alauda-container-platform.pages.dev
Branch Preview URL:	https://ceph-pool-quota.alauda-container-platform.pages.dev

View logs