[website][zh]sync kubeflow/sparkapplications

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 的准入。