@@ -141,11 +141,16 @@ As each Pod is created, it gets a matching DNS subdomain, taking the form:
141
141
` $(podname).$(governing service domain)` , where the governing service is defined
142
142
by the `serviceName` field on the StatefulSet.
143
143
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 >}}
149
154
150
155
As mentioned in the [limitations](#limitations) section, you are responsible for
151
156
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.
285
290
* Follow an example of [running a replicated stateful application](/docs/tasks/run-application/run-replicated-stateful-application/).
286
291
287
292
288
-
0 commit comments