pulumi-kubernetes 4.17.0__py3-none-any.whl → 4.17.0a1723228048__py3-none-any.whl

pulumi_kubernetes/coordination/v1/_inputs.py

@@ -37,28 +37,20 @@ if not MYPY:
         """
         holder_identity: NotRequired[pulumi.Input[str]]
         """
-        holderIdentity contains the identity of the holder of a current lease. If Coordinated Leader Election is used, the holder identity must be equal to the elected LeaseCandidate.metadata.name field.
+        holderIdentity contains the identity of the holder of a current lease.
         """
         lease_duration_seconds: NotRequired[pulumi.Input[int]]
         """
-        leaseDurationSeconds is a duration that candidates for a lease need to wait to force acquire it. This is measured against the time of last observed renewTime.
+        leaseDurationSeconds is a duration that candidates for a lease need to wait to force acquire it. This is measure against time of last observed renewTime.
         """
         lease_transitions: NotRequired[pulumi.Input[int]]
         """
         leaseTransitions is the number of transitions of a lease between holders.
         """
-        preferred_holder: NotRequired[pulumi.Input[str]]
-        """
-        PreferredHolder signals to a lease holder that the lease has a more optimal holder and should be given up. This field can only be set if Strategy is also set.
-        """
         renew_time: NotRequired[pulumi.Input[str]]
         """
         renewTime is a time when the current holder of a lease has last updated the lease.
         """
-        strategy: NotRequired[pulumi.Input[str]]
-        """
-        Strategy indicates the strategy for picking the leader for coordinated leader election. If the field is not specified, there is no active coordination for this lease. (Alpha) Using this field requires the CoordinatedLeaderElection feature gate to be enabled.
-        """
 elif False:
     LeaseSpecPatchArgsDict: TypeAlias = Mapping[str, Any]
 
@@ -69,18 +61,14 @@ class LeaseSpecPatchArgs:
                  holder_identity: Optional[pulumi.Input[str]] = None,
                  lease_duration_seconds: Optional[pulumi.Input[int]] = None,
                  lease_transitions: Optional[pulumi.Input[int]] = None,
-                 preferred_holder: Optional[pulumi.Input[str]] = None,
-                 renew_time: Optional[pulumi.Input[str]] = None,
-                 strategy: Optional[pulumi.Input[str]] = None):
+                 renew_time: Optional[pulumi.Input[str]] = None):
         """
         LeaseSpec is a specification of a Lease.
         :param pulumi.Input[str] acquire_time: acquireTime is a time when the current lease was acquired.
-        :param pulumi.Input[str] holder_identity: holderIdentity contains the identity of the holder of a current lease. If Coordinated Leader Election is used, the holder identity must be equal to the elected LeaseCandidate.metadata.name field.
-        :param pulumi.Input[int] lease_duration_seconds: leaseDurationSeconds is a duration that candidates for a lease need to wait to force acquire it. This is measured against the time of last observed renewTime.
+        :param pulumi.Input[str] holder_identity: holderIdentity contains the identity of the holder of a current lease.
+        :param pulumi.Input[int] lease_duration_seconds: leaseDurationSeconds is a duration that candidates for a lease need to wait to force acquire it. This is measure against time of last observed renewTime.
         :param pulumi.Input[int] lease_transitions: leaseTransitions is the number of transitions of a lease between holders.
-        :param pulumi.Input[str] preferred_holder: PreferredHolder signals to a lease holder that the lease has a more optimal holder and should be given up. This field can only be set if Strategy is also set.
         :param pulumi.Input[str] renew_time: renewTime is a time when the current holder of a lease has last updated the lease.
-        :param pulumi.Input[str] strategy: Strategy indicates the strategy for picking the leader for coordinated leader election. If the field is not specified, there is no active coordination for this lease. (Alpha) Using this field requires the CoordinatedLeaderElection feature gate to be enabled.
         """
         if acquire_time is not None:
             pulumi.set(__self__, "acquire_time", acquire_time)
@@ -90,12 +78,8 @@ class LeaseSpecPatchArgs:
             pulumi.set(__self__, "lease_duration_seconds", lease_duration_seconds)
         if lease_transitions is not None:
             pulumi.set(__self__, "lease_transitions", lease_transitions)
-        if preferred_holder is not None:
-            pulumi.set(__self__, "preferred_holder", preferred_holder)
         if renew_time is not None:
             pulumi.set(__self__, "renew_time", renew_time)
-        if strategy is not None:
-            pulumi.set(__self__, "strategy", strategy)
 
     @property
     @pulumi.getter(name="acquireTime")
@@ -113,7 +97,7 @@ class LeaseSpecPatchArgs:
     @pulumi.getter(name="holderIdentity")
     def holder_identity(self) -> Optional[pulumi.Input[str]]:
         """
