PodGroupSpec
io.k8s.api.scheduling.v1alpha2.PodGroupSpec
source ↗
PodGroupSpec defines the desired state of a PodGroup.
disruptionModestringDisruptionMode defines the mode in which a given PodGroup can be disrupted. Controllers are expected to fill this field by copying it from a PodGroupTemplate. One of Pod, PodGroup. Defaults to Pod if unset. This field is immutable. This field is available only when the WorkloadAwarePreemption feature gate is enabled.podGroupTemplateRefPodGroupTemplateReferencePodGroupTemplateRef references an optional PodGroup template within other object (e.g. Workload) that was used to create the PodGroup. This field is immutable.
workloadWorkloadPodGroupTemplateReferenceWorkload references the PodGroupTemplate within the Workload object that was used to create the PodGroup.
podGroupTemplateNamestring requiredPodGroupTemplateName defines the PodGroupTemplate name within the Workload object.workloadNamestring requiredWorkloadName defines the name of the Workload object.priorityinteger (int32)Priority is the value of priority of this pod group. Various system components use this field to find the priority of the pod group. When Priority Admission Controller is enabled, it prevents users from setting this field. The admission controller populates this field from PriorityClassName. The higher the value, the higher the priority. This field is immutable. This field is available only when the WorkloadAwarePreemption feature gate is enabled.priorityClassNamestringPriorityClassName defines the priority that should be considered when scheduling this pod group. Controllers are expected to fill this field by copying it from a PodGroupTemplate. Otherwise, it is validated and resolved similarly to the PriorityClassName on PodGroupTemplate (i.e. if no priority class is specified, admission control can set this to the global default priority class if it exists. Otherwise, the pod group's priority will be zero). This field is immutable. This field is available only when the WorkloadAwarePreemption feature gate is enabled.resourceClaims[]PodGroupResourceClaimResourceClaims defines which ResourceClaims may be shared among Pods in the group. Pods consume the devices allocated to a PodGroup's claim by defining a claim in its own Spec.ResourceClaims that matches the PodGroup's claim exactly. The claim must have the same name and refer to the same ResourceClaim or ResourceClaimTemplate.This is an alpha-level field and requires that the DRAWorkloadResourceClaims feature gate is enabled.This field is immutable.
namestring requiredName uniquely identifies this resource claim inside the PodGroup. This must be a DNS_LABEL.resourceClaimNamestringResourceClaimName is the name of a ResourceClaim object in the same namespace as this PodGroup. The ResourceClaim will be reserved for the PodGroup instead of its individual pods.Exactly one of ResourceClaimName and ResourceClaimTemplateName must be set.resourceClaimTemplateNamestringResourceClaimTemplateName is the name of a ResourceClaimTemplate object in the same namespace as this PodGroup.The template will be used to create a new ResourceClaim, which will be bound to this PodGroup. When this PodGroup is deleted, the ResourceClaim will also be deleted. The PodGroup name and resource name, along with a generated component, will be used to form a unique name for the ResourceClaim, which will be recorded in podgroup.status.resourceClaimStatuses.This field is immutable and no changes will be made to the corresponding ResourceClaim by the control plane after creating the ResourceClaim.Exactly one of ResourceClaimName and ResourceClaimTemplateName must be set.schedulingConstraintsPodGroupSchedulingConstraintsSchedulingConstraints defines optional scheduling constraints (e.g. topology) for this PodGroup. Controllers are expected to fill this field by copying it from a PodGroupTemplate. This field is immutable. This field is only available when the TopologyAwareWorkloadScheduling feature gate is enabled.
topology[]TopologyConstraintTopology defines the topology constraints for the pod group. Currently only a single topology constraint can be specified. This may change in the future.
keystring requiredKey specifies the key of the node label representing the topology domain. All pods within the PodGroup must be colocated within the same domain instance. Different PodGroups can land on different domain instances even if they derive from the same PodGroupTemplate. Examples: "topology.kubernetes.io/rack"schedulingPolicyPodGroupSchedulingPolicy requiredSchedulingPolicy defines the scheduling policy for this instance of the PodGroup. Controllers are expected to fill this field by copying it from a PodGroupTemplate. This field is immutable.
basicBasicSchedulingPolicyBasic specifies that the pods in this group should be scheduled using standard Kubernetes scheduling behavior.gangGangSchedulingPolicyGang specifies that the pods in this group should be scheduled using all-or-nothing semantics.
minCountinteger (int32) requiredMinCount is the minimum number of pods that must be schedulable or scheduled at the same time for the scheduler to admit the entire group. It must be a positive integer.