@@ -134,7 +134,7 @@ import (
134134// will not be deleted.
135135#RetainPersistentVolumeClaimRetentionPolicyType : #PersistentVolumeClaimRetentionPolicyType & " Retain "
136136
137- // RetentionPersistentVolumeClaimRetentionPolicyType specifies that
137+ // DeletePersistentVolumeClaimRetentionPolicyType specifies that
138138// PersistentVolumeClaims associated with StatefulSet VolumeClaimTemplates
139139// will be deleted in the scenario specified in
140140// StatefulSetPersistentVolumeClaimRetentionPolicy.
@@ -204,14 +204,16 @@ import (
204204 // any volumes in the template, with the same name.
205205 // TODO: Define the behavior if a claim already exists with the same name.
206206 // +optional
207+ // +listType=atomic
207208 volumeClaimTemplates ?: [...v1 .#PersistentVolumeClaim ] @go (VolumeClaimTemplates ,[]v1.PersistentVolumeClaim ) @protobuf (4 ,bytes ,rep )
208209
209210 // serviceName is the name of the service that governs this StatefulSet.
210211 // This service must exist before the StatefulSet, and is responsible for
211212 // the network identity of the set. Pods get DNS/hostnames that follow the
212213 // pattern: pod-specific-string.serviceName.default.svc.cluster.local
213214 // where "pod-specific-string" is managed by the StatefulSet controller.
214- serviceName : string @go (ServiceName ) @protobuf (5 ,bytes ,opt )
215+ // +optional
216+ serviceName ?: string @go (ServiceName ) @protobuf (5 ,bytes ,opt )
215217
216218 // podManagementPolicy controls how pods are created during initial scale up,
217219 // when replacing pods on nodes, or when scaling down. The default policy is
@@ -246,15 +248,13 @@ import (
246248 // volume claims are created as needed and retained until manually deleted. This
247249 // policy allows the lifecycle to be altered, for example by deleting persistent
248250 // volume claims when their stateful set is deleted, or when their pod is scaled
249- // down. This requires the StatefulSetAutoDeletePVC feature gate to be enabled,
250- // which is alpha. +optional
251+ // down.
252+ // +optional
251253 persistentVolumeClaimRetentionPolicy ?: null | #StatefulSetPersistentVolumeClaimRetentionPolicy @go (PersistentVolumeClaimRetentionPolicy ,*StatefulSetPersistentVolumeClaimRetentionPolicy ) @protobuf (10 ,bytes ,opt )
252254
253255 // ordinals controls the numbering of replica indices in a StatefulSet. The
254256 // default ordinals behavior assigns a "0" index to the first replica and
255- // increments the index by one for each additional replica requested. Using
256- // the ordinals field requires the StatefulSetStartOrdinal feature gate to be
257- // enabled, which is beta.
257+ // increments the index by one for each additional replica requested.
258258 // +optional
259259 ordinals ?: null | #StatefulSetOrdinals @go (Ordinals ,*StatefulSetOrdinals ) @protobuf (11 ,bytes ,opt )
260260}
@@ -298,6 +298,8 @@ import (
298298 // +optional
299299 // +patchMergeKey=type
300300 // +patchStrategy=merge
301+ // +listType=map
302+ // +listMapKey=type
301303 conditions ?: [...#StatefulSetCondition ] @go (Conditions ,[]StatefulSetCondition ) @protobuf (10 ,bytes ,rep )
302304
303305 // Total number of available pods (ready for at least minReadySeconds) targeted by this statefulset.
@@ -473,19 +475,19 @@ import (
473475 // +optional
474476 observedGeneration ?: int64 @go (ObservedGeneration ) @protobuf (1 ,varint ,opt )
475477
476- // Total number of non-terminated pods targeted by this deployment (their labels match the selector).
478+ // Total number of non-terminating pods targeted by this deployment (their labels match the selector).
477479 // +optional
478480 replicas ?: int32 @go (Replicas ) @protobuf (2 ,varint ,opt )
479481
480- // Total number of non-terminated pods targeted by this deployment that have the desired template spec.
482+ // Total number of non-terminating pods targeted by this deployment that have the desired template spec.
481483 // +optional
482484 updatedReplicas ?: int32 @go (UpdatedReplicas ) @protobuf (3 ,varint ,opt )
483485
484- // readyReplicas is the number of pods targeted by this Deployment with a Ready Condition.
486+ // Total number of non-terminating pods targeted by this Deployment with a Ready Condition.
485487 // +optional
486488 readyReplicas ?: int32 @go (ReadyReplicas ) @protobuf (7 ,varint ,opt )
487489
488- // Total number of available pods (ready for at least minReadySeconds) targeted by this deployment.
490+ // Total number of available non-terminating pods (ready for at least minReadySeconds) targeted by this deployment.
489491 // +optional
490492 availableReplicas ?: int32 @go (AvailableReplicas ) @protobuf (4 ,varint ,opt )
491493
@@ -495,9 +497,18 @@ import (
495497 // +optional
496498 unavailableReplicas ?: int32 @go (UnavailableReplicas ) @protobuf (5 ,varint ,opt )
497499
500+ // Total number of terminating pods targeted by this deployment. Terminating pods have a non-null
501+ // .metadata.deletionTimestamp and have not yet reached the Failed or Succeeded .status.phase.
502+ //
503+ // This is an alpha field. Enable DeploymentReplicaSetTerminatingReplicas to be able to use this field.
504+ // +optional
505+ terminatingReplicas ?: null | int32 @go (TerminatingReplicas ,*int32 ) @protobuf (9 ,varint ,opt )
506+
498507 // Represents the latest available observations of a deployment's current state.
499508 // +patchMergeKey=type
500509 // +patchStrategy=merge
510+ // +listType=map
511+ // +listMapKey=type
501512 conditions ?: [...#DeploymentCondition ] @go (Conditions ,[]DeploymentCondition ) @protobuf (6 ,bytes ,rep )
502513
503514 // Count of hash collisions for the Deployment. The Deployment controller uses this
@@ -621,7 +632,7 @@ import (
621632 // pod is available (Ready for at least minReadySeconds) the old DaemonSet pod
622633 // on that node is marked deleted. If the old pod becomes unavailable for any
623634 // reason (Ready transitions to false, is evicted, or is drained) an updated
624- // pod is immediatedly created on that node without considering surge limits.
635+ // pod is immediately created on that node without considering surge limits.
625636 // Allowing surge implies the possibility that the resources consumed by the
626637 // daemonset on any given node can double if the readiness check fails, and
627638 // so resource intensive daemonsets should take into account that they may
@@ -715,6 +726,8 @@ import (
715726 // +optional
716727 // +patchMergeKey=type
717728 // +patchStrategy=merge
729+ // +listType=map
730+ // +listMapKey=type
718731 conditions ?: [...#DaemonSetCondition ] @go (Conditions ,[]DaemonSetCondition ) @protobuf (10 ,bytes ,rep )
719732}
720733
@@ -817,16 +830,16 @@ import (
817830 metadata ?: metav1 .#ListMeta @go (ListMeta ) @protobuf (1 ,bytes ,opt )
818831
819832 // List of ReplicaSets.
820- // More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller
833+ // More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicaset
821834 items : [...#ReplicaSet ] @go (Items ,[]ReplicaSet ) @protobuf (2 ,bytes ,rep )
822835}
823836
824837// ReplicaSetSpec is the specification of a ReplicaSet.
825838#ReplicaSetSpec : {
826- // Replicas is the number of desired replicas .
839+ // Replicas is the number of desired pods .
827840 // This is a pointer to distinguish between explicit zero and unspecified.
828841 // Defaults to 1.
829- // More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller/#what-is-a-replicationcontroller
842+ // More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicaset
830843 // +optional
831844 replicas ?: null | int32 @go (Replicas ,*int32 ) @protobuf (1 ,varint ,opt )
832845
@@ -844,29 +857,36 @@ import (
844857
845858 // Template is the object that describes the pod that will be created if
846859 // insufficient replicas are detected.
847- // More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller #pod-template
860+ // More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicaset/ #pod-template
848861 // +optional
849862 template ?: v1 .#PodTemplateSpec @go (Template ) @protobuf (3 ,bytes ,opt )
850863}
851864
852865// ReplicaSetStatus represents the current status of a ReplicaSet.
853866#ReplicaSetStatus : {
854- // Replicas is the most recently observed number of replicas .
855- // More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller/#what-is-a-replicationcontroller
867+ // Replicas is the most recently observed number of non-terminating pods .
868+ // More info: https://kubernetes.io/docs/concepts/workloads/controllers/replicaset
856869 replicas : int32 @go (Replicas ) @protobuf (1 ,varint ,opt )
857870
858- // The number of pods that have labels matching the labels of the pod template of the replicaset.
871+ // The number of non-terminating pods that have labels matching the labels of the pod template of the replicaset.
859872 // +optional
860873 fullyLabeledReplicas ?: int32 @go (FullyLabeledReplicas ) @protobuf (2 ,varint ,opt )
861874
862- // readyReplicas is the number of pods targeted by this ReplicaSet with a Ready Condition.
875+ // The number of non-terminating pods targeted by this ReplicaSet with a Ready Condition.
863876 // +optional
864877 readyReplicas ?: int32 @go (ReadyReplicas ) @protobuf (4 ,varint ,opt )
865878
866- // The number of available replicas (ready for at least minReadySeconds) for this replica set.
879+ // The number of available non-terminating pods (ready for at least minReadySeconds) for this replica set.
867880 // +optional
868881 availableReplicas ?: int32 @go (AvailableReplicas ) @protobuf (5 ,varint ,opt )
869882
883+ // The number of terminating pods for this replica set. Terminating pods have a non-null .metadata.deletionTimestamp
884+ // and have not yet reached the Failed or Succeeded .status.phase.
885+ //
886+ // This is an alpha field. Enable DeploymentReplicaSetTerminatingReplicas to be able to use this field.
887+ // +optional
888+ terminatingReplicas ?: null | int32 @go (TerminatingReplicas ,*int32 ) @protobuf (7 ,varint ,opt )
889+
870890 // ObservedGeneration reflects the generation of the most recently observed ReplicaSet.
871891 // +optional
872892 observedGeneration ?: int64 @go (ObservedGeneration ) @protobuf (3 ,varint ,opt )
@@ -875,6 +895,8 @@ import (
875895 // +optional
876896 // +patchMergeKey=type
877897 // +patchStrategy=merge
898+ // +listType=map
899+ // +listMapKey=type
878900 conditions ?: [...#ReplicaSetCondition ] @go (Conditions ,[]ReplicaSetCondition ) @protobuf (6 ,bytes ,rep )
879901}
880902
0 commit comments