-        holderIdentity contains the identity of the holder of a current lease. If Coordinated Leader Election is used, the holder identity must be equal to the elected LeaseCandidate.metadata.name field.
+        holderIdentity contains the identity of the holder of a current lease.
         """
         return pulumi.get(self, "holder_identity")
 
@@ -125,7 +109,7 @@ class LeaseSpecPatchArgs:
     @pulumi.getter(name="leaseDurationSeconds")
     def lease_duration_seconds(self) -> Optional[pulumi.Input[int]]:
         """
-        leaseDurationSeconds is a duration that candidates for a lease need to wait to force acquire it. This is measured against the time of last observed renewTime.
+        leaseDurationSeconds is a duration that candidates for a lease need to wait to force acquire it. This is measure against time of last observed renewTime.
         """
         return pulumi.get(self, "lease_duration_seconds")
 
@@ -145,18 +129,6 @@ class LeaseSpecPatchArgs:
     def lease_transitions(self, value: Optional[pulumi.Input[int]]):
         pulumi.set(self, "lease_transitions", value)
 
-    @property
-    @pulumi.getter(name="preferredHolder")
-    def preferred_holder(self) -> Optional[pulumi.Input[str]]:
-        """
-        PreferredHolder signals to a lease holder that the lease has a more optimal holder and should be given up. This field can only be set if Strategy is also set.
-        """
-        return pulumi.get(self, "preferred_holder")
-
-    @preferred_holder.setter
-    def preferred_holder(self, value: Optional[pulumi.Input[str]]):
-        pulumi.set(self, "preferred_holder", value)
-
     @property
     @pulumi.getter(name="renewTime")
     def renew_time(self) -> Optional[pulumi.Input[str]]:
@@ -169,18 +141,6 @@ class LeaseSpecPatchArgs:
     def renew_time(self, value: Optional[pulumi.Input[str]]):
         pulumi.set(self, "renew_time", value)
 
-    @property
-    @pulumi.getter
-    def strategy(self) -> Optional[pulumi.Input[str]]:
-        """
-        Strategy indicates the strategy for picking the leader for coordinated leader election. If the field is not specified, there is no active coordination for this lease. (Alpha) Using this field requires the CoordinatedLeaderElection feature gate to be enabled.
-        """
-        return pulumi.get(self, "strategy")
-
-    @strategy.setter
-    def strategy(self, value: Optional[pulumi.Input[str]]):
-        pulumi.set(self, "strategy", value)
-
 
 if not MYPY:
     class LeaseSpecArgsDict(TypedDict):
@@ -193,28 +153,20 @@ if not MYPY:
         """
         holder_identity: NotRequired[pulumi.Input[str]]
         """
-        holderIdentity contains the identity of the holder of a current lease. If Coordinated Leader Election is used, the holder identity must be equal to the elected LeaseCandidate.metadata.name field.
+        holderIdentity contains the identity of the holder of a current lease.
         """
         lease_duration_seconds: NotRequired[pulumi.Input[int]]
         """
-        leaseDurationSeconds is a duration that candidates for a lease need to wait to force acquire it. This is measured against the time of last observed renewTime.
+        leaseDurationSeconds is a duration that candidates for a lease need to wait to force acquire it. This is measure against time of last observed renewTime.
         """
         lease_transitions: NotRequired[pulumi.Input[int]]
         """
         leaseTransitions is the number of transitions of a lease between holders.
         """
-        preferred_holder: NotRequired[pulumi.Input[str]]
-        """
-        PreferredHolder signals to a lease holder that the lease has a more optimal holder and should be given up. This field can only be set if Strategy is also set.
-        """
         renew_time: NotRequired[pulumi.Input[str]]
         """
         renewTime is a time when the current holder of a lease has last updated the lease.
         """
