Website: Issue with k8s.io/docs/concepts/services-networking/dns-pod-service/ - cluster.local

[cdjohnson]

This is a Bug Report

Problem:
There are several examples that use the cluster.local zone as though it's not a configurable zone. In reality, it's overridable using the --cluster-domain kubelet parameter. This creates problems for application developers when they try to write portable applications that use the DNS for Service name resolution since they will incorrectly assume that cluster.local is always the local cluster zone.

Proposed Solution:
Change all occurrences that are not examples:
from:
cluster.local
to
my-cluster-domain.

For example:
“Normal” (not headless) Services are assigned a DNS A record for a name of the form my-svc.my-namespace.svc.my-cluster-domain. This resolves to the cluster IP of the Service.

Page to Update:
https://kubernetes.io/docs/concepts/services-networking/dns-pod-service/

[sftim]

I like that idea @cdjohnson, thanks for the suggestion!

Marking this
/help
(because this seems like a well-defined and approachable task)

[k8s-ci-robot]

@sftim:
This request has been marked as needing help from a contributor.

Please ensure the request meets the requirements listed here.

If this request no longer meets these requirements, the label can be removed
by commenting with the /remove-help command.

In response to this:

I like that idea @cdjohnson, thanks for the suggestion!

Marking this
/help
(because this seems like a well-defined and approachable task)

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.

[sftim]

Depending on space, I'd be tempted to use cluster-domain.example rather than my-cluster-domain, so that it's clear you can have a dot in it.

[k8s-ci-robot]

@tddorgtfo: You can't close an active issue/PR unless you authored it or you are a collaborator.

In response to this:

/close

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.

[cdjohnson]

Reviewed. Looks good.
/close

[k8s-ci-robot]

@cdjohnson: Closing this issue.

In response to this:

Reviewed. Looks good.
/close

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.