> ## Documentation Index
> Fetch the complete documentation index at: https://docs.siflow.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 管理算力资源池和配额

> 创建、编辑和扩缩容实例资源池，配置个人配额、资源管理员和可提交的负载类型。

资源池用于组织 GPU / CPU 实例配额。通过资源池，您可以把算力分配给不同团队、用户或任务类型，并控制开发环境、训练任务和推理服务可以使用哪些资源。

## 资源池类型与配额限制

### 资源池类型

共享资源池由平台按资源类型组织。专属资源池和独占资源池支持创建、编辑和删除。

| 资源池类型 | 管理方式                            | 适用场景                   |
| ----- | ------------------------------- | ---------------------- |
| 共享资源池 | 配额由租户内用户共享消费，可在详情页管理授权用户和用户级配置。 | 通用开发、调试和弹性任务。          |
| 专属资源池 | 可按用户授权和配置个人配额。                  | 为指定用户或团队预留资源，或限制负载类型。  |
| 独占资源池 | 独占整节点，并展示节点健康状态。                | 需要整节点独占、资源隔离或更稳定调度的任务。 |

### 独占资源池整机校验

独占资源池要求资源按整节点对齐：

| 资源类型   | 整机校验要求          |
| ------ | --------------- |
| CPU 实例 | 以整机 120 CU 为单位。 |
| GPU 实例 | 以整机 8 卡为单位。     |

创建、扩容、缩容或购买订单时指定独占资源池，都需要满足整机校验。不满足要求时，操作无法提交。

## 新建资源池

共享资源池通常由平台按资源类型提供。专属资源池和独占资源池需要根据团队用量、隔离要求和配额去向单独创建。

创建前，请确认当前账号具有组织管理员权限，并且已有可分配的实例配额。如果创建独占资源池，实例配额还需满足整机校验要求。

1. 进入 **所用资源 > 实例资源（新版）**。
2. 单击 **新建资源池**。
3. 填写资源池配置。

| 参数      | 说明                                                |
| ------- | ------------------------------------------------- |
| 区域      | 资源池所属区域。                                          |
| 集群      | 资源池所属计算集群。                                        |
| 实例      | 资源池使用的实例规格。                                       |
| 名称      | 资源池显示名称，需在租户内唯一。                                  |
| 资源池总配额  | 分配给资源池的总资源量。                                      |
| 用户默认配额  | 用户在该资源池下的默认个人配额。                                  |
| 默认用户优先级 | 用户默认的优先级。                                         |
| 项目组     | 资源池所属项目组。                                         |
| 类型      | 选择 **专属** 或 **独占**。                               |
| 支持的负载类型 | 允许提交到该资源池的任务类型。                                   |
| 描述      | 关于该资源池的说明。                                        |
| 故障机自动轮转 | 仅独占资源池可配置。控制独占资源池中故障节点是否自动轮转。                     |
| 闲时共享    | 仅独占资源池可配置。控制独占资源池是否允许闲时共享。                        |
| 允许资源保障  | 控制该资源池是否允许使用资源保障。关闭后，本资源池的用户即使被单独授权，也不可将任务设为资源保障。 |
| 冻结资源池   | 控制资源池是否冻结。                                        |

4. 单击 **新建**。

创建完成后，资源池会进入创建中状态。状态变为就绪后，授权用户可以在开发环境、训练任务或推理服务中选择该资源池。如果独占资源池的配额不满足整机校验，创建操作无法提交；资源池就绪后，您可以在详情中查看节点健康状态。

<img src="https://mintcdn.com/siflow/avekptrv6O-LsLPz/ai-platform/resources/media/compute-resource-pool-list.png?fit=max&auto=format&n=avekptrv6O-LsLPz&q=85&s=0f0365136d58eddc9ad3bb8dffaf76fc" alt="算力资源池列表" width="2418" height="1206" data-path="ai-platform/resources/media/compute-resource-pool-list.png" />

## 查看资源池详情

进入 **所用资源 > 实例资源（新版）** 后，单击目标资源池名称，进入资源池详情页。

<img src="https://mintcdn.com/siflow/avekptrv6O-LsLPz/ai-platform/resources/media/compute-resource-pool-details.png?fit=max&auto=format&n=avekptrv6O-LsLPz&q=85&s=009380f51fee01a9e08ea82e76989153" alt="算力资源池详情" width="2388" height="1194" data-path="ai-platform/resources/media/compute-resource-pool-details.png" />

详情页适合完成以下判断和操作：

| 目标        | 说明                                                                                 |
| --------- | ---------------------------------------------------------------------------------- |
| 确认资源池是否可用 | 查看资源池状态、支持负载类型、配额、已用、空闲和不可用资源。                                                     |
| 管理资源池配置   | 通过 **编辑** 修改资源池名称、描述、支持负载类型或资源策略。                                                  |
| 调整资源池容量   | 通过 **扩缩容** 调整资源池总配额。                                                               |
| 管理用户级配置   | 通过 **用户信息** 页签添加用户，配置个人配额、优先级和资源保障。                                                |
| 排查负载占用    | 通过 **工作负载** 页签查看当前占用资源池的开发环境、训练任务或推理服务等负载。需要处理异常占用时，可按名称、负载类型或用户筛选，并在确认影响后停止或删除负载。 |
| 分析容量趋势    | 通过 **资源监控** 页签查看配额与已用资源、CPU 调度率、不可用资源等趋势，判断资源池是否长期紧张、是否需要扩容或调整负载分布。                |
| 追溯配置变更    | 通过 **历史操作记录** 页签按操作人和时间范围追溯资源池配置、用户配额等管理操作，定位配置变更来源。                               |

资源池操作通常是异步执行。提交创建、扩缩容、转换、重命名或删除操作后，可以通过资源池状态判断操作是否完成。资源池就绪后可继续使用；如果操作失败，请结合页面提示确认失败原因，必要时联系平台管理员处理。

独占资源池还会展示节点健康状态。所有节点正常时，状态为 `healthy`；存在异常时，页面会展示具体节点异常信息。

## 调整资源池配置

资源池创建后，您可以根据管理需求继续调整资源池配置。

操作前，请确认当前账号具有组织管理员权限，或是目标资源池的资源管理员。

在资源池列表或资源池详情页中，可以执行以下操作。不同资源池类型和账号权限下，可用操作可能不同。

* **编辑**：修改资源池名称、描述、支持负载类型或其他资源池配置。
* **允许 / 不允许资源保障**：控制资源池是否允许用户使用资源保障。关闭后，本资源池的用户即使被单独授权，也不可将任务设为资源保障。
* **默认用户优先级**：调整资源池的默认用户优先级。
* **用户默认配额**：调整资源池中新授权用户或跟随默认配置用户的默认配额。
* **调整项目组**：修改资源池所属项目组。
* **删除**：删除不再使用的资源池。删除前，请确认资源池中没有仍需保留的配额、用户配置或正在使用的负载。

如果只需要为资源池新增用户，单击 **添加用户**。如果需要调整已有用户配置，请进入 **用户信息** 页签操作。

## 管理授权用户和个人配额

资源池支持按用户管理授权、个人配额、优先级和资源保障配置。共享资源池的配额仍由租户内用户共享消费；用户级配置用于控制具体用户在该资源池中的可用额度和调度策略。

操作前，请确认当前账号具有组织管理员权限，或是目标资源池的资源管理员。

进入资源池详情页后，打开 **用户信息** 页签。管理用户级配置时，先关注以下信息：

| 目标       | 关注信息                                                          |
| -------- | ------------------------------------------------------------- |
| 控制用户可用额度 | 查看已用资源，结合配置方式和配额判断用户是否达到可用额度上限。                               |
| 控制任务调度策略 | 通过优先级上限和资源保障，控制用户在该资源池内可使用的调度能力。按量资源池创建的负载默认不可抢占，不支持编辑资源保障配置。 |
| 排查资源占用   | 通过用量历史查看用户在该资源池中的历史用量，判断是否长期占用资源。                             |

您可以单击 **添加用户**，为资源池新增授权用户，并设置个人配额；或者在 **用户信息** 页签下搜索用户名，并执行以下操作：

* **批量更新**：批量调整多个用户的配额、优先级或资源保障配置。
* **编辑**：修改单个用户的配额配置。
* **删除**：从资源池中移除授权用户。
* **用量历史**：查看单个用户在该资源池中的历史用量。

个人配额用于限制用户在该资源池内可以使用的资源量。资源池总配额不足时，即使用户个人配额未用满，任务也可能无法调度。

## 扩缩容资源池

您可以通过扩缩容调整资源池总配额。具体是否支持扩缩容，以资源池类型、资源池状态和当前账号权限为准。

调整前，请确认当前账号具有组织管理员权限，或是目标资源池的资源管理员。

在资源池列表中，或者进入资源池详情页后，单击对应的 **扩缩容**，调整资源池总配额。

扩缩容支持 **按数量** 或者 **指定节点** 进行。

* 扩容时，默认从共享资源池迁移配额。也可以指定相同资源类型的其他资源池作为配额来源。提交前，请确认来源资源池有足够可用配额。

* 缩容时，请先确认目标资源池中没有超出缩容后总量的已用资源。若资源正在被开发环境、训练任务或推理服务占用，缩容可能无法完成。

