Skip to content

docs: note kubeadm inherits -v from the parent command - #57036

Open
locker95 wants to merge 3 commits into
kubernetes:mainfrom
locker95:docs/kubeadm-inherited-v
Open

locker95 wants to merge 3 commits into
kubernetes:mainfrom
locker95:docs/kubeadm-inherited-v

Conversation

@locker95

Copy link
Copy Markdown
Contributor

The generated options table on the kubeadm init page only lists init-specific flags. People look there for a verbosity switch and miss -v, which lives on the parent kubeadm command.

Added a short note after the table. --v=10 is what neolit123 suggested for API traces; --rootfs is mentioned because it's the other inherited flag.

Fixes #48717


This PR was written in part with the assistance of generative AI.

The generated kubeadm init options table omits global flags. -v/--v
is how you get verbose logs; it lives on kubeadm itself, not on init.

Signed-off-by: Dean Chen <862469039@qq.com>
@kubernetes-prow kubernetes-prow Bot added language/en Issues or PRs related to English language cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. size/S Denotes a PR that changes 10-29 lines, ignoring generated files. labels Aug 17, 2026
@netlify

netlify Bot commented Aug 17, 2026

Copy link
Copy Markdown

Pull request preview available for checking

Built without sensitive environment variables

Name Link
🔨 Latest commit 001421a
🔍 Latest deploy log https://app.netlify.com/projects/kubernetes-io-main-staging/deploys/6a85e4750bc4610008550380
😎 Deploy Preview https://deploy-preview-57036--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.


{{< include "generated/kubeadm_init/_index.md" >}}

### Inherited global flags {#inherited-global-flags}

@neolit123 neolit123 Aug 18, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

why only kubeadm init?

all kubeadm commands support the --v flag of klog.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

yeah — it is on the parent command, so join/reset/upgrade get it too. pulled the note into a shared include and dropped it on those pages.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

yeah, it is not init-only — -v sits on the parent kubeadm command. I put the same note on the other subcommand pages and on the kubeadm landing page.

-v/--v lives on the parent kubeadm command, so join/upgrade/reset
and the rest inherit it too. Share one note across those pages.

Signed-off-by: Dean Chen <862469039@qq.com>
@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 salaxander 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

Same parent-command flags on upgrade/token/config/certs/version
and the kubeadm landing page, not only init/join/reset.

Signed-off-by: Dean Chen <862469039@qq.com>
@kubernetes-prow kubernetes-prow Bot added size/M Denotes a PR that changes 30-99 lines, ignoring generated files. and removed size/S Denotes a PR that changes 10-29 lines, ignoring generated files. labels Aug 19, 2026

@neolit123 neolit123 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

hm, actually someone is trying to resolve this on the generator level.
i think that might be the better fix if it works:

@locker95

Copy link
Copy Markdown
Contributor Author

yeah, putting -v in the generated tables is the right fix. i can close this once kubernetes-sigs/reference-docs#469 lands — until then the note is just so people can find the flag.

@victord-ef

Copy link
Copy Markdown
Contributor

/sig docs
/sig cluster-lifecycle

@kubernetes-prow kubernetes-prow Bot added sig/docs Categorizes an issue or PR as relevant to SIG Docs. sig/cluster-lifecycle Categorizes an issue or PR as relevant to SIG Cluster Lifecycle. labels Aug 20, 2026
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 sig/cluster-lifecycle Categorizes an issue or PR as relevant to SIG Cluster Lifecycle. sig/docs Categorizes an issue or PR as relevant to SIG Docs. size/M Denotes a PR that changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

The verbosity flag of kubeadm is not included in the documentation

3 participants