github/kubernetes
1
0
Fork 0
mirror of https://github.com/k3s-io/kubernetes.git synced 2026-01-05 07:27:21 +00:00
Code Issues Projects Releases Wiki Activity

Clarify behavior of publishNotReadyAddresses (#90783)

Browse Source 
* Clarify behavior of publishNotReadyAddresses

* gen docs after clarifying publishNotReadyAddresses
This commit is contained in:
Jeremy Olmsted-Thompson
2020-06-24 01:59:18 -07:00
committed by GitHub
parent b67e7d6e2c
commit daa27c9b2e
5 changed files with 26 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
pkg/apis/core/types.go
View File

@@ -3513,12 +3513,14 @@ type ServiceSpec struct {
// +optional
HealthCheckNodePort int32
// publishNotReadyAddresses, when set to true, indicates that DNS implementations
// must publish the notReadyAddresses of subsets for the Endpoints associated with
// the Service. The default value is false.
// The primary use case for setting this field is to use a StatefulSet's Headless Service
// to propagate SRV records for its Pods without respect to their readiness for purpose
// of peer discovery.
// publishNotReadyAddresses indicates that any agent which deals with endpoints for this
// Service should disregard any indications of ready/not-ready.
// The primary use case for setting this field is for a StatefulSet's Headless Service to
// propagate SRV DNS records for its Pods for the purpose of peer discovery.
// The Kubernetes controllers that generate Endpoints and EndpointSlice resources for
// Services interpret this to mean that all endpoints are considered "ready" even if the
// Pods themselves are not. Agents which consume only Kubernetes generated endpoints
// through the Endpoints or EndpointSlice resources can safely assume this behavior.
// +optional
PublishNotReadyAddresses bool