Document kubelet subPath mkdir race condition in troubleshooting guide#750
Open
yerzhan7 wants to merge 1 commit into
Open
Document kubelet subPath mkdir race condition in troubleshooting guide#750yerzhan7 wants to merge 1 commit into
yerzhan7 wants to merge 1 commit into
Conversation
yerzhan7
had a problem deploying
to
approval-gate
GitHub Actions
Failure
jet-tong
force-pushed
the
doc/troubleshooting/subpath-kubelet
branch
from
87d079e to
b1b09b5
Compare
jet-tong
temporarily deployed
to
us-east-1-rosa-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
had a problem deploying
to
us-east-1-rosa-untrusted
GitHub Actions
Failure
jet-tong
temporarily deployed
to
us-east-1-untrusted
GitHub Actions
Inactive
jet-tong
reviewed
Mar 27, 2026
| This is a [known kubelet bug](https://github.com/kubernetes/kubernetes/issues/94198) where concurrent `subPath` directory creation races. It is more likely with the CSI driver v2 because multiple Pods [share a single Mountpoint instance](./MOUNTPOINT_POD_SHARING.md). A [fix](https://github.com/kubernetes/kubernetes/pull/134540) is pending upstream. | ||
|
|
||
| **Workarounds:** | ||
| - Use the `--prefix` mount option instead of Kubernetes `subPath` (see above). |
Collaborator
There was a problem hiding this comment.
np: perhaps link directly to how to use prefix mountOptions / show an example? That'll allow users to find out how to use this workaround quicker.
Comment on lines
+101
to
+102
| CreateContainerConfigError: failed to create subPath directory for volumeMount "data" of container "app": | ||
| cannot create directory /var/lib/kubelet/pods/.../mount/subdir: file exists |
Collaborator
There was a problem hiding this comment.
qq: Where is this referenced from? In upstream issue the error seems to be slightly different in this format:
failed to create subPath directory for volumeMount "xxx" of container "xxx": cannot create directory /var/lib/kubelet/pods/xxx: file exists
# and finally
... container start failed: CreateContainerConfigError: failed to create subPath directory for volumeMount "xxx" of container "xxx"Just wanted to make sure for better error match when users search for it.
| cannot create directory /var/lib/kubelet/pods/.../mount/subdir: file exists | ||
| ``` | ||
|
|
||
| This is a [known kubelet bug](https://github.com/kubernetes/kubernetes/issues/94198) where concurrent `subPath` directory creation races. It is more likely with the CSI driver v2 because multiple Pods [share a single Mountpoint instance](./MOUNTPOINT_POD_SHARING.md). A [fix](https://github.com/kubernetes/kubernetes/pull/134540) is pending upstream. |
Collaborator
There was a problem hiding this comment.
np: where concurrent subPath directory creations race (concurrent = multiple)
alt: caused by a race condition during concurrent subPath directory creation.
jet-tong
had a problem deploying
to
us-east-1-rosa-untrusted
GitHub Actions
Failure
jet-tong
had a problem deploying
to
us-east-1-rosa-untrusted
GitHub Actions
Failure
jet-tong
had a problem deploying
to
us-east-1-rosa-untrusted
GitHub Actions
Failure
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
2 participants
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.
Issue #, if available: N/A
Description of changes: Document kubelet subPath mkdir race condition in troubleshooting guide
By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.