Skip to content

Document clearly that fsGroup does not apply to hostPath volumes - #57409

Open
IanEff wants to merge 1 commit into
kubernetes:mainfrom
IanEff:fix/138411-hostpath-fsgroup-docs
Open

Document clearly that fsGroup does not apply to hostPath volumes#57409
IanEff wants to merge 1 commit into
kubernetes:mainfrom
IanEff:fix/138411-hostpath-fsgroup-docs

Conversation

@IanEff

@IanEff IanEff commented Sep 3, 2026

Copy link
Copy Markdown

Description

fsGroup and fsGroupChangePolicy silently have no effect on hostPath volumes-- the kubelet never chowns a host directory, unlike managed volume types. This is documented for ephemeral volume types, but not for hostPath, so users hit it by trial and error.

This adds a caution o the hostPath volume type docs and a note tot he security condext docs' fsGroup discussion. Both point the user to local PersistentVolumes as the fsGroup-managed alternative.

Issue

Ref kubernetes/kubernetes#138411

This is docs-only clarification of expected behavior. See the triage from @wilmerdooley on that issue.

Signed-off-by: Ian Furst <ian.furst@gmail.com>
@kubernetes-prow kubernetes-prow Bot added the language/en Issues or PRs related to English language label Sep 3, 2026
@kubernetes-prow
kubernetes-prow Bot requested a review from saad-ali September 3, 2026 15:26
@kubernetes-prow

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign divya-mohan0209 for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@kubernetes-prow
kubernetes-prow Bot requested a review from thockin September 3, 2026 15:26
@kubernetes-prow

Copy link
Copy Markdown
Contributor

Welcome @IanEff!

It looks like this is your first PR to kubernetes/website 🎉. Please refer to our pull request process documentation to help your PR have a smooth ride to approval.

You will be prompted by a bot to use commands during the review process. Do not be afraid to follow the prompts! It is okay to experiment. Here is the bot commands documentation.

You can also check if kubernetes/website has its own contribution guidelines.

You may want to refer to our testing guide if you run into trouble with your tests not passing.

If you are having difficulty getting your pull request seen, please follow the recommended escalation practices. Also, for tips and tricks in the contribution process you may want to read the Kubernetes contributor cheat sheet. We want to make sure your contribution gets all the attention it needs!

Thank you, and welcome to Kubernetes. 😃

@kubernetes-prow kubernetes-prow Bot added size/S Denotes a PR that changes 10-29 lines, ignoring generated files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. labels Sep 3, 2026
@IanEff

IanEff commented Sep 4, 2026

Copy link
Copy Markdown
Author

/sig storage

@kubernetes-prow kubernetes-prow Bot added the sig/storage Categorizes an issue or PR as relevant to SIG Storage. label Sep 4, 2026
@IanEff

IanEff commented Sep 4, 2026

Copy link
Copy Markdown
Author

/sig docs

@kubernetes-prow kubernetes-prow Bot added the sig/docs Categorizes an issue or PR as relevant to SIG Docs. label Sep 4, 2026
@IanEff

IanEff commented Sep 4, 2026

Copy link
Copy Markdown
Author

/kind documentation

@kubernetes-prow kubernetes-prow Bot added the kind/documentation Categorizes issue or PR as related to documentation. label Sep 4, 2026
@IanEff

IanEff commented Sep 4, 2026

Copy link
Copy Markdown
Author

@wilmerdooley Would you mind taking a quick look at this, and see whether I captured everything from the comments in the underlying issue, kubernetes/kubernetes#138411?

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

Labels

cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. kind/documentation Categorizes issue or PR as related to documentation. language/en Issues or PRs related to English language sig/docs Categorizes an issue or PR as relevant to SIG Docs. sig/storage Categorizes an issue or PR as relevant to SIG Storage. size/S Denotes a PR that changes 10-29 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant