Kueue is a set of APIs and controllers for job queueing. It is a job-level manager that decides when a job should be admitted to start (as in pods can be created) and when it should stop (as in active pods should be deleted).

Quick start instructions for the setup and configuration of kueue using Helm.

• Helm
• (Optional) Cert-manager

Either clone the kueue repository:

$ git clone git@github.com:kubernetes-sigs/kueue.git
$ cd kueue/charts
$ helm install kueue kueue/ --create-namespace --namespace kueue-system

Or use the charts pushed to oci://registry.k8s.io/kueue/charts/kueue:

helm install kueue oci://registry.k8s.io/kueue/charts/kueue --version="0.17.1" --create-namespace --namespace=kueue-system

For more advanced parametrization of Kueue, we recommend using a local overrides file, passed via the --values flag. For example:

controllerManager:
  featureGates:
    - name: TopologyAwareScheduling
      enabled: true
  replicas: 2
  manager:
    resources:
      limits:
        cpu: "2"
        memory: 2Gi
      requests:
        cpu: "2"
        memory: 2Gi

helm install kueue oci://registry.k8s.io/kueue/charts/kueue --version="0.17.1" \
  --create-namespace --namespace=kueue-system \
  --values overrides.yaml

You can also use the --set flag. For example, to enable a feature gate (e.g., TopologyAwareScheduling):

helm install kueue oci://registry.k8s.io/kueue/charts/kueue --version="0.17.1" \
  --create-namespace --namespace=kueue-system \
  --set "controllerManager.featureGates[0].name=TopologyAwareScheduling" \
  --set "controllerManager.featureGates[0].enabled=true"

$ kubectl get deploy -n kueue-system
NAME                           READY   UP-TO-DATE   AVAILABLE   AGE
kueue-controller-manager       1/1     1            1           7s

Kueue has support for third-party certificates. One can enable this by setting enableCertManager to true. By default the chart creates a self-signed Issuer. To reuse an existing Issuer or ClusterIssuer, set certManager.issuerRef, for example:

enableCertManager: true
certManager:
  issuerRef:
    group: cert-manager.io
    kind: ClusterIssuer
    name: my-cluster-issuer

If you reference a namespace-scoped Issuer, it must already exist in the same namespace as the Helm release. The referenced issuer must provide the CA data required by Kueue's cert-manager integration, including ca.crt in the generated Secrets and the CA bundle used for webhook and visibility API injection.

This will use certManager to generate a secret, inject the CABundles and set up the TLS.

Check out the site for more information on installing cert manager with our Helm chart.

Kueue supports Prometheus metrics. Check out the site for more information on installing kueue with metrics using our Helm chart.

The following table lists the configurable parameters of the kueue chart and their default values.