diff --git a/site/content/zh-CN/docs/tasks/run/external_workloads/sandbox.md b/site/content/zh-CN/docs/tasks/run/external_workloads/sandbox.md new file mode 100644 index 00000000000..1f64e567f03 --- /dev/null +++ b/site/content/zh-CN/docs/tasks/run/external_workloads/sandbox.md @@ -0,0 +1,69 @@ +--- +title: "运行 Sandbox" +linkTitle: "Sandbox" +date: 2026-04-19 +weight: 8 +description: > + 将 Kueue 与 Sandbox 操作符集成。 +--- + +此页面展示了在运行 [Sandbox](https://github.com/kubernetes-sigs/agent-sandbox) +时,如何利用 Kueue 的调度和资源管理能力。 + +本指南适用于对 Kueue 有基本了解的[批处理用户](/docs/tasks#batch-user)。 +欲了解更多信息,请参阅 [Kueue 概述](/docs/overview)。 + +Sandbox 操作符为运行 AI 代理工作负载提供隔离环境。 +Kueue 通过[普通 Pod](/docs/tasks/run/plain_pods) 集成管理由 Sandbox 控制器创建的 Pod, +其中每个 Sandbox Pod 都表示为单个独立的普通 Pod。 + +## 在你开始之前 + +1. 了解如何[使用自定义管理器配置安装 Kueue](/docs/installation/#install-a-custom-configured-released-version)。 + +1. 按照[运行普通 Pod](/docs/tasks/run/plain_pods/#before-you-begin) 中的步骤,了解如何启用和配置 `pod` 集成。 + +1. 查阅[管理集群配额](/docs/tasks/manage/administer_cluster_quotas),了解初始 Kueue 设置的详细信息。 + +1. 安装 [Sandbox Operator](https://github.com/kubernetes-sigs/agent-sandbox)。 + +## Sandbox 定义 + +### a. 队列选择 + +目标[本地队列](/docs/concepts/local_queue)应在 Sandbox 配置的 +`spec.podTemplate.metadata.labels` 部分中指定。 + +```yaml +spec: + podTemplate: + metadata: + labels: + kueue.x-k8s.io/queue-name: user-queue +``` + +### b. 配置资源需求 + +工作负载的资源需求可以在 `spec.podTemplate.spec.containers` 中配置。 + +```yaml +spec: + podTemplate: + spec: + containers: + - resources: + requests: + cpu: "100m" + memory: "200Mi" +``` + +## 示例 Sandbox + +以下是一个示例 Sandbox: + +{{< include "examples/pod-based-workloads/sample-sandbox.yaml" "yaml" >}} + +## 限制 + +- Kueue 只会管理由 Sandbox Operator 创建的 Pod。 +- 每个 Sandbox Pod 都会创建一个新的 Workload 资源,并且必须等待 Kueue 的准入。