扩缩容属于异步操作。操作期间，相关资源池会进入更新中状态，完成后回到就绪状态。

## 转换资源池类型

专属资源池和独占资源池可以相互转换。

转换前，请确认当前账号具有组织管理员权限，或是目标资源池的资源管理员，并满足以下条件：

* 目标资源池没有正在执行的更新、删除或其他资源操作。
* 转换后的资源池类型满足使用场景。
* 转换为独占资源池时，配额需满足整机校验。

在资源池列表或资源池详情页中，打开更多操作，选择对应的资源池类型转换操作。

转换期间，资源池会进入更新中状态。状态恢复为就绪后，您可以继续提交任务。

## 整理独占资源池碎片

独占资源池长期运行后，可能出现资源碎片：多个小规格负载分散在高规格节点上，导致大规格训练或推理任务无法申请到连续资源。

碎片整理用于将分散负载集中到少数节点，释放完整空闲节点。

整理前，可先进入独占资源池详情页查看节点和迁移信息：

* **节点信息**：按空闲优先、状态、节点名或负载名称定位节点，查看节点状态、承载负载和资源用量。需要处理节点上的资源分布时，可从页面提供的入口发起腾挪资源、碎片整理或停止调度。
* **迁移记录**：查看从节点视图发起的资源腾挪记录，包括状态、方向、腾挪模式或节点、驱逐负载和发起人。直接编辑资源池配额发起的资源调配不在该记录范围内。

### 操作前确认

* 资源池类型为独占资源池。
* 资源池状态为 `ready` 或 `failed`。
* 当前资源池没有正在执行的整理任务。
* 当前账号是租户管理员或资源池管理员。

### 整理流程

1. 进入独占资源池详情页。
2. 单击 **节点信息** 页签，然后单击 **碎片整理**。

   <img src="https://mintcdn.com/siflow/avekptrv6O-LsLPz/ai-platform/resources/media/resource-pool-defragmentation.png?fit=max&auto=format&n=avekptrv6O-LsLPz&q=85&s=4263fa19e16c51e532733db4197908fd" alt="独占资源池碎片整理" width="2356" height="916" data-path="ai-platform/resources/media/resource-pool-defragmentation.png" />
3. 在弹出页面，选择参与整理的负载类型和最大轮次。
4. 先执行试运行预览，确认预计调整的负载列表。
5. 确认后开始整理，并查看整理结果。

### 风险和限制

碎片整理采用先预留、后迁移的保守策略。只有目标节点完成资源预留后，平台才会驱逐并重建原 Pod；如果预留失败、目标节点异常或出现其他不可预期情况，平台会终止本次迁移。

单次整理不保证全部负载都能成功迁移。目标节点资源不足、Quota 不足、Pod 状态变化、节点异常或单轮整理超时，都可能导致部分负载未完成或被跳过；未完成或被跳过的 Pod 不影响其他 Pod 的处理结果。

如果选择停止负载，停止操作会终止对应训练任务，效果等同于手动停止。若任务配置了 checkpoint，后续可从 checkpoint 恢复。

## 常见问题

<AccordionGroup>
  <Accordion title="为什么创建任务时看不到某个资源池？">
    请确认当前账号已被授权使用该资源池，并且资源池支持当前任务类型。资源池可以限制支持的负载类型；如果当前任务类型不在支持范围内，创建任务时可能无法选择该资源池，或提交时被配额校验拒绝。
  </Accordion>

  <Accordion title="为什么个人配额充足，任务仍然可能无法调度？">
    个人配额只限制用户在该资源池内可使用的资源量。任务是否能调度，还取决于资源池总配额、空闲资源、实例规格、负载类型限制和资源池状态。
  </Accordion>

  <Accordion title="什么时候需要扩容资源池？">
    当目标资源池的总配额或空闲配额不足，导致任务排队、提交失败，或无法为用户分配足够个人配额时，可以考虑扩容资源池。扩容前，请确认来源资源池有足够可用配额。
  </Accordion>

  <Accordion title="为什么提交任务时报 resource auth check failed？">
    资源池支持配置负载类型。配置后，只有选中的负载类型可以使用该资源池。当任务类型不在资源池允许范围内时，提交会在配额校验阶段被拒绝，并可能出现类似错误：

    ```text theme={null}
    resource auth check failed, workload type XXX is not allowd to use resource pool XXX
    ```

    如果确认需要在该资源池提交任务，请修改资源池的负载类型配置。
  </Accordion>
</AccordionGroup>

## 相关文档

* [准备实例资源](./prepare-compute-resources)
* [查看资源用量](./view-resource-usage)
* [查看任务资源占用](./view-task-resource-usage)
