Skip to content

Commit 167746b

Browse files
jayunit100Tim Bannister
andauthored
Update content/en/docs/concepts/workloads/controllers/statefulset.md
Co-authored-by: Tim Bannister <[email protected]>
1 parent 0f8593d commit 167746b

File tree

1 file changed

+10
-6
lines changed

1 file changed

+10
-6
lines changed

content/en/docs/concepts/workloads/controllers/statefulset.md

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -141,11 +141,16 @@ As each Pod is created, it gets a matching DNS subdomain, taking the form:
141141
`$(podname).$(governing service domain)`, where the governing service is defined
142142
by the `serviceName` field on the StatefulSet.
143143

144-
Note initial availability of stable DNS name's responsiveness: The initial reachability of a Pod via its DNS
145-
depends on the settings of your DNS provider. It may be 30 seconds before the DNS name for your Pod
146-
is reachable from another Pod in your cluster. For StatefulSets which need to come online via a quorum
147-
in a very short (< 30s) time period, consider tuning your DNS settings
148-
or another mechanism (such as querying the Kubernetes endpoints directly for IP addresses).
144+
{{< note >}}
145+
Depending on how DNS is configured in your cluster, you may not be able to look up the DNS
146+
name for a newly-run Pod immediately. This behavior can occur when other clients in the
147+
cluster have already sent queries for the hostname of the Pod before it was created.
148+
Negative caching (normal in DNS) means that the results of previous failed lookups are
149+
remembered and reused, even after the Pod is running, for at least a few seconds.
150+
151+
If you need to discover Pods promptly after they are created, consider querying the
152+
Kubernetes API directly (for example, using a watch) rather than relying on DNS lookups.
153+
{{< /note >}}
149154

150155
As mentioned in the [limitations](#limitations) section, you are responsible for
151156
creating the [Headless Service](/docs/concepts/services-networking/service/#headless-services)
@@ -285,4 +290,3 @@ StatefulSet will then begin to recreate the Pods using the reverted template.
285290
* Follow an example of [running a replicated stateful application](/docs/tasks/run-application/run-replicated-stateful-application/).
286291

287292

288-

0 commit comments

Comments
 (0)