-
Notifications
You must be signed in to change notification settings - Fork 15.2k
Open
Labels
language/enIssues or PRs related to English languageIssues or PRs related to English languagelanguage/zhIssues or PRs related to Chinese languageIssues or PRs related to Chinese languageneeds-triageIndicates an issue or PR lacks a `triage/foo` label and requires one.Indicates an issue or PR lacks a `triage/foo` label and requires one.sig/docsCategorizes an issue or PR as relevant to SIG Docs.Categorizes an issue or PR as relevant to SIG Docs.
Description
Description
The image volume documentation contains incorrect kubectl attach commands that will not work as intended.
Problem
The documentation currently uses kubectl attach -it image-volume bash, which:
- Includes an invalid
bashargument (kubectl attach doesn't accept command arguments) - Cannot provide interactive shell access when the container's main process is
sleep infinity - Will result in "Unable to use a TTY" errors for users
Expected Behavior
The documentation should use kubectl exec -it image-volume -- bash to correctly:
- Start a new bash process inside the container
- Provide proper interactive terminal access
- Follow Kubernetes best practices for container interaction
Affected Files
English documentation:
content/en/docs/tasks/configure-pod-container/image-volumes.md(2 occurrences)content/en/blog/_posts/2025-04-29-image-volume-beta/index.md(1 occurrence)
Chinese documentation:
content/zh-cn/docs/tasks/configure-pod-container/image-volumes.md(2 occurrences)content/zh-cn/blog/_posts/2025-04-29-image-volume-beta/index.md(1 occurrence)
Proposed Solution
Replace all instances of:
kubectl attach -it image-volume bashWith:
kubectl exec -it image-volume -- bashAdditional Context
- Related KEP: VolumeSource: OCI Artifact and/or Image enhancements#4639
- Feature blog: https://kubernetes.io/blog/2024/08/16/kubernetes-1-31-image-volume-source
- The issue affects both English and Chinese localizations
- Following contribution guidelines, fixes will be submitted as separate PRs for each language
/sig docs
/language en
/language zh
Metadata
Metadata
Assignees
Labels
language/enIssues or PRs related to English languageIssues or PRs related to English languagelanguage/zhIssues or PRs related to Chinese languageIssues or PRs related to Chinese languageneeds-triageIndicates an issue or PR lacks a `triage/foo` label and requires one.Indicates an issue or PR lacks a `triage/foo` label and requires one.sig/docsCategorizes an issue or PR as relevant to SIG Docs.Categorizes an issue or PR as relevant to SIG Docs.