Skip to content

Clarify front-proxy certificate dependency on aggregation layer#55639

Open
singhvishalkr wants to merge 1 commit intokubernetes:mainfrom
singhvishalkr:docs-front-proxy-aggregation-layer-clarification
Open

Clarify front-proxy certificate dependency on aggregation layer#55639
singhvishalkr wants to merge 1 commit intokubernetes:mainfrom
singhvishalkr:docs-front-proxy-aggregation-layer-clarification

Conversation

@singhvishalkr
Copy link
Copy Markdown

Closes #55622.

The note in the "Kubelet's server and client certificates" section currently reads:

front-proxy certificates are required only if you run kube-proxy to support an extension API server.

That conflates two unrelated components. kube-proxy is the node-level Service networking dataplane and is not involved in extension API server delivery. The mechanism that actually requires the front-proxy CA is the apiserver aggregation layer, which proxies aggregated API requests on behalf of clients using the front-proxy client certificate.

I rewrote the note to point at the aggregation layer task page (the same link already appears in this file at line 41 under "Optional client certificate for the front-proxy") while preserving the existing extension API server reference.

NONE

/sig docs
/kind documentation
/language en

@k8s-ci-robot k8s-ci-robot added do-not-merge/invalid-commit-message Indicates that a PR should not merge because it has an invalid commit message. sig/docs Categorizes an issue or PR as relevant to SIG Docs. kind/documentation Categorizes issue or PR as related to documentation. language/en Issues or PRs related to English language labels May 1, 2026
@k8s-ci-robot
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 reylejano 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

@k8s-ci-robot k8s-ci-robot added cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels May 1, 2026
The note in the kubelet certificates section described the front-proxy CA as
something you only need `if you run kube-proxy to support an extension API
server`. kube-proxy is the node-level Service networking component and is
not involved in extension API server delivery; the actual mechanism is the
apiserver aggregation layer.

Reword the note to point at the aggregation layer with a link to the matching
task page, while keeping the existing extension API server reference.
@singhvishalkr singhvishalkr force-pushed the docs-front-proxy-aggregation-layer-clarification branch from 96d03b0 to cfecffa Compare May 1, 2026 17:35
@k8s-ci-robot k8s-ci-robot removed the do-not-merge/invalid-commit-message Indicates that a PR should not merge because it has an invalid commit message. label May 1, 2026
@netlify
Copy link
Copy Markdown

netlify Bot commented May 1, 2026

Pull request preview available for checking

Built without sensitive environment variables

Name Link
🔨 Latest commit cfecffa
🔍 Latest deploy log https://app.netlify.com/projects/kubernetes-io-main-staging/deploys/69f4e44d598d6b00075748cf
😎 Deploy Preview https://deploy-preview-55639--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.

Copy link
Copy Markdown
Member

@Arhell Arhell left a comment

Choose a reason for hiding this comment

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

Lgtm

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. kind/documentation Categorizes issue or PR as related to documentation. language/en Issues or PRs related to English language sig/docs Categorizes an issue or PR as relevant to SIG Docs. size/XS Denotes a PR that changes 0-9 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Possible confusion around kube-proxy mention in front-proxy certificates section

3 participants