agent-sandbox

环境要求

• 一个可用的 Kubernetes 集群，且本机 kubectl 已配置好集群访问凭证
• 具备创建 CRD / Deployment 的集群权限（默认安装到 agent-sandbox-system 命名空间）
• 可访问 GitHub Releases 下载安装清单（github.com/kubernetes-sigs/agent-sandbox）

安装与启动步骤

1. 1标准安装控制器

   一次安装核心组件与扩展组件，从 GitHub latest release 拉取清单并 apply 到集群，README 推荐大多数用户使用。

   kubectl apply -f https://github.com/kubernetes-sigs/agent-sandbox/releases/latest/download/sandbox-with-extensions.yaml

   复制

2. 2验证安装结果

   查看 agent-sandbox-system 命名空间下的控制器 Deployment，若存在即表示 agent-sandbox 已安装成功。

   kubectl get deploy agent-sandbox-controller -n agent-sandbox-system

   复制

3. 3创建第一个 Sandbox

   把下面的 Sandbox 自定义资源 apply 到集群，注意把 image 换成你自己要运行的容器镜像。

   kubectl apply -f - <<'EOF'
   apiVersion: agents.x-k8s.io/v1beta1
   kind: Sandbox
   metadata:
     name: my-sandbox
   spec:
     podTemplate:
       spec:
         containers:
         - name: my-container
           image: 
   EOF

   复制

4. 4访问 Sandbox

   Sandbox 创建后拥有稳定标识，可通过其固定主机名 my-sandbox 访问该沙箱，适合多轮会话与状态保持。

5. 5卸载（可选）

   卸载前先用 get 检查是否有在用资源，确认无误后按集群实际安装的版本号删除对应清单。

   export VERSION="v1.0.2"
   kubectl delete -f https://github.com/kubernetes-sigs/agent-sandbox/releases/download/${VERSION}/sandbox-with-extensions.yaml

   复制

关键配置

配置项	必填	说明	示例
VERSION	是	卸载时指定集群上实际安装的 release 版本号	v1.0.2
metadata.name	是	Sandbox 资源名，同时也是访问用的稳定主机名	my-sandbox
spec.podTemplate.spec.containers[].image	是	沙箱内运行的容器镜像地址

如何确认成功

执行 kubectl get deploy agent-sandbox-controller -n agent-sandbox-system，若能看到控制器 Deployment，说明 CRD 与控制器均已就绪；再 apply 示例 San

常见问题

注意事项

• 安装前请确认对集群有创建 CRD 的权限，否则 apply 会失败。
• README 未给出 Kubernetes 版本要求，部署前建议先查官网 Getting Started 文档。
• README 也提到了 Selective Install 与 Helm 两种方式，若只需核心能力可参考官方文档选择。
• 卸载前务必执行 sandboxclaims、sandboxwarmpools、sandboxtemplates 的在用资源检查，避免误删。