-        strategy: NotRequired[pulumi.Input[str]]
-        """
-        Strategy indicates the strategy for picking the leader for coordinated leader election. If the field is not specified, there is no active coordination for this lease. (Alpha) Using this field requires the CoordinatedLeaderElection feature gate to be enabled.
-        """
 elif False:
     LeaseSpecArgsDict: TypeAlias = Mapping[str, Any]
 
@@ -225,18 +177,14 @@ class LeaseSpecArgs:
                  holder_identity: Optional[pulumi.Input[str]] = None,
                  lease_duration_seconds: Optional[pulumi.Input[int]] = None,
                  lease_transitions: Optional[pulumi.Input[int]] = None,
-                 preferred_holder: Optional[pulumi.Input[str]] = None,
-                 renew_time: Optional[pulumi.Input[str]] = None,
-                 strategy: Optional[pulumi.Input[str]] = None):
+                 renew_time: Optional[pulumi.Input[str]] = None):
         """
         LeaseSpec is a specification of a Lease.
         :param pulumi.Input[str] acquire_time: acquireTime is a time when the current lease was acquired.
-        :param pulumi.Input[str] holder_identity: holderIdentity contains the identity of the holder of a current lease. If Coordinated Leader Election is used, the holder identity must be equal to the elected LeaseCandidate.metadata.name field.
-        :param pulumi.Input[int] lease_duration_seconds: leaseDurationSeconds is a duration that candidates for a lease need to wait to force acquire it. This is measured against the time of last observed renewTime.
+        :param pulumi.Input[str] holder_identity: holderIdentity contains the identity of the holder of a current lease.
+        :param pulumi.Input[int] lease_duration_seconds: leaseDurationSeconds is a duration that candidates for a lease need to wait to force acquire it. This is measure against time of last observed renewTime.
         :param pulumi.Input[int] lease_transitions: leaseTransitions is the number of transitions of a lease between holders.
-        :param pulumi.Input[str] preferred_holder: PreferredHolder signals to a lease holder that the lease has a more optimal holder and should be given up. This field can only be set if Strategy is also set.
         :param pulumi.Input[str] renew_time: renewTime is a time when the current holder of a lease has last updated the lease.
-        :param pulumi.Input[str] strategy: Strategy indicates the strategy for picking the leader for coordinated leader election. If the field is not specified, there is no active coordination for this lease. (Alpha) Using this field requires the CoordinatedLeaderElection feature gate to be enabled.
         """
         if acquire_time is not None:
             pulumi.set(__self__, "acquire_time", acquire_time)
@@ -246,12 +194,8 @@ class LeaseSpecArgs:
             pulumi.set(__self__, "lease_duration_seconds", lease_duration_seconds)
         if lease_transitions is not None:
             pulumi.set(__self__, "lease_transitions", lease_transitions)
-        if preferred_holder is not None:
-            pulumi.set(__self__, "preferred_holder", preferred_holder)
         if renew_time is not None:
             pulumi.set(__self__, "renew_time", renew_time)
-        if strategy is not None:
-            pulumi.set(__self__, "strategy", strategy)
 
     @property
     @pulumi.getter(name="acquireTime")
@@ -269,7 +213,7 @@ class LeaseSpecArgs:
     @pulumi.getter(name="holderIdentity")
     def holder_identity(self) -> Optional[pulumi.Input[str]]:
         """
-        holderIdentity contains the identity of the holder of a current lease. If Coordinated Leader Election is used, the holder identity must be equal to the elected LeaseCandidate.metadata.name field.
+        holderIdentity contains the identity of the holder of a current lease.
         """
         return pulumi.get(self, "holder_identity")
 
@@ -281,7 +225,7 @@ class LeaseSpecArgs:
     @pulumi.getter(name="leaseDurationSeconds")
     def lease_duration_seconds(self) -> Optional[pulumi.Input[int]]:
         """
-        leaseDurationSeconds is a duration that candidates for a lease need to wait to force acquire it. This is measured against the time of last observed renewTime.
+        leaseDurationSeconds is a duration that candidates for a lease need to wait to force acquire it. This is measure against time of last observed renewTime.
         """
         return pulumi.get(self, "lease_duration_seconds")
 
