Skip to content

Update for deprecation of kube-dns - #56933

Open
danwinship wants to merge 6 commits into
kubernetes:mainfrom
danwinship:deprecate-kube-dns
Open

Update for deprecation of kube-dns#56933
danwinship wants to merge 6 commits into
kubernetes:mainfrom
danwinship:deprecate-kube-dns

Conversation

@danwinship

Copy link
Copy Markdown
Contributor

Part of kubernetes/kubernetes#137556. Not strongly tied to 1.37; could merge either before or after.

There are still many instances of the string kube-dns in the docs, mostly because the default CoreDNS install is still called "kube-dns" for backward compatibility. Beyond that:

  • content/en/docs/setup/production-environment/tools/kubeadm/troubleshooting-kubeadm.md still says "`coredns` (or `kube-dns`)" in 2 places, since people may still be troubleshooting clusters that use kube-dns.
  • content/en/docs/tasks/administer-cluster/nodelocaldns.md still refers to a "kube-dns" ConfigMap, since that's the name it uses.
  • content/en/docs/tasks/administer-cluster/dns-horizontal-autoscaling.md (and content/end/examples/admin/dns/dns-horizontal-autoscaler.yaml) still create a "kube-dns-autoscaler", but referencing CoreDNS.
  • content/en/docs/tasks/administer-cluster/dns-custom-nameservers.md references a CoreDNS option that is set "for backward compatibility with `kube-dns`".
  • content/en/docs/reference/access-authn-authz/rbac.md still lists the old kube-dns RBAC Role, which we continue to create for now.

/cc @aojea

@kubernetes-prow
kubernetes-prow Bot requested a review from aojea August 11, 2026 15:02
@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/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Aug 11, 2026
@netlify

netlify Bot commented Aug 11, 2026

Copy link
Copy Markdown

Pull request preview available for checking

Built without sensitive environment variables

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

/lgtm

This change is obviously an improvement on our current docs.


I did spot some nits.

- --namespace=kube-system
- --configmap=kube-dns-autoscaler
# Should keep target in sync with cluster/addons/dns/kube-dns.yaml.base
# Should keep target in sync with cluster/addons/dns/coredns/coredns.yaml.base

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.

Is this right?

Maybe just drop the comment.

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.

I think what it means is "you, the reader, need to change <SCALE_TARGET> in the next line to coredns, which is the name of the Deployment being scaled, as seen in cluster/addons/dns/coredns/coredns.yaml.base". But I wouldn't swear to that.

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.

yeah, this seems to have leaked the k/k deployment scripts

Comment thread content/en/docs/tasks/administer-cluster/nodelocaldns.md Outdated
Comment thread content/en/docs/tasks/administer-cluster/nodelocaldns.md Outdated
Comment thread content/en/docs/tasks/job/coarse-parallel-processing-work-queue.md Outdated
Comment thread content/en/docs/tasks/administer-cluster/dns-debugging-resolution.md Outdated
Comment on lines +127 to +128
The value for label `k8s-app` for CoreDNS is `kube-dns`, for backward
compatibility with the original kube-dns.

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.

Does CoreDNS, and its recommended ways to deploy it, use the recommended label app.kubernetes.io/name?

If so: we could recommend selecting on app.kubernetes.io/name.
If not: here's an idea for a feature.

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.

The example deployment has

  labels:
    k8s-app: kube-dns
    kubernetes.io/name: "CoreDNS"
    app.kubernetes.io/name: coredns

but the version in k/k has

  labels:
    k8s-app: kube-dns
    kubernetes.io/cluster-service: "true"
    addonmanager.kubernetes.io/mode: Reconcile
    kubernetes.io/name: "CoreDNS"

and FWIW OpenShift's CoreDNS pods have neither.

I'm guessing the recommendations in this file are not actually very portable

@kubernetes-prow kubernetes-prow Bot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Aug 11, 2026
@kubernetes-prow

Copy link
Copy Markdown
Contributor

LGTM label has been added.

DetailsGit tree hash: df3f823a2f5004289e2daab8d95222ad15e3065c

@danwinship

Copy link
Copy Markdown
Contributor Author

/label tide/merge-method-squash

@kubernetes-prow kubernetes-prow Bot added the tide/merge-method-squash Denotes a PR that should be squashed by tide when it merges. label Aug 11, 2026
@kubernetes-prow kubernetes-prow Bot removed the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Aug 11, 2026
@kubernetes-prow
kubernetes-prow Bot requested a review from lmktfy August 11, 2026 19:23
@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 ask for approval from lmktfy. 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

@aojea

aojea commented Aug 11, 2026

Copy link
Copy Markdown
Member

/lgtm

but it seems there are some formatting issues

@kubernetes-prow kubernetes-prow Bot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Aug 11, 2026
@kubernetes-prow

Copy link
Copy Markdown
Contributor

LGTM label has been added.

DetailsGit tree hash: 43713b91c187fd0494177694d63e67bb37985126

@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.

/lgtm

@danwinship

Copy link
Copy Markdown
Contributor Author

but it seems there are some formatting issues

where? I didn't notice any...

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 lgtm "Looks good to me", indicates that a PR is ready to be merged. size/L Denotes a PR that changes 100-499 lines, ignoring generated files. tide/merge-method-squash Denotes a PR that should be squashed by tide when it merges.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants