Skip to content

epam/kubernetes-kueue

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Kueue

GoReport Widget Latest Release

kueue logo

Kueue is a set of APIs and controller 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).

Read the overview to learn more.

Production Readiness status

  • ✔️ API version: v1beta1, respecting Kubernetes Deprecation Policy

  • ✔️ Up-to-date documentation.

  • ✔️ Good Test Coverage:

    • ✔️ Unit Test: ~77.2% (controllers are excluded for they're covered by integration tests)
    • ✔️ Integration Test: 124 testcases.
    • ✔️ E2E Test: available for kubernetes 1.24, 1.25, 1.26 on Kind.
  • ✔️ Scalability verification via performance tests.

  • ✔️ Monitoring via metrics.

  • ✔️ Security: RBAC based accessibility.

  • ✔️ Stable release cycle(2-3 months) for new features, bugfixes, cleanups.

    Based on community feedback, we continue to simplify and evolve the API to address new use cases.

Installation

Requires Kubernetes 1.22 or newer.

To install the latest release of Kueue in your cluster, run the following command:

kubectl apply -f https://github.com/kubernetes-sigs/kueue/releases/download/v0.3.1/manifests.yaml

The controller runs in the kueue-system namespace.

Read the installation guide to learn more.

Usage

A minimal configuration can be set by running the examples:

kubectl apply -f examples/single-clusterqueue-setup.yaml

Then you can run a job with:

kubectl create -f examples/sample-job.yaml

Learn more about:

Architecture

Learn more about the architecture of Kueue with the following design docs:

Roadmap

This is a high-level overview of the main priorities for 2023, in expected order of release:

  • Cooperative preemption support for workloads that implement checkpointing #477
  • Flavor assignment strategies, e.g. minimizing cost vs minimizing borrowing #312
  • Integration with cluster-autoscaler for guaranteed resource provisioning
  • Integration with common custom workloads #74:
    • Kubeflow (TFJob, MPIJob, etc.)
    • Spark
    • Ray
    • Workflows (Tekton, Argo, etc.)

These are features that we aim to have in the long-term, in no particular order:

  • Budget support #28
  • Dashboard for management and monitoring for administrators
  • Multi-cluster support

Community, discussion, contribution, and support

Learn how to engage with the Kubernetes community on the community page.

You can reach the maintainers of this project at:

Code of conduct

Participation in the Kubernetes community is governed by the Kubernetes Code of Conduct.

About

Kubernetes-native Job Queueing

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Go 94.6%
  • Shell 2.0%
  • HTML 1.5%
  • Makefile 1.0%
  • SCSS 0.6%
  • Smarty 0.2%
  • Dockerfile 0.1%