Kueue v0.10.0-rc.2

Changes since v0.9.0:

Urgent Upgrade Notes

(No, really, you MUST read this before you upgrade)

• Removed the v1alpha1 Visibility API.

  The v1alpha1 Visibility API is deprecated. Please use v1beta1 instead. (#3499, @mbobrovskyi)

• The InactiveWorkload reason for the Evicted condition is renamed to Deactivated.
  Also, the reasons for more detailed situations are renamed:

  • InactiveWorkloadAdmissionCheck -> DeactivatedDueToAdmissionCheck
  • InactiveWorkloadRequeuingLimitExceeded -> DeactivatedDueToRequeuingLimitExceeded

If you were watching for the "InactiveWorkload" reason in the "Evicted" condition, you need
to start watching for the "Deactivated" reason. (#3593, @mbobrovskyi)

Changes by Kind

Feature

• Allow mutating the queue-name label for non-running Deployments. (#3528, @mbobrovskyi)
• Allowed StatefulSet scaling down to zero and scale up from zero. (#3487, @mbobrovskyi)
• Optimize the size of the Workload object when Topology-Aware Scheduling is used, and the
  kubernetes.io/hostname is defined as the lowest Topology level. In that case the TopologyAssignment
  in the Workload's Status contains value only for this label, rather than for all levels defined. (#3677, @PBundyra)
• Promote MultiplePreemptions feature gate to stable, and drop the legacy preemption logic. (#3602, @gabesaba)
• Promoted ConfigurableResourceTransformations and WorkloadResourceRequestsSummary to Beta and enabled by default. (#3616, @dgrove-oss)
• Respect node taints in Topology-Aware Scheduling when the lowest topology level is kubernetes.io/hostname. (#3678, @mimowo)
• Support rank-based ordering of Pods with Topology-Aware Scheduling.
  The Pod indexes are determined based on the "kueue.x-k8s.io/pod-group-index" label which
  can be set by an external controller managing the group. (#3649, @PBundyra)
• TAS: support rank-based ordering for JobSet (#3591, @mimowo)
• TAS: support rank-based ordering for Kubeflow (#3604, @mbobrovskyi)
• TAS: support rank-ordering of Pods for the Kubernetes batch Job. (#3539, @mimowo)

Bug or Regression

• Added validation for Deployment queue-name to fail fast (#3555, @mbobrovskyi)
• Added validation for StatefulSet queue-name to fail fast. (#3575, @mbobrovskyi)
• Change, and in some scenarios fix, the status message displayed to user when a workload doesn't fit in available capacity. (#3536, @gabesaba)
• Determine borrowing more accurately, allowing preempting workloads which fit in nominal quota to schedule faster (#3547, @gabesaba)
• Fix accounting for usage coming from TAS workloads using multiple resources. The usage was multiplied
  by the number of resources requested by a workload, which could result in under-utilization of the cluster.
  It also manifested itself in the message in the workload status which could contain negative numbers. (#3490, @mimowo)
• Fix computing the topology assignment for workloads using multiple PodSets requesting the same
  topology. In particular, it was possible for the set of topology domains in the assignment to be empty,
  and as a consequence the pods would remain gated forever as the TopologyUngater would not have
  topology assignment information. (#3514, @mimowo)
• Fix dropping of reconcile requests for non-leading replica, which was resulting in workloads
  getting stuck pending after the rolling restart of Kueue. (#3612, @mimowo)
• Fix running Job when parallelism < completions, before the fix the replacement pods for the successfully
  completed Pods were not ungated. (#3559, @mimowo)
• Fix the bug which prevented the use of MultiKueue if there is a CRD which is not installed
  and removed from the list of enabled integrations. (#3603, @mszadkow)
• Fix the flow of deactivation for workloads due to rejected AdmissionChecks.
  Now, all AdmissionChecks are reset back to the Pending state on eviction (and deactivation in particular),
  and so an admin can easily re-activate such a workload manually without tweaking the checks. (#3350, @KPostOffice)
• Make topology levels immutable to prevent issues with inconsistent state of the TAS cache. (#3641, @mbobrovskyi)
• TAS: Fixed bug that doesn't allow to update cache on delete Topology. (#3615, @mbobrovskyi)

Other (Cleanup or Flake)

• Eliminate webhook validation in case Pod integration is used on 1.26 or earlier versions of Kubernetes. (#3247, @vladikkuzn)

Kueue v0.10.0-rc.1

Changes since v0.9.0:

Urgent Upgrade Notes

(No, really, you MUST read this before you upgrade)

• Removed the v1alpha1 Visibility API.

  The v1alpha1 Visibility API is deprecated. Please use v1beta1 instead. (#3499, @mbobrovskyi)

• The InactiveWorkload reason for the Evicted condition is renamed to Deactivated.
  Also, the reasons for more detailed situations are renamed:

  • InactiveWorkloadAdmissionCheck -> DeactivatedDueToAdmissionCheck
  • InactiveWorkloadRequeuingLimitExceeded -> DeactivatedDueToRequeuingLimitExceeded

If you were watching for the "InactiveWorkload" reason in the "Evicted" condition, you need
to start watching for the "Deactivated" reason. (#3593, @mbobrovskyi)

Changes by Kind

Feature

• Allow mutating the queue-name label for non-running Deployments. (#3528, @mbobrovskyi)
• Allowed StatefulSet scaling down to zero and scale up from zero. (#3487, @mbobrovskyi)
• TAS: support rank-based ordering for JobSet (#3591, @mimowo)
• TAS: support rank-based ordering for Kubeflow (#3604, @mbobrovskyi)
• TAS: support rank-ordering of Pods for the Kubernetes batch Job. (#3539, @mimowo)

Bug or Regression

• Added validation for Deployment queue-name to fail fast (#3555, @mbobrovskyi)
• Added validation for StatefulSet queue-name to fail fast. (#3575, @mbobrovskyi)
• Change, and in some scenarios fix, the status message displayed to user when a workload doesn't fit in available capacity. (#3536, @gabesaba)
• Determine borrowing more accurately, allowing preempting workloads which fit in nominal quota to schedule faster (#3547, @gabesaba)
• Fix accounting for usage coming from TAS workloads using multiple resources. The usage was multiplied
  by the number of resources requested by a workload, which could result in under-utilization of the cluster.
  It also manifested itself in the message in the workload status which could contain negative numbers. (#3490, @mimowo)
• Fix computing the topology assignment for workloads using multiple PodSets requesting the same
  topology. In particular, it was possible for the set of topology domains in the assignment to be empty,
  and as a consequence the pods would remain gated forever as the TopologyUngater would not have
  topology assignment information. (#3514, @mimowo)
• Fix dropping of reconcile requests for non-leading replica, which was resulting in workloads
  getting stuck pending after the rolling restart of Kueue. (#3612, @mimowo)
• Fix running Job when parallelism < completions, before the fix the replacement pods for the successfully
  completed Pods were not ungated. (#3559, @mimowo)
• Fix the bug which prevented the use of MultiKueue if there is a CRD which is not installed
  and removed from the list of enabled integrations. (#3603, @mszadkow)
• Fix the flow of deactivation for workloads due to rejected AdmissionChecks.
  Now, all AdmissionChecks are reset back to the Pending state on eviction (and deactivation in particular),
  and so an admin can easily re-activate such a workload manually without tweaking the checks. (#3350, @KPostOffice)
• Make topology levels immutable to prevent issues with inconsistent state of the TAS cache. (#3641, @mbobrovskyi)

Other (Cleanup or Flake)

• Eliminate webhook validation in case Pod integration is used on 1.26 or earlier versions of Kubernetes. (#3247, @vladikkuzn)

v0.9.1

Changes since v0.9.0:

Note

The previously anticipated feature for Topology Aware Scheduling (TAS) Rank Ordering is not part of this
patch release. This functionality has been deferred and will be included in an upcoming release.

Changes by Kind

Bug or Regression

• Change, and in some scenarios fix, the status message displayed to user when a workload doesn't fit in available capacity. (#3549, @gabesaba)
• Determine borrowing more accurately, allowing preempting workloads which fit in nominal quota to schedule faster (#3550, @gabesaba)
• Fix accounting for usage coming from TAS workloads using multiple resources. The usage was multiplied
  by the number of resources requested by a workload, which could result in under-utilization of the cluster.
  It also manifested itself in the message in the workload status which could contain negative numbers. (#3513, @mimowo)
• Fix computing the topology assignment for workloads using multiple PodSets requesting the same
  topology. In particular, it was possible for the set of topology domains in the assignment to be empty,
  and as a consequence the pods would remain gated forever as the TopologyUngater would not have
  topology assignment information. (#3524, @mimowo)
• Fix running Job when parallelism < completions, before the fix the replacement pods for the successfully
  completed Pods were not ungated. (#3561, @mimowo)
• Fix the flow of deactivation for workloads due to rejected AdmissionChecks.
  Now, all AdmissionChecks are reset back to the Pending state on eviction (and deactivation in particular),
  and so an admin can easily re-activate such a workload manually without tweaking the checks. (#3518, @KPostOffice)

v0.8.4

Changes since v0.8.3:

Changes by Kind

Bug or Regression

• Change, and in some scenarios fix, the status message displayed to user when a workload doesn't fit in available capacity (#3551, @gabesaba)
• Determine borrowing more accurately, allowing preempting workloads which fit in nominal quota to schedule faster (#3551, @gabesaba)

Kueue v0.9.0

Changes since v0.8.0:

Urgent Upgrade Notes

(No, really, you MUST read this before you upgrade)

• Changed the type of Pending events, emitted when a Workload can't be admitted, from Normal to Warning.

  Update tools that process this event if they depend on the event type. (#3264, @kebe7jun)

• Deprecated SingleInstanceInClusterQueue and FlavorIndependent status conditions.

the Admission check status conditions “FlavorIndependent” and “SingleInstanceInClusterQueue” are no longer supported by default.
If you were using any of these conditions for your external AdmissionCheck you need to enable the AdmissionCheckValidationRules feature gate.
For the future releases you will need to provide validation by an external controller. (#3254, @mszadkow)

• Promote MultiKueue API and feature gate to Beta. The MultiKueue feature gate is now beta and enabled by default.

The MultiKueue specific types are now part of the Kueue's v1beta1 API. v1alpha types are no longer supported. (#3230, @trasc)

• Promoted VisibilityOnDemand to Beta and enabled by default.

The v1alpha1 Visibility API is deprecated and will be removed in the next release. Please use v1beta1 instead. (#3008, @mbobrovskyi)

• Provides more details on the reasons for ClusterQueues being inactive.
  If you were watching for the reason CheckNotFoundOrInactive in the ClusterQueue condition, watch AdmissionCheckNotFound and AdmissionCheckInactive instead. (#3127, @trasc)
• The QueueVisibility feature and its corresponding API was deprecated.

The QueueVisibility feature and its corresponding API was deprecated and will be removed in the v1beta2. Please use VisibilityOnDemand (https://kueue.sigs.k8s.io/docs/tasks/manage/monitor_pending_workloads/pending_workloads_on_demand/) instead. (#3110, @mbobrovskyi)

Upgrading steps

1. Backup MultiKueue Resources (skip if you are not using MultiKueue):

kubectl get multikueueclusters.kueue.x-k8s.io,multikueueconfigs.kueue.x-k8s.io -A -o yaml > mk.yaml

2. Update apiVersion in Backup File (skip if you are not using MultiKueue):

Replace v1alpha1 with v1beta1 in mk.yaml for all resources:

sed -i -e 's/v1alpha1/v1beta1/g' mk.yaml

3. Delete old CRDs:

kubectl delete crd multikueueclusters.kueue.x-k8s.io
kubectl delete crd multikueueconfigs.kueue.x-k8s.io

4. Install Kueue v0.9.x:

Follow the instruction here to install.

5. Restore MultiKueue Resources (skip if you are not using MultiKueue):

kubectl apply -f mk.yaml

Changes by Kind

Feature

• Add gauge metric admission_cycle_preemption_skips that reports the number of Workloads in a ClusterQueue
  that got preemptions candidates, but had to be skipped in the last cycle. (#2919, @alculquicondor)

• Add integration for Deployment, where each Pod is treated as a separate Workload. (#2813, @vladikkuzn)

• Add integration for StatefulSet where Pods are managed by the pod-group integration. (#3001, @vladikkuzn)

• Added FlowSchema and PriorityLevelConfiguration for Visibility API. (#3043, @mbobrovskyi)

• Added a new optional resource.transformations section to the Configuration API that enables limited customization
  of how the resource requirements of a Workload are computed from the resource requests and limits of a Job. (#3026, @dgrove-oss)

• Added a way to specify dependencies between job integrations. (#2768, @trasc)

• Best effort support for scenarios when the Job is created at the same time as prebuilt workload or momentarily before the workload. In that case an error is logged to indicate that creating a Job before prebuilt-workload is outside of the intended use. (#3255, @mbobrovskyi)

• CLI: Added EXEC TIME column on kueuectl list workload command. (#2977, @mbobrovskyi)

• CLI: Added list pods for a job command. (#2280, @Kavinraja-G)

• CLI: Use protobuf encoding for core K8s APIs in kueuectl. (#3077, @tosi3k)

• Calculate AllocatableResourceGeneration more accurately. This fixes a bug where a workload might not have the Flavors it was assigned in a previous scheduling cycle invalidated, when the resources in the Cohort had changed. This bug could occur when other ClusterQueues were deleted from the Cohort. (#2984, @gabesaba)

• Detect and enable support for job CRDs installed after Kueue starts. (#2574, @ChristianZaccaria)

• Exposed available ResourceFlavors from the ClusterQueue in the LocalQueue status. (#3143, @mbobrovskyi)

• Graduated LendingLimit to Beta and enabled by default. (#2909, @macsko)

• Graduated MultiplePreemptions to Beta and enabled by default. (#2864, @macsko)

• Helm: Support the topologySpreadConstraints and PodDisruptionBudget (#3295, @woehrl01)

• Hierarchical Cohorts, introduced with the v1alpha1 Cohorts API, allow users to group resources in an arbitrary tree structure. Additionally, quotas and limits can now be defined directly at the Cohort level. See #79 for more details. (#2693, @gabesaba)

• Included visibility-api.yaml as a part of main.yaml (#3084, @mbobrovskyi)

• Introduce the "kueue.x-k8s.io/pod-group-fast-admission" annotation to Plain Pod integration.

  If the PlainPod has the annotation and is part of the Plain PodGroup, the Kueue will admit the Plain Pod regardless of whether all PodGroup Pods are created. (#3189, @vladikkuzn)

• Introduce the new PodTemplate annotation kueue.x-k8s.io/workload, and label kueue.x-k8s.io/podset.
  The annotation and label are alpha-level and gated by the new TopologyAwareScheduling feature gate. (#3228, @mimowo)

• Label kueue.x-k8s.io/managed is now added to PodTemplates created via ProvisioningRequest by Kueue (#2877, @PBundyra)

• MultiKueue: Add support for MPIJob spec.runPolicy.managedBy field (#3289, @mszadkow)

• MultiKueue: Support for the Kubeflow MPIJob (#2880, @mszadkow)

• MultiKueue: Support for the Kubeflow PaddleJob (#2744, @mszadkow)

• MultiKueue: Support for the Kubeflow PyTorchJob (#2735, @mszadkow)

• MultiKueue: Support for the Kubeflow TFJob (#2626, @mszadkow)

• MultiKueue: Support for the Kubeflow XGBoostJob (#2746, @mszadkow)

• ProvisioningRequest: Record the ProvisioningRequest creation errors to event and ProvisioningRequest status. (#3056, @IrvingMg)

• ProvisioningRequestConfig API has now RetryStrategy field that allows users to configure retries per ProvisioningRequest class. By default retry releases allocated quota in Kueue. (#3375, @PBundyra)

• Publish images via artifact registry (#2476, @IrvingMg)

• Support Topology Aware Scheduling (TAS) in Kueue in the Alpha version, along with the new Topology API
  to specify the ordered list of node labels corresponding to the different levels of hierarchy in data-centers
  (like racks or blocks).

  Additionally, we introduce the pair of Job-level annotations: http://kueue.x-k8s.io/podset-required-topology
  and kueue.x-k8s.io/podset-preferred-topology which users can use to indicate their preference for the
  Jobs to run all their Pods within a topology domain at the indicated level. (#3235, @mimowo)

• Support for JobSet 0.6 (#3034, @kannon92)

• Support for Kubernetes 1.31 (#2402, @mbobrovskyi)

• Support the Job-level API label, called kueue.x-k8s.io/max-exec-time-seconds, that users
  can use to enforce the maximum execution time for their job. The execution time is only
  accumulated when the Job is running (the corresponding Workload is admitted).
  The corresponding Workload is deactivated after the time is exceeded. (#3191, @trasc)

Documentation

• Adds installing kubectl-kueue plugin via Krew guide. (#2666, @mbobrovskyi)
• Documentation on how to use Kueue for Deployments is added (#2698, @vladikkuzn)

Bug or Regression

• CLI: Delete the corresponding Job when deleting a Workload. (#2992, @mbobrovskyi)
• CLI: Support - and . in the resource flavor name on create cq (#2703, @trasc)
• Fix a bug that could delay the election of a new leader in the Kueue with multiple replicas env. (#3093, @tenzen-y)
• Fix over-admission after deleting resources from borrowing ClusterQueue. (#2873, @mbobrovskyi)
• Fix resource consumption computation for partially admitted workloads. (#3118, @trasc)
• Fix restoring parallelism on eviction for partially admitted batch/Jobs. (#3153, @trasc)
• Fix some scenarios for partial admission which are affected by wrong calculation of resources
  used by the incoming workload which is partially admitted and preempting. (#2826, @trasc)
• Fix support for kuberay 1.2.x (#2960, @mbobrovskyi)
• Fix webook validation for batch/Job to allow partial admission of a Job to use all available resources.
  It also fixes a scenario of partial re-admission when some of the Pods are already reclaimed. (#3152, @trasc)
• Helm: Fix a bug for "unclosed action error". (#2683, @mbobrovskyi)
• Prevent infinite preemption loop when PrioritySortingWithinCohort=false
  is used together with borrowWithinCohort. (#2807, @mimowo)
• Prevent job webhooks from dropping fields for newer API fields when Kueue libraries are behind the latest released CRDs. (#3132, @alculquicondor)
• RayJob's implementation of Finished() now inspects at JobDeploymentStatus (#3120, @andrewsykim)
• Support for helm charts in the us-central1-docker.pkg.dev/k8s-staging-images/charts repository (#2680, @IrvingMg)
• Update Flavor selection logic to prefer Flavors which allow reclamation of lent nominal quota, over Flavors which require preempting workloads within the ClusterQueue. This matches the behavior in the single Flavor case. (#2811, @gabesaba)
• Workload is requeued with all AdmissionChecks set to Pending if there was an AdmissionCheck in Retry state. (#3323, @PBundyra)
• Account for NumOfHosts when calculating PodSet assignments for RayJob and RayCluster (#3384, @andrewsykim)

Other (Cleanup or...

v0.8.3

Changes since v0.8.2:

Changes by Kind

Bug or Regression

• Workload is requeued with all AdmissionChecks set to Pending if there was an AdmissionCheck in Retry state. (#3323, @PBundyra)
• Account for NumOfHosts when calculating PodSet assignments for RayJob and RayCluster (#3384, @andrewsykim)

v0.8.2

Changes since v0.8.1:

Feature

• Helm: Support the topologySpreadConstraints and PodDisruptionBudget (#3282, @woehrl01)

Bug or Regression

• Fix a bug that could delay the election of a new leader in the Kueue with multiple replicas env. (#3096, @tenzen-y)
• Fix resource consumption computation for partially admitted workloads. (#3206, @trasc)
• Fix restoring parallelism on eviction for partially admitted batch/Jobs. (#3208, @trasc)
• Fix some scenarios for partial admission which are affected by wrong calculation of resources
  used by the incoming workload which is partially admitted and preempting. (#3205, @trasc)
• Fix webook validation for batch/Job to allow partial admission of a Job to use all available resources.
  It also fixes a scenario of partial re-admission when some of the Pods are already reclaimed. (#3207, @trasc)
• Prevent job webhooks from dropping fields for newer API fields when Kueue libraries are behind the latest released CRDs. (#3358, @mbobrovskyi)
• RayJob's implementation of Finished() now inspects at JobDeploymentStatus (#3128, @andrewsykim)

Other (Cleanup or Flake)

• Add a jobframework.BaseWebhook that can be used for custom job integrations (#3355, @mbobrovskyi)

Kueue v0.9.0-rc.1

Changes since v0.8.0:

Urgent Upgrade Notes

(No, really, you MUST read this before you upgrade)

• Changed the type of Pending events, emitted when a Workload can't be admitted, from Normal to Warning.

  Update tools that process this event if they depend on the event type. (#3264, @kebe7jun)

• Deprecated SingleInstanceInClusterQueue and FlavorIndependent status conditions.

the Admission check status conditions “FlavorIndependent” and “SingleInstanceInClusterQueue” are no longer supported by default.
If you were using any of these conditions for your external AdmissionCheck you need to enable the AdmissionCheckValidationRules feature gate.
For the future releases you will need to provide validation by an external controller. (#3254, @mszadkow)

• Promote MultiKueue API and feature gate to Beta. The MultiKueue feature gate is now beta and enabled by default.

The MultiKueue specific types are now part of the Kueue's v1beta1 API. v1alpha types are no longer supported. (#3230, @trasc)

• Promoted VisibilityOnDemand to Beta and enabled by default.

The v1alpha1 Visibility API is deprecated and will be removed in the next release. Please use v1beta1 instead. (#3008, @mbobrovskyi)

• Provides more details on the reasons for ClusterQueues being inactive.
  If you were watching for the reason CheckNotFoundOrInactive in the ClusterQueue condition, watch AdmissionCheckNotFound and AdmissionCheckInactive instead. (#3127, @trasc)
• The QueueVisibility feature and its corresponding API was deprecated.

The QueueVisibility feature and its corresponding API was deprecated and will be removed in the v1beta2. Please use VisibilityOnDemand (https://kueue.sigs.k8s.io/docs/tasks/manage/monitor_pending_workloads/pending_workloads_on_demand/) instead. (#3110, @mbobrovskyi)

Changes by Kind

Feature

• Add gauge metric admission_cycle_preemption_skips that reports the number of Workloads in a ClusterQueue
  that got preemptions candidates, but had to be skipped in the last cycle. (#2919, @alculquicondor)

• Add integration for Deployment, where each Pod is treated as a separate Workload. (#2813, @vladikkuzn)

• Add integration for StatefulSet where Pods are managed by the pod-group integration. (#3001, @vladikkuzn)

• Added FlowSchema and PriorityLevelConfiguration for Visibility API. (#3043, @mbobrovskyi)

• Added a new optional resource.transformations section to the Configuration API that enables limited customization
  of how the resource requirements of a Workload are computed from the resource requests and limits of a Job. (#3026, @dgrove-oss)

• Added a way to specify dependencies between job integrations. (#2768, @trasc)

• Best effort support for scenarios when the Job is created at the same time as prebuilt workload or momentarily before the workload. In that case an error is logged to indicate that creating a Job before prebuilt-workload is outside of the intended use. (#3255, @mbobrovskyi)

• CLI: Added EXEC TIME column on kueuectl list workload command. (#2977, @mbobrovskyi)

• CLI: Added list pods for a job command. (#2280, @Kavinraja-G)

• CLI: Use protobuf encoding for core K8s APIs in kueuectl. (#3077, @tosi3k)

• Calculate AllocatableResourceGeneration more accurately. This fixes a bug where a workload might not have the Flavors it was assigned in a previous scheduling cycle invalidated, when the resources in the Cohort had changed. This bug could occur when other ClusterQueues were deleted from the Cohort. (#2984, @gabesaba)

• Detect and enable support for job CRDs installed after Kueue starts. (#2574, @ChristianZaccaria)

• Exposed available ResourceFlavors from the ClusterQueue in the LocalQueue status. (#3143, @mbobrovskyi)

• Graduated LendingLimit to Beta and enabled by default. (#2909, @macsko)

• Graduated MultiplePreemptions to Beta and enabled by default. (#2864, @macsko)

• Helm: Support the topologySpreadConstraints and PodDisruptionBudget (#3295, @woehrl01)

• Hierarchical Cohorts, introduced with the v1alpha1 Cohorts API, allow users to group resources in an arbitrary tree structure. Additionally, quotas and limits can now be defined directly at the Cohort level. See #79 for more details. (#2693, @gabesaba)

• Included visibility-api.yaml as a part of main.yaml (#3084, @mbobrovskyi)

• Introduce APIs for Topology Aware Scheduling. (#3235, @mimowo)

• Introduce the "kueue.x-k8s.io/pod-group-fast-admission" annotation to Plain Pod integration.

  If the PlainPod has the annotation and is part of the Plain PodGroup, the Kueue will admit the Plain Pod regardless of whether all PodGroup Pods are created. (#3189, @vladikkuzn)

• Introduce the new PodTemplate annotation kueue.x-k8s.io/workload, and label kueue.x-k8s.io/podset.
  The annotation and label are alpha-level and gated by the new TopologyAwareScheduling feature gate. (#3228, @mimowo)

• Kjobctl: Support --profile and --local queue options for the listing jobs, which are used to filter out listed jobs. (#2736, @mbobrovskyi)

• Label kueue.x-k8s.io/managed is now added to PodTemplates created via ProvisioningRequest by Kueue (#2877, @PBundyra)

• MultiKueue: Support for the Kubeflow MPIJob (#2880, @mszadkow)

• MultiKueue: Support for the Kubeflow PaddleJob (#2744, @mszadkow)

• MultiKueue: Support for the Kubeflow PyTorchJob (#2735, @mszadkow)

• MultiKueue: Support for the Kubeflow TFJob (#2626, @mszadkow)

• MultiKueue: Support for the Kubeflow XGBoostJob (#2746, @mszadkow)

• ProvisioningRequest: Record the ProvisioningRequest creation errors to event and ProvisioningRequest status. (#3056, @IrvingMg)

• Publish images via artifact registry (#2476, @IrvingMg)

• Support for JobSet 0.6 (#3034, @kannon92)

• Support for Kubernetes 1.31 (#2402, @mbobrovskyi)

• [workload] Add MaximumExecutionTimeSeconds, a mechanism to automatically deactivate a workload if it's execution takes more time that expected. (#3184, @trasc)

Documentation

• Adds installing kubectl-kueue plugin via Krew guide. (#2666, @mbobrovskyi)
• Documentation on how to use Kueue for Deployments is added (#2698, @vladikkuzn)

Bug or Regression

• CLI: Delete the corresponding Job when deleting a Workload. (#2992, @mbobrovskyi)
• CLI: Support - and . in the resource flavor name on create cq (#2703, @trasc)
• Fix a bug that could delay the election of a new leader in the Kueue with multiple replicas env. (#3093, @tenzen-y)
• Fix over-admission after deleting resources from borrowing ClusterQueue. (#2873, @mbobrovskyi)
• Fix resource consumption computation for partially admitted workloads. (#3118, @trasc)
• Fix restoring parallelism on eviction for partially admitted batch/Jobs. (#3153, @trasc)
• Fix some scenarios for partial admission which are affected by wrong calculation of resources
  used by the incoming workload which is partially admitted and preempting. (#2826, @trasc)
• Fix support for kuberay 1.2.x (#2960, @mbobrovskyi)
• Fix webook validation for batch/Job to allow partial admission of a Job to use all available resources.
  It also fixes a scenario of partial re-admission when some of the Pods are already reclaimed. (#3152, @trasc)
• Helm: Fix a bug for "unclosed action error". (#2683, @mbobrovskyi)
• Prevent infinite preemption loop when PrioritySortingWithinCohort=false
  is used together with borrowWithinCohort. (#2807, @mimowo)
• Prevent job webhooks from dropping fields for newer API fields when Kueue libraries are behind the latest released CRDs. (#3132, @alculquicondor)
• RayJob's implementation of Finished() now inspects at JobDeploymentStatus (#3120, @andrewsykim)
• Support for helm charts in the us-central1-docker.pkg.dev/k8s-staging-images/charts repository (#2680, @IrvingMg)
• Update Flavor selection logic to prefer Flavors which allow reclamation of lent nominal quota, over Flavors which require preempting workloads within the ClusterQueue. This matches the behavior in the single Flavor case. (#2811, @gabesaba)

Other (Cleanup or Flake)

• Add a jobframework.BaseWebhook that can be used for custom job integrations (#3102, @alculquicondor)

Kueue v0.8.1

Changes since v0.8.0:

Feature

• Add gauge metric admission_cycle_preemption_skips that reports the number of Workloads in a ClusterQueue
  that got preemptions candidates, but had to be skipped in the last cycle. (#2942, @alculquicondor)
• Publish images via artifact registry (#2832, @alculquicondor)

Bug or Regression

• CLI: Support - and . in the resource flavor name on create cq (#2706, @trasc)
• Detect and enable support for job CRDs installed after Kueue starts. (#2991, @ChristianZaccaria)
• Fix over-admission after deleting resources from borrowing ClusterQueue. (#2879, @mbobrovskyi)
• Fix support for kuberay 1.2.x (#2983, @mbobrovskyi)
• Helm: Fix a bug for "unclosed action error". (#2688, @mbobrovskyi)
• Prevent infinite preemption loop when PrioritySortingWithinCohort=false
  is used together with borrowWithinCohort. (#2831, @mimowo)
• Support for helm charts in the us-central1-docker.pkg.dev/k8s-staging-images/charts repository (#2834, @IrvingMg)
• Update Flavor selection logic to prefer Flavors which allow reclamation of lent nominal quota, over Flavors which require preempting workloads within the ClusterQueue. This matches the behavior in the single Flavor case. (#2829, @gabesaba)

Kueue v0.8.0

Changes since v0.7.0:

Urgent Upgrade Notes

(No, really, you MUST read this before you upgrade)

• Use a single rate limiter for all API types clients.

  Consider adjusting clientConnection.qps and clientConnection.burst if you observe any performance degradation. (#2462, @trasc)

Feature

• Add a column to workload indicating if it is finished (#2615, @highpon)

• Add preempted_workloads_total metric that tracks the number of preemptions issued by a ClusterQueue) (#2538, @vladikkuzn)

• Add the following events for eviction on the workload indicating the reason for eviction:

  • "EvictedDueToPodsReadyTimeout"
  • "EvictedDueToAdmissionCheck"
  • "EvictedDueToClusterQueueStopped"
  • "EvictedDueToInactiveWorkload" (renamed from InactiveWorkload)

  If you were watching for the typed Normal event with InactiveWorkload reason, use EvictedDueToInactiveWorkload reason one instead. (#2376, @mbobrovskyi)

• AdmissionChecks: A workload with a Rejected AdmissionCheck gets deactivated (#2363, @PBundyra)

• Allow stoping admission from a specific LocalQueue. (#2173, @mbobrovskyi)

• Allow usage of the pod integration for pods belonging to jobs that Kueue supports, if the support for the job type is explicitly disabled (#2493, @trasc)

• CLI: Add stop/resume localqueue commands (#2415, @rainfd)

• CLI: Added Node Labels column on resource flavor list. (#2557, @mbobrovskyi)

• CLI: Added create resourceflavor command. (#2517, @mbobrovskyi)

• CLI: Added list resourceflavor command. (#2525, @mbobrovskyi)

• CLI: Added resourceflavor to pass-through commands. (#2518, @mbobrovskyi)

• CLI: Added version command. (#2346, @mbobrovskyi)

• CLI: Adds for filter to list workloads. (#2238, @IrvingMg)

• CLI: Adds create clusterqueue command. (#2201, @IrvingMg)

• CLI: Support autocompletion (#2314, @mbobrovskyi)

• CLI: Support paging on kueue CLI list commands. (#2313, @mbobrovskyi)

• CLI: kubectl-kueue tar.gz archives is part of the release artifacts. (#2513, @mbobrovskyi)

• Do not start Kueue when the visibility server cannot be started, but is requested. (#2636, @mbobrovskyi)

• Experimental support for helm charts in the gcr.io/k8s-staging-kueue/charts/kueue repository (#2377, @IrvingMg)

• Improved logging for scheduling and preemption in levels 4 and 5 (#2504, @alculquicondor)

• Introduce the MultiplePreemptions flag, which allows more than one
  preemption to occur in the same scheduling cycle, even with overlapping
  FlavorResources (#2641, @gabesaba)

• More granular Preemption condition reasons: InClusterQueue, InCohortReclamation, InCohortFairSharing, InCohortReclaimWhileBorrowing (#2411, @vladikkuzn)

• MultiKueue: Allow for defaulting of the spec.managedBy field for Jobs managed by MultiKueue.
  The defaulting is enabled by the MultiKueueBatchJobWithManagedBy feature-gate. (#2401, @vladikkuzn)

• MultiKueue: Remove remote objects synchronously when the worker cluster is reachable. (#2347, @trasc)

• MultiKueue: Use batch/Job spec.managedBy field (#2331, @trasc)

• Multikueue: Batch reconcile events for remote workloads. (#2380, @trasc)

• ProvisioningRequest: Support for ProvisioningRequest's condition BookingExpired (#2445, @PBundyra)

• ProvisioningRequets: Support for ProvisioningRequest's condition CapacityRevoked. ProvisioningRequests objects persist until the corresponding Job or the Workload is deleted (#2196, @PBundyra)

Documentation

• Added details documentation for kubectl-kueue plugin. (#2613, @mbobrovskyi)
• Improve the documentation for the waitForPodsReady (#2541, @mimowo)

Bug or Regression

• Added raycluster roles to manifests.yaml (#2618, @mbobrovskyi)
• CLI: Fixed no Auth Provider found for name "oidc" error. (#2602, @Kavinraja-G)
• Fix check that prevents preemptions when a workload requests 0 for a resource that is at nominal or over it. (#2520, @alculquicondor)
• Fix for the scenario when a workload doesn't match some resource flavors due to affinity or taints
  could cause the workload to be continuously retried. (#2407, @KunWuLuan)
• Fix missing fairSharingStatus in ClusterQueue (#2424, @mbobrovskyi)
• Fix missing metric cluster_queue_status (#2474, @mbobrovskyi)
• Fix panic that could occur when a ClusterQueue is deleted while Kueue was updating the ClusterQueue status. (#2461, @mbobrovskyi)
• Fix panic when there is not enough quota to assign flavors to a Workload in the cohort, when FairSharing is enabled. (#2439, @mbobrovskyi)
• Fix performance issue in logging when processing LocalQueues. (#2485, @alexandear)
• Fix race condition on delete workload from queue manager. (#2460, @mbobrovskyi)
• Fix race condition on requeue workload. (#2509, @mbobrovskyi)
• Fix race condition on run garbage collection in multikueuecluster reconciler. (#2479, @mbobrovskyi)
• Fix the validation messages, to report the new value rather than old, for the following immutable labels: kueue.x-k8s.io/queue-name, kueue.x-k8s.io/prebuilt-workload-name, and kueue.x-k8s.io/priority-class. (#2544, @xuxianzhang)
• Fixed issue that prevented restoring the startTime and pod template when evicting a batch/v1 Job, if any API errors happened in the process (#2567, @mbobrovskyi)
• MultiKueue: Do not reject a JobSet if the corresponding cluster queue doesn't exist (#2425, @vladikkuzn)
• MultiKueue: Skip garbage collection for disconnected clients which could occasionally result in panic. (#2369, @trasc)
• Show weightedShare in ClusterQueue status.fairSharing even if the value is zero (#2521, @alculquicondor)
• Skip duplicate Tolerations when an admission check introduces a toleration that the job also set. (#2498, @trasc)

Other (Cleanup or Flake)

• Importer: corrects the field name observedFirstIn in logs. (#2500, @alexandear)
• Use Patch instead of Update on jobframework multikueue adapters to prevent the risk of dropping fields. (#2590, @mbobrovskyi)
• Use Patch instead of Update on jobframework to prevent the risk of dropping fields. (#2553, @mbobrovskyi)