8.4. 强制使用本地队列

流程

1. 在 OpenShift 控制台中，打开 Administrator 视角。
2. 从 Project 列表中，选择 All Projects。
3. 点 Home Search。
4. 在 Resources 列表中，搜索 ValidatingAdmissionPolicyBinding。
5. 点 kue-validating-admission-policy-binding 条目打开详情页面。
6. 点 YAML 选项卡显示绑定规格。

7. 确保将以下字段设置为指定的值：

   为所有项目强制执行 local-queue 标签的示例

   kind: ValidatingAdmissionPolicyBinding
   apiVersion: admissionregistration.k8s.io/v1
   metadata:
     name: kueue-validating-admission-policy-binding
     uid: <Populated by the system. Read-only.>
     resourceVersion: <Populated by the system. Read-only.>
     generation: <Populated by the system. Read-only.>
     creationTimestamp: <Populated by the system. Read-only.>
     labels:
       app.kubernetes.io/component: controller
       app.kubernetes.io/name: kueue
     managedFields:
   spec:
     policyName: kueue-validating-admission-policy
     matchResources:
       namespaceSelector: {}
       objectSelector: {}
       matchPolicy: Equivalent
     validationActions:
       - Deny

8. 如果您进行任何更改，请单击 Save。

1. 创建一个项目。

2. 在新项目中完成以下步骤：

   1. 在配置本地队列前，请尝试创建 Ray 集群。

      Validating Admission Policy 拒绝请求，Ray 集群不会被创建，因为没有配置本地队列。

   2. 创建没有 default-queue 注解的本地队列。

   3. 尝试创建 Ray 集群，并在 local_queue 字段中指定 local-queue 名称。

      Validating Admission Policy 批准请求，并创建了 Ray 集群。

   4. 尝试在 local_queue 字段中指定值的情况下创建 Ray 集群。

      Validating Admission Policy rejects 请求，Ray 集群没有被创建，因为没有指定本地队列，且没有配置默认的本地队列。

   5. 编辑本地队列以添加 kueue.x-k8s.io/default-queue: "true" 注解，它将该队列配置为默认本地队列。

   6. 尝试在 local_queue 字段中指定值的情况下创建 Ray 集群。

      Validating Admission Policy 批准请求，即使未指定本地队列，也会创建 Ray 集群，因为使用了默认的本地队列。

1. 在新项目中完成以下步骤：

   1. 在配置本地队列前，请尝试创建 PyTorchJob。

      Validating Admission Policy rejects 请求，并且没有创建 PyTorchJob，因为没有配置本地队列。

   2. 创建本地队列。

   3. 尝试创建 PyTorchJob，并在 labels 字段中添加 kueue.x-k8s.io/queue-name: <local-queue-name > 标签。

      Validating Admission Policy 批准请求，并创建了 PyTorchJob。

   4. 在 labels 字段中指定 kueue.x-k8s.io/queue-name 标签的情况下，尝试创建 PyTorchJob。

      Validating Admission Policy rejects 请求，并且没有创建 PyTorchJob，因为没有指定本地队列。

流程

1. 在 OpenShift 控制台中，打开 Administrator 视角。
2. 从 Project 列表中，选择 All Projects。
3. 点 Home Search。
4. 在 Resources 列表中，搜索 ValidatingAdmissionPolicyBinding。
5. 点 kue-validating-admission-policy-binding 条目打开详情页面。
6. 点 YAML 选项卡显示绑定规格。

7. 编辑 policyName 字段，将值更改为 disabled，如下例所示：

   为所有项目禁用 local-queue 标签的示例

   kind: ValidatingAdmissionPolicyBinding
   apiVersion: admissionregistration.k8s.io/v1
   metadata:
     name: kueue-validating-admission-policy-binding
     uid: <Populated by the system. Read-only.>
     resourceVersion: <Populated by the system. Read-only.>
     generation: <Populated by the system. Read-only.>
     creationTimestamp: <Populated by the system. Read-only.>
     labels:
       app.kubernetes.io/component: controller
       app.kubernetes.io/name: kueue
     managedFields:
   spec:
     policyName: disabled
     matchResources:
       namespaceSelector: {}
       objectSelector: {}
       matchPolicy: Equivalent
     validationActions:
       - Deny

8. 点击 Save。

1. 创建一个项目。

2. 在新项目中完成以下步骤：

   1. 在配置本地队列前，请尝试创建 Ray 集群。

      即使没有配置本地队列，也会创建 Ray 集群，因为无法强制执行 Validating Admission Policy。但是，Ray 集群资源不由 Kue 管理。

   2. 创建没有 default-queue 注解的本地队列。

   3. 尝试创建 Ray 集群，并在 local_queue 字段中指定 local-queue 名称。

      Ray 集群已创建，Ray 集群资源由 Kueue 管理。

   4. 尝试在 local_queue 字段中指定值的情况下创建 Ray 集群。

      Ray 集群已创建，但 Ray 集群资源不受 Kue 管理。

   5. 编辑本地队列以添加 kueue.x-k8s.io/default-queue: "true" 注解，它将该队列配置为默认本地队列。

   6. 尝试在 local_queue 字段中指定值的情况下创建 Ray 集群。

      Ray 集群已创建，Ray 集群资源由 Kueue 管理。

1. 创建一个项目。

2. 在新项目中完成以下步骤：

   1. 在配置本地队列前，请尝试创建 PyTorchJob。

      即使没有配置本地队列，也会创建 PyTorchJob，因为无法强制执行 Validating Admission Policy。PyTorchJob 资源不由 Kueue 管理。

   2. 创建本地队列。

   3. 尝试创建 PyTorchJob，并在 labels 字段中添加 kueue.x-k8s.io/queue-name: <local-queue-name > 标签。

      PyTorchJob 已创建，PyTyJob 资源由 Kueue 管理。

   4. 尝试在 labels 字段中添加 kueue.x-k8s.io/queue-name: <local-queue-name> 标签的情况下创建 PyTorchJob。

      PyTorchJob 已创建，但 PyTorchJob 资源不由 Kue 管理。

流程

1. 在 OpenShift 控制台中，打开 Administrator 视角。
2. 从 Project 列表中，选择 All Projects。
3. 点 Home Search。
4. 在 Resources 列表中，搜索 ValidatingAdmissionPolicyBinding。
5. 点 kue-validating-admission-policy-binding 条目打开详情页面。
6. 点 YAML 选项卡显示绑定规格。

7. 编辑 namespaceSelector 字段以删除 {} 值，并添加 matchLabels 和 kueue.openshift.io/managed 值，如下例所示：

   重要

   kueue.openshift.io/managed=true 标签只支持 OpenShift AI 项目。

   仅为某些项目强制执行 local-queue 标签示例

   kind: ValidatingAdmissionPolicyBinding
   apiVersion: admissionregistration.k8s.io/v1
   metadata:
     name: kueue-validating-admission-policy-binding
     uid: <Populated by the system. Read-only.>
     resourceVersion: <Populated by the system. Read-only.>
     generation: <Populated by the system. Read-only.>
     creationTimestamp: <Populated by the system. Read-only.>
     labels:
       app.kubernetes.io/component: controller
       app.kubernetes.io/name: kueue
     managedFields:
   spec:
     policyName: kueue-validating-admission-policy
     matchResources:
       namespaceSelector:
         matchLabels:
         kueue.openshift.io/managed: "true"
       objectSelector: {}
       matchPolicy: Equivalent
     validationActions:
       - Deny

8. 点击 Save。

9. 运行以下命令，将 kue.openshift.io/managed 标签添加到您要为其强制执行此策略的每个项目：

   将 kueue.openshift.io/managed 标签添加到项目的命令示例

   oc label namespace <project-name> kueue.openshift.io/managed=true

验证

1. 创建两个项目：项目 A 和项目 B。
2. 将 kueue.openshift.io/managed 标签添加到 Project A。

3. 在每个项目中，尝试创建 Ray 集群或 PyTorchJob。

   • 在项目 A 和具有 kue.openshift.io/managed 标签的所有项目中，其行为如 为所有项目 强制 local-queue 标签策略 中所述。
   • 在 Project B 和没有 kue.openshift.io/managed 标签的项目中，其行为如 禁用所有项目的 local-queue 标签策略 中所述。