Skip to content

add entry for naked pod #51236

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Conversation

dejanu
Copy link
Contributor

@dejanu dejanu commented Jun 11, 2025

Add a new entry for naked-pod to Glossary

Closes issue #51235

Signed-off-by: dejanualex <dejanualexandru@gmail.com>
@k8s-ci-robot k8s-ci-robot added cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. language/en Issues or PRs related to English language labels Jun 11, 2025
@k8s-ci-robot
Copy link
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 nate-double-u for approval. For more information see the Code Review Process.

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

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

@k8s-ci-robot k8s-ci-robot added the size/S Denotes a PR that changes 10-29 lines, ignoring generated files. label Jun 11, 2025
Copy link

netlify bot commented Jun 11, 2025

Pull request preview available for checking

Built without sensitive environment variables

Name Link
🔨 Latest commit 1e04a67
🔍 Latest deploy log https://app.netlify.com/projects/kubernetes-io-main-staging/deploys/6849ac2580f01700084dcc05
😎 Deploy Preview https://deploy-preview-51236--kubernetes-io-main-staging.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@lmktfy
Copy link
Contributor

lmktfy commented Jun 11, 2025

Thanks for the suggestion.

Could we call these a bare Pod? Naked is harder to localize and can have connotations we don't want.

@shurup
Copy link
Member

shurup commented Jun 12, 2025

Based on quick grep: while the "naked pod" term is used twice in the only document (concepts/configuration/overview.md), "bare pods" are mentioned on several pages (all belong to the concepts/workloads/controllers/ directory and once in a task). I guess we'll need to make it consistent throughout all documentation pages.


<!--more-->

Naked Pods will not be rescheduled in the event of a node failure.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Naked Pods will not be rescheduled in the event of a node failure.
Naked Pods will not be rescheduled in the event of a node failure.

Is this true if the pod's .spec.restartPolicy is set to Always

@reylejano
Copy link
Member

+1 to @lmktfy and @shurup 's comment to use bare pods

@tengqm
Copy link
Contributor

tengqm commented Jun 13, 2025

I'm leaning towards not adding this glossary.
If we need some clarification of "naked pod" or "bare pod", it means we should avoid using these terms.
Neither "naked pod" nor "bare pod" is widely used elsewhere AFAICT.
When we refer to something as A,

  • if A is widely used across the community but it could be new to beginners, we can add a glossary for it;
  • if A is used only as a metaphor and that metaphor may cause confusion, we should consider remove that metaphor rather than adding more texts to explain it.

In summary, please stop making a complex thing more complex!

@lmktfy
Copy link
Contributor

lmktfy commented Jun 15, 2025

The "bare Pod" concept is used only a few times on the web. I saw three.

Rewriting our existing pages, and adding no terminology for it, looks viable. We could call it a "Pod with no owners", for example.

@dejanu
Copy link
Contributor Author

dejanu commented Jun 17, 2025

I'm leaning towards not adding this glossary. If we need some clarification of "naked pod" or "bare pod", it means we should avoid using these terms. Neither "naked pod" nor "bare pod" is widely used elsewhere AFAICT. When we refer to something as A,

  • if A is widely used across the community but it could be new to beginners, we can add a glossary for it;
  • if A is used only as a metaphor and that metaphor may cause confusion, we should consider remove that metaphor rather than adding more texts to explain it.

In summary, please stop making a complex thing more complex!

@tengqm completely agreeing with you there's no need for bikeshedding, my perspective on the matter is that it can be added since personally I've seen beginners asking about naked Pod naming (in the context of static Pods) and at a quick glance, I could find some references to naked pod:

https://kubernetes.io/docs/concepts/configuration/overview/#naked-pods-vs-replicasets-deployments-and-jobs

image

https://learn.microsoft.com/en-us/azure/aks/policy-reference

image

https://hub.armosec.io/docs/c-0073

image

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. language/en Issues or PRs related to English language 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.

6 participants