队列

概述

队列（Queue）是 T9k-Scheduler 提供的集群资源管理机制。

如果使用了 T9k-Scheduler，用户创建工作负载时，则可以选择使用一个特定的 Queue 申请集群资源。

队列设置

管理员创建在集群中创建多个 Queue ，并可设置：

• Queue 的使用权限，以规定那些人员/组/项目可使用此 queue;
• Queue 对应的计算节点集合，以方便地管理计算节点的使用；
• 资源配额，限制通过此 Queue 使用的资源上限。

使用权限

Queue 的使用权限用于控制哪些用户、组、项目可以使用这个队列。队列的使用权限通过两种方式进行设置：

• 管理员直接设置有权使用队列的用户/用户组。
• 管理员设置队列的 spec.namespaceSelector（类型是 labelSelector）字段。

当项目满足下列任一条件时，用户有权在项目下创建使用某个队列的工作负载：

• 队列设置了 spec.namespaceSelector，并且项目对应的 namespace 的标签符合这个 namespaceSelector。
• 项目的用户有权使用这个队列。

节点限制

队列的节点限制用于指定队列可用的集群工作节点（worker node），T9k-Scheduler 只会将队列内的工作负载分配到这些特定的节点上。

队列的 spec.nodeSelector （类型是 labelSelector）字段用于设置队列的节点权限：

• 字段未设置时，队列可以使用集群内所有的节点
• 字段设置后，队列可以使用节点标签满足 nodeSelector 的节点。

在下面的节点权限示例中：说明队列可以使用节点标签包含 topology.kubernetes.io/zone: peking 或 topology.kubernetes.io/zone: tianjin 的节点。

spec:
  nodeSelector:
    matchExpressions:
    - key: topology.kubernetes.io/zone
      operator: In
      values:
      - peking
      - tianjin

资源配额

队列的资源配额用于限制队列可以使用的资源上限，如果用户创建的工作负载（例如 Job，Pod 等）会导致队列超出资源配额限制，那么系统会拒绝接受此工作负载。

队列的 spec.quota 字段定义队列的资源配额，队列的 status.allocated 字段表明队列已经使用的资源量。

在下面的示例中：

• 工作负载的 CPU 资源请求量（requests）总和不能超过 40；
• Queue 已经被分配了 38 个 CPU。

spec:
  quota:
    requests:
      cpu: 40
status:
  allocated:
    cpu: "38"

优先级

spec.priority 字段定义队列的优先级，值类型是 int，范围是 [0,100]，数值越大代表队列的优先级越高。队列的优先级会影响下列事件：

• 优先级较高的队列会被优先分配资源。
• 如果 T9k-Scheduler 开启了资源抢占行为，优先级较高的队列有权抢占低优先级队列使用的资源。

是否可被抢占资源

spec.preemptible 字段定义队列是否可以被其他队列抢占资源，字段值类型是 bool：

• false ，队列无法被抢占资源；
• true ，队列可以被抢占资源。

开启/关闭

spec.closed 字段定义队列是否处于关闭状态，当队列被关闭了，用户无法创建使用该队列的工作负载。字段值类型是 bool：

• 字段未设置或被设置为 false 时，队列处于开启状态；
• 字段被设置为 true 时，队列处于关闭状态。

最大运行时长

最大运行时长会限制队列中 Pod 的运行时长，如果 Pod 的存在时长（存在时长=当前时间 - Pod 创建时间）超过最大运行时长，Pod 会被删除。

队列的 spec.maxDuration 字段设置了队列的最大运行时长：

• 值类型是 string，并且需要满足正则表达式 ^(0|(([0-9]+)y)?(([0-9]+)w)?(([0-9]+)d)?(([0-9]+)h)?(([0-9]+)m)?(([0-9]+)s)?(([0-9]+)ms)?)$。
• 支持的时间单位：y, w（周）, d, h, m, s, ms。
• 示例：“3w”, “2h45m”。
• 未设置时，队列不受最大运行时长约束。

资源尺寸

资源尺寸（resource shape）会限制队列中工作负载请求资源量的上限，当用户创建超过资源尺寸的工作负载时，工作负载会被系统拒绝。

队列的 spec.resourceShapeProfile 字段设置了队列使用的资源尺寸模版，模型对应的资源尺寸详情存储在 ConfigMap t9k-system/resource-shapes 中。用户可以通过 T9k 产品前端查看队列的资源尺寸设置。

下一步

• 了解如何使用队列
• 队列 API Reference