sigs.k8s.io/kueue@v0.6.2/site/content/en/docs/concepts/local_queue.md (about)

     1  ---
     2  title: "Local Queue"
     3  date: 2022-03-14
     4  weight: 4
     5  description: >
     6    A namespaced resource that groups closely related workloads belonging to a single tenant.
     7  ---
     8  
     9  A `LocalQueue` is a namespaced object that groups closely related Workloads
    10  that belong to a single namespace. A namespace is typically assigned to a tenant
    11  (team or user) of the organization. A `LocalQueue` points to one [`ClusterQueue`](/docs/concepts/cluster_queue)
    12  from which resources are allocated to run its Workloads.
    13  
    14  A `LocalQueue` definition looks like the following:
    15  
    16  ```yaml
    17  apiVersion: kueue.x-k8s.io/v1beta1
    18  kind: LocalQueue
    19  metadata:
    20    namespace: team-a 
    21    name: team-a-queue
    22  spec:
    23    clusterQueue: cluster-queue 
    24  ```
    25  
    26  Users submit jobs to a `LocalQueue`, instead of to a `ClusterQueue` directly.
    27  Tenants can discover which queues they can submit jobs to by listing the
    28  local queues in their namespace. The command is similar to the following:
    29  
    30  ```sh
    31  kubectl get -n my-namespace localqueues
    32  # Alternatively, use the alias `queue` or `queues`
    33  kubectl get -n my-namespace queues
    34  ```
    35  
    36  `queue` and `queues` are aliases for `localqueue`.
    37  
    38  ## What's next?
    39  
    40  - Launch a [Workload](/docs/concepts/workload) through a local queue
    41  - Read the [API reference](/docs/reference/kueue.v1beta1/#kueue-x-k8s-io-v1beta1-LocalQueue) for `LocalQueue`