@@ -301,18 +245,6 @@ class LeaseSpecArgs:
     def lease_transitions(self, value: Optional[pulumi.Input[int]]):
         pulumi.set(self, "lease_transitions", value)
 
-    @property
-    @pulumi.getter(name="preferredHolder")
-    def preferred_holder(self) -> Optional[pulumi.Input[str]]:
-        """
-        PreferredHolder signals to a lease holder that the lease has a more optimal holder and should be given up. This field can only be set if Strategy is also set.
-        """
-        return pulumi.get(self, "preferred_holder")
-
-    @preferred_holder.setter
-    def preferred_holder(self, value: Optional[pulumi.Input[str]]):
-        pulumi.set(self, "preferred_holder", value)
-
     @property
     @pulumi.getter(name="renewTime")
     def renew_time(self) -> Optional[pulumi.Input[str]]:
@@ -325,18 +257,6 @@ class LeaseSpecArgs:
     def renew_time(self, value: Optional[pulumi.Input[str]]):
         pulumi.set(self, "renew_time", value)
 
-    @property
-    @pulumi.getter
-    def strategy(self) -> Optional[pulumi.Input[str]]:
-        """
-        Strategy indicates the strategy for picking the leader for coordinated leader election. If the field is not specified, there is no active coordination for this lease. (Alpha) Using this field requires the CoordinatedLeaderElection feature gate to be enabled.
-        """
-        return pulumi.get(self, "strategy")
-
-    @strategy.setter
-    def strategy(self, value: Optional[pulumi.Input[str]]):
-        pulumi.set(self, "strategy", value)
-
 
 if not MYPY:
     class LeaseArgsDict(TypedDict):

pulumi_kubernetes/coordination/v1/outputs.py

@@ -114,8 +114,6 @@ class LeaseSpec(dict):
             suggest = "lease_duration_seconds"
         elif key == "leaseTransitions":
             suggest = "lease_transitions"
-        elif key == "preferredHolder":
-            suggest = "preferred_holder"
         elif key == "renewTime":
             suggest = "renew_time"
 
@@ -135,18 +133,14 @@ class LeaseSpec(dict):
                  holder_identity: Optional[str] = None,
                  lease_duration_seconds: Optional[int] = None,
                  lease_transitions: Optional[int] = None,
-                 preferred_holder: Optional[str] = None,
-                 renew_time: Optional[str] = None,
-                 strategy: Optional[str] = None):
+                 renew_time: Optional[str] = None):
         """
         LeaseSpec is a specification of a Lease.
         :param str acquire_time: acquireTime is a time when the current lease was acquired.
-        :param str holder_identity: holderIdentity contains the identity of the holder of a current lease. If Coordinated Leader Election is used, the holder identity must be equal to the elected LeaseCandidate.metadata.name field.
-        :param int lease_duration_seconds: leaseDurationSeconds is a duration that candidates for a lease need to wait to force acquire it. This is measured against the time of last observed renewTime.
+        :param str holder_identity: holderIdentity contains the identity of the holder of a current lease.
+        :param int lease_duration_seconds: leaseDurationSeconds is a duration that candidates for a lease need to wait to force acquire it. This is measure against time of last observed renewTime.
         :param int lease_transitions: leaseTransitions is the number of transitions of a lease between holders.
-        :param str preferred_holder: PreferredHolder signals to a lease holder that the lease has a more optimal holder and should be given up. This field can only be set if Strategy is also set.
         :param str renew_time: renewTime is a time when the current holder of a lease has last updated the lease.
-        :param str strategy: Strategy indicates the strategy for picking the leader for coordinated leader election. If the field is not specified, there is no active coordination for this lease. (Alpha) Using this field requires the CoordinatedLeaderElection feature gate to be enabled.
         """
         if acquire_time is not None:
             pulumi.set(__self__, "acquire_time", acquire_time)
@@ -156,12 +150,8 @@ class LeaseSpec(dict):
             pulumi.set(__self__, "lease_duration_seconds", lease_duration_seconds)
         if lease_transitions is not None:
             pulumi.set(__self__, "lease_transitions", lease_transitions)
