Repository navigation
Conversation
Contributor
|
🤖: Deployment available as https://docstest.simplyblock.io/docs-pnfs |
Contributor
There was a problem hiding this comment.
🟡 Changes recommended
Several requirements and verification steps incorrectly describe Linux pNFS behavior and could mislead operators.
8 open findings
Unconditionally claims clients bypass metadata server · New Incorrectly describes pNFS volume as supporting multiple logical volumes · New Bare-metal instances do not unconditionally expose /dev/kvm · New Initiator requirement incorrectly uses server-side NVMe callback · New Introduction incorrectly presents direct data path as unconditional · New Nested virtualization requirement incorrectly applies to bare-metal instances · New Worker requirement references wrong server-side NVMe capability · New Incorrectly lists server-side NVMe API as client requirement · New
What changed in this PR
Adds initial pNFS documentation for Kubernetes ReadWriteMany volumes, covering architecture, deployment requirements, configuration, operation, and terminology.
Changes:
- Documents pNFS architecture and lifecycle.
- Adds Kubernetes provisioning and troubleshooting guidance.
- Records kernel, KVM, distribution, and cloud requirements.
| File | Description |
|---|---|
docs/architecture/concepts/pnfs.md |
Explains pNFS architecture and lifecycle. |
docs/kubernetes/usage/pnfs.md |
Adds configuration and usage guidance. |
docs/kubernetes/usage/index.md |
Links the new usage page. |
docs/reference/supported-linux-kernels.md |
Adds pNFS kernel requirements. |
docs/reference/supported-linux-distributions.md |
Adds distribution validation status. |
docs/deployment-preparation/software-requirements.md |
Adds client software requirements. |
docs/deployment-preparation/hardware-requirements.md |
Adds KVM requirements. |
docs/deployment-preparation/cloud-instance-recommendations.md |
Adds cloud virtualization guidance. |
docs/important-notes/terminology.md |
Defines pNFS terminology. |
docs/important-notes/acronyms.md |
Adds related acronyms. |
🧠 Review effort: Balanced
💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
- Drop nvme_get_unique_id as a client requirement: it is called by nfsd on the metadata server, which brings its own kernel. The client needs the pNFS block layout driver with NVMe support (nvme-eui. lookup). - Remove the unverified RHEL 9.5 client claim and the 6.11 statement. - Qualify the direct data path where it read as unconditional. - Check the direct path with the per-operation counters, since pnfs=LAYOUT_SCSI does not change when a client falls back. - Narrow nested virtualization to virtualized instances, and stop promising /dev/kvm on bare-metal instances unconditionally. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Contributor
|
🤖: Deployment available as https://docstest.simplyblock.io/docs-pnfs |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.

No description provided.