Skip to content

docs: Clarify baremetal network requirements and kubectl capabilities#10429

Merged
eks-distro-bot merged 1 commit intoaws:mainfrom
rahulbabu95:docs/clarify-baremetal-ambguity
Dec 11, 2025
Merged

docs: Clarify baremetal network requirements and kubectl capabilities#10429
eks-distro-bot merged 1 commit intoaws:mainfrom
rahulbabu95:docs/clarify-baremetal-ambguity

Conversation

@rahulbabu95
Copy link
Member

Description of changes:

  • Qualify L2 network as network/PXE boot only, not required for ISO boot
  • Clarify DHCP only needed for network/PXE boot mode
  • Add TinkerbellIP vs Control Plane Endpoint explanation
  • Clarify kubectl works for management and workload cluster operations
  • Add hardware CSV operational guidance (when to use CSV vs kubectl)
  • Add cross-references between related documentation

These changes address common customer confusion about network requirements for different boot modes and the scope of kubectl usage for cluster lifecycle management.

- Qualify L2 network as network/PXE boot only, not required for ISO boot
- Clarify DHCP only needed for network/PXE boot mode
- Add TinkerbellIP vs Control Plane Endpoint explanation
- Clarify kubectl works for management and workload cluster operations
- Add hardware CSV operational guidance (when to use CSV vs kubectl)
- Add cross-references between related documentation

These changes address common customer confusion about network requirements
for different boot modes and the scope of kubectl usage for cluster
lifecycle management.
@eks-distro-bot eks-distro-bot added the size/M Denotes a PR that changes 30-99 lines, ignoring generated files. label Dec 10, 2025
@codecov
Copy link

codecov bot commented Dec 10, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 69.56%. Comparing base (9d9cade) to head (f450e4c).
⚠️ Report is 2 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main   #10429   +/-   ##
=======================================
  Coverage   69.56%   69.56%           
=======================================
  Files         670      670           
  Lines       40669    40669           
=======================================
  Hits        28293    28293           
  Misses      10668    10668           
  Partials     1708     1708           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@rajeshvenkata
Copy link
Member

/lgtm
/approve

@eks-distro-bot
Copy link
Collaborator

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: rajeshvenkata

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

The pull request process is described 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

@eks-distro-bot eks-distro-bot merged commit d4b6914 into aws:main Dec 11, 2025
8 checks passed
@sp1999
Copy link
Member

sp1999 commented Feb 18, 2026

/cherry-pick release-0.24

@eks-distro-pr-bot
Copy link
Contributor

@sp1999: new pull request created: #10592

Details

In response to this:

/cherry-pick release-0.24

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

@sp1999
Copy link
Member

sp1999 commented Feb 18, 2026

/cherry-pick release-0.23

@eks-distro-pr-bot
Copy link
Contributor

@sp1999: new pull request created: #10593

Details

In response to this:

/cherry-pick release-0.23

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

@sp1999
Copy link
Member

sp1999 commented Feb 18, 2026

/cherry-pick release-0.22

@eks-distro-pr-bot
Copy link
Contributor

@sp1999: new pull request created: #10594

Details

In response to this:

/cherry-pick release-0.22

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

@sp1999
Copy link
Member

sp1999 commented Feb 18, 2026

/cherry-pick release-0.21

@eks-distro-pr-bot
Copy link
Contributor

@sp1999: new pull request created: #10595

Details

In response to this:

/cherry-pick release-0.21

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

@sp1999
Copy link
Member

sp1999 commented Feb 18, 2026

/cherry-pick release-0.20

@eks-distro-pr-bot
Copy link
Contributor

@sp1999: #10429 failed to apply on top of branch "release-0.20":

Applying: docs: Clarify baremetal network requirements and kubectl capabilities
.git/rebase-apply/patch:123: trailing whitespace.
  
warning: 1 line adds whitespace errors.
Using index info to reconstruct a base tree...
M	docs/content/en/docs/clustermgmt/cluster-upgrades/baremetal-upgrades.md
M	docs/content/en/docs/getting-started/baremetal/bare-prereq.md
M	docs/content/en/docs/getting-started/baremetal/baremetal-getstarted.md
Falling back to patching base and 3-way merge...
Auto-merging docs/content/en/docs/getting-started/baremetal/baremetal-getstarted.md
Auto-merging docs/content/en/docs/getting-started/baremetal/bare-prereq.md
CONFLICT (content): Merge conflict in docs/content/en/docs/getting-started/baremetal/bare-prereq.md
Auto-merging docs/content/en/docs/clustermgmt/cluster-upgrades/baremetal-upgrades.md
error: Failed to merge in the changes.
hint: Use 'git am --show-current-patch=diff' to see the failed patch
Patch failed at 0001 docs: Clarify baremetal network requirements and kubectl capabilities
When you have resolved this problem, run "git am --continue".
If you prefer to skip this patch, run "git am --skip" instead.
To restore the original branch and stop patching, run "git am --abort".

Details

In response to this:

/cherry-pick release-0.20

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

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

Labels

approved area/docs Documentation documentation lgtm 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.

5 participants