-        if preferred_holder is not None:
-            pulumi.set(__self__, "preferred_holder", preferred_holder)
         if renew_time is not None:
             pulumi.set(__self__, "renew_time", renew_time)
-        if strategy is not None:
-            pulumi.set(__self__, "strategy", strategy)
 
     @property
     @pulumi.getter(name="acquireTime")
@@ -175,7 +165,7 @@ class LeaseSpec(dict):
     @pulumi.getter(name="holderIdentity")
     def holder_identity(self) -> Optional[str]:
         """
-        holderIdentity contains the identity of the holder of a current lease. If Coordinated Leader Election is used, the holder identity must be equal to the elected LeaseCandidate.metadata.name field.
+        holderIdentity contains the identity of the holder of a current lease.
         """
         return pulumi.get(self, "holder_identity")
 
@@ -183,7 +173,7 @@ class LeaseSpec(dict):
     @pulumi.getter(name="leaseDurationSeconds")
     def lease_duration_seconds(self) -> Optional[int]:
         """
-        leaseDurationSeconds is a duration that candidates for a lease need to wait to force acquire it. This is measured against the time of last observed renewTime.
+        leaseDurationSeconds is a duration that candidates for a lease need to wait to force acquire it. This is measure against time of last observed renewTime.
         """
         return pulumi.get(self, "lease_duration_seconds")
 
@@ -195,14 +185,6 @@ class LeaseSpec(dict):
         """
         return pulumi.get(self, "lease_transitions")
 
-    @property
-    @pulumi.getter(name="preferredHolder")
-    def preferred_holder(self) -> Optional[str]:
-        """
-        PreferredHolder signals to a lease holder that the lease has a more optimal holder and should be given up. This field can only be set if Strategy is also set.
-        """
-        return pulumi.get(self, "preferred_holder")
-
     @property
     @pulumi.getter(name="renewTime")
     def renew_time(self) -> Optional[str]:
@@ -211,14 +193,6 @@ class LeaseSpec(dict):
         """
         return pulumi.get(self, "renew_time")
 
-    @property
-    @pulumi.getter
-    def strategy(self) -> Optional[str]:
-        """
-        Strategy indicates the strategy for picking the leader for coordinated leader election. If the field is not specified, there is no active coordination for this lease. (Alpha) Using this field requires the CoordinatedLeaderElection feature gate to be enabled.
-        """
-        return pulumi.get(self, "strategy")
-
 
 @pulumi.output_type
 class LeaseSpecPatch(dict):
@@ -236,8 +210,6 @@ class LeaseSpecPatch(dict):
             suggest = "lease_duration_seconds"
         elif key == "leaseTransitions":
             suggest = "lease_transitions"
-        elif key == "preferredHolder":
-            suggest = "preferred_holder"
         elif key == "renewTime":
             suggest = "renew_time"
 
@@ -257,18 +229,14 @@ class LeaseSpecPatch(dict):
                  holder_identity: Optional[str] = None,
                  lease_duration_seconds: Optional[int] = None,
                  lease_transitions: Optional[int] = None,
-                 preferred_holder: Optional[str] = None,
-                 renew_time: Optional[str] = None,
-                 strategy: Optional[str] = None):
+                 renew_time: Optional[str] = None):
         """
         LeaseSpec is a specification of a Lease.
         :param str acquire_time: acquireTime is a time when the current lease was acquired.
-        :param str holder_identity: holderIdentity contains the identity of the holder of a current lease. If Coordinated Leader Election is used, the holder identity must be equal to the elected LeaseCandidate.metadata.name field.
-        :param int lease_duration_seconds: leaseDurationSeconds is a duration that candidates for a lease need to wait to force acquire it. This is measured against the time of last observed renewTime.
+        :param str holder_identity: holderIdentity contains the identity of the holder of a current lease.
+        :param int lease_duration_seconds: leaseDurationSeconds is a duration that candidates for a lease need to wait to force acquire it. This is measure against time of last observed renewTime.
         :param int lease_transitions: leaseTransitions is the number of transitions of a lease between holders.
-        :param str preferred_holder: PreferredHolder signals to a lease holder that the lease has a more optimal holder and should be given up. This field can only be set if Strategy is also set.
         :param str renew_time: renewTime is a time when the current holder of a lease has last updated the lease.
-        :param str strategy: Strategy indicates the strategy for picking the leader for coordinated leader election. If the field is not specified, there is no active coordination for this lease. (Alpha) Using this field requires the CoordinatedLeaderElection feature gate to be enabled.
         """
         if acquire_time is not None:
             pulumi.set(__self__, "acquire_time", acquire_time)
@@ -278,12 +246,8 @@ class LeaseSpecPatch(dict):
             pulumi.set(__self__, "lease_duration_seconds", lease_duration_seconds)
         if lease_transitions is not None:
             pulumi.set(__self__, "lease_transitions", lease_transitions)
-        if preferred_holder is not None:
-            pulumi.set(__self__, "preferred_holder", preferred_holder)
         if renew_time is not None:
             pulumi.set(__self__, "renew_time", renew_time)
-        if strategy is not None:
-            pulumi.set(__self__, "strategy", strategy)
 
     @property
     @pulumi.getter(name="acquireTime")
@@ -297,7 +261,7 @@ class LeaseSpecPatch(dict):
     @pulumi.getter(name="holderIdentity")
     def holder_identity(self) -> Optional[str]:
         """
-        holderIdentity contains the identity of the holder of a current lease. If Coordinated Leader Election is used, the holder identity must be equal to the elected LeaseCandidate.metadata.name field.
+        holderIdentity contains the identity of the holder of a current lease.
         """
         return pulumi.get(self, "holder_identity")
 
@@ -305,7 +269,7 @@ class LeaseSpecPatch(dict):
     @pulumi.getter(name="leaseDurationSeconds")
     def lease_duration_seconds(self) -> Optional[int]:
         """
-        leaseDurationSeconds is a duration that candidates for a lease need to wait to force acquire it. This is measured against the time of last observed renewTime.
+        leaseDurationSeconds is a duration that candidates for a lease need to wait to force acquire it. This is measure against time of last observed renewTime.
         """
         return pulumi.get(self, "lease_duration_seconds")
 
@@ -317,14 +281,6 @@ class LeaseSpecPatch(dict):
         """
         return pulumi.get(self, "lease_transitions")
 
-    @property
-    @pulumi.getter(name="preferredHolder")
-    def preferred_holder(self) -> Optional[str]:
-        """
-        PreferredHolder signals to a lease holder that the lease has a more optimal holder and should be given up. This field can only be set if Strategy is also set.
-        """
-        return pulumi.get(self, "preferred_holder")
-
     @property
     @pulumi.getter(name="renewTime")
     def renew_time(self) -> Optional[str]:
@@ -333,12 +289,4 @@ class LeaseSpecPatch(dict):
         """
         return pulumi.get(self, "renew_time")
 
-    @property
-    @pulumi.getter
-    def strategy(self) -> Optional[str]:
-        """
-        Strategy indicates the strategy for picking the leader for coordinated leader election. If the field is not specified, there is no active coordination for this lease. (Alpha) Using this field requires the CoordinatedLeaderElection feature gate to be enabled.
-        """
-        return pulumi.get(self, "strategy")
-
 

pulumi_kubernetes/core/v1/Service.py

@@ -113,11 +113,19 @@ class Service(pulumi.CustomResource):
         1. Service object exists.
         2. Related Endpoint objects are created. Each time we get an update, wait 10 seconds
            for any stragglers.
-        3. There are no "not ready" endpoints -- unless the Service is an "empty
-           headless" Service [1], a Service with '.spec.type: ExternalName', or a Service
-           without a selector.
+        3. The endpoints objects target some number of living objects (unless the Service is
+           an "empty headless" Service [1] or a Service with '.spec.type: ExternalName').
         4. External IP address is allocated (if Service has '.spec.type: LoadBalancer').
 
+        Known limitations:
+        Services targeting ReplicaSets (and, by extension, Deployments,
+        StatefulSets, etc.) with '.spec.replicas' set to 0 are not handled, and will time
+        out. To work around this limitation, set 'pulumi.com/skipAwait: "true"' on
+        '.metadata.annotations' for the Service. Work to handle this case is in progress [2].
+
+        [1] https://kubernetes.io/docs/concepts/services-networking/service/#headless-services
+        [2] https://github.com/pulumi/pulumi-kubernetes/pull/703
+
         If the Service has not reached a Ready state after 10 minutes, it will
         time out and mark the resource update as Failed. You can override the default timeout value
         by setting the 'customTimeouts' option on the resource.
@@ -184,11 +192,19 @@ class Service(pulumi.CustomResource):
         1. Service object exists.
         2. Related Endpoint objects are created. Each time we get an update, wait 10 seconds
            for any stragglers.
-        3. There are no "not ready" endpoints -- unless the Service is an "empty
-           headless" Service [1], a Service with '.spec.type: ExternalName', or a Service
-           without a selector.
+        3. The endpoints objects target some number of living objects (unless the Service is
+           an "empty headless" Service [1] or a Service with '.spec.type: ExternalName').
         4. External IP address is allocated (if Service has '.spec.type: LoadBalancer').
 
+        Known limitations:
+        Services targeting ReplicaSets (and, by extension, Deployments,
+        StatefulSets, etc.) with '.spec.replicas' set to 0 are not handled, and will time
+        out. To work around this limitation, set 'pulumi.com/skipAwait: "true"' on
+        '.metadata.annotations' for the Service. Work to handle this case is in progress [2].
+
+        [1] https://kubernetes.io/docs/concepts/services-networking/service/#headless-services
+        [2] https://github.com/pulumi/pulumi-kubernetes/pull/703
+
         If the Service has not reached a Ready state after 10 minutes, it will
         time out and mark the resource update as Failed. You can override the default timeout value
         by setting the 'customTimeouts' option on the resource.

pulumi_kubernetes/core/v1/ServicePatch.py

@@ -119,11 +119,19 @@ class ServicePatch(pulumi.CustomResource):
         1. Service object exists.
         2. Related Endpoint objects are created. Each time we get an update, wait 10 seconds
            for any stragglers.
-        3. There are no "not ready" endpoints -- unless the Service is an "empty
-           headless" Service [1], a Service with '.spec.type: ExternalName', or a Service
-           without a selector.
+        3. The endpoints objects target some number of living objects (unless the Service is
+           an "empty headless" Service [1] or a Service with '.spec.type: ExternalName').
         4. External IP address is allocated (if Service has '.spec.type: LoadBalancer').
 
+        Known limitations:
+        Services targeting ReplicaSets (and, by extension, Deployments,
+        StatefulSets, etc.) with '.spec.replicas' set to 0 are not handled, and will time
+        out. To work around this limitation, set 'pulumi.com/skipAwait: "true"' on
+        '.metadata.annotations' for the Service. Work to handle this case is in progress [2].
+
+        [1] https://kubernetes.io/docs/concepts/services-networking/service/#headless-services
+        [2] https://github.com/pulumi/pulumi-kubernetes/pull/703
+
         If the Service has not reached a Ready state after 10 minutes, it will
         time out and mark the resource update as Failed. You can override the default timeout value
         by setting the 'customTimeouts' option on the resource.
@@ -158,11 +166,19 @@ class ServicePatch(pulumi.CustomResource):
         1. Service object exists.
         2. Related Endpoint objects are created. Each time we get an update, wait 10 seconds
            for any stragglers.
-        3. There are no "not ready" endpoints -- unless the Service is an "empty
-           headless" Service [1], a Service with '.spec.type: ExternalName', or a Service
-           without a selector.
+        3. The endpoints objects target some number of living objects (unless the Service is
+           an "empty headless" Service [1] or a Service with '.spec.type: ExternalName').
         4. External IP address is allocated (if Service has '.spec.type: LoadBalancer').
 
+        Known limitations:
+        Services targeting ReplicaSets (and, by extension, Deployments,
+        StatefulSets, etc.) with '.spec.replicas' set to 0 are not handled, and will time
+        out. To work around this limitation, set 'pulumi.com/skipAwait: "true"' on
+        '.metadata.annotations' for the Service. Work to handle this case is in progress [2].
+
+        [1] https://kubernetes.io/docs/concepts/services-networking/service/#headless-services
+        [2] https://github.com/pulumi/pulumi-kubernetes/pull/703
+
         If the Service has not reached a Ready state after 10 minutes, it will
         time out and mark the resource update as Failed. You can override the default timeout value
         by setting the 'customTimeouts' option on the resource.