沙箱挂载ZOS
更新时间 2026-10-21 10:27:15
最近更新时间: 2026-10-21 10:27:15
概述
智能体引擎中的沙箱提供了挂载天翼云对象存储ZOS的能力。通过挂载功能,您可以将ZOS存储桶的指定路径映射为沙箱内的本地文件目录,实现数据的持久化保存、多实例共享。 本章节主要介绍沙箱模板如何配置ZOS挂载以及使用E2B SDK动态挂载ZOS。
使用场景
跨沙箱实例文件共享场景
智能体引擎中的沙箱支持同一沙箱模板下的所有实例挂载相同的对象存储ZOS路径,以满足数据与文件持久化存储和共享的需求。
沙箱模板配置中ZOS挂载参数
ZOS挂载参数说明如下:
| 参数名称 | 是否必填 | 参数说明 |
|---|---|---|
| ZOS挂载点 | 是 | 对象存储Bucket名称。 |
| Bucket子目录 | 是 | 设置Bucket中的子目录,必须为绝对路径。设置为/表示挂载Bucket的根目录。 |
| 沙箱本地目录 | 是 | 设置沙箱运行环境中的本地目录。 |
| 沙箱本地目录权限 | 是 | 选择Bucket挂载到沙箱运行环境中的本地目录后,该目录的访问权限。支持设置为只读或读写权限。 |
E2B SDK动态挂载ZOS
除了在沙箱模板中配置ZOS挂载,您还可以通过E2B SDK动态挂载ZOS。如果模板中已经配置了ZOS挂载,SDK挂载的ZOS会覆盖模板中的配置。
使用E2B SDK创建沙箱时,通过写入metadata age.sandbox.oss来配置ZOS挂载。age.sandbox.oss值为JSON字符串,结构如下:
| 字段名称 | 是否必填 | 说明 |
|---|---|---|
| mountPoints | 是 | ZOS挂载点列表。 最多支持5条。 |
| bucketName | 是 | 对象存储Bucket名称。 |
| bucketPath | 是 | Bucket中的子目录,必须为绝对路径。设置为/表示挂载Bucket的根目录。 |
| mountDir | 是 | 沙箱内的挂载目录,必须是绝对路径,例如:/home/user/zos。 |
| url | 是 | ZOS内网访问地址。对象存储ZOS内网域名 ,例如:http://huabei-2-internal.zos.ctyun.cn |
| readOnly | 是 | Bucket挂载到沙箱运行环境中的本地目录后,该目录的访问权限。支持设置为只读或读写权限。 |
# oss动态挂载
oss_config = {
"mountPoints": [
"bucketName": "zos-huabei2",
"mountDir": "/home/user/zos",
"bucketPath": "/sandbox",
"url": "http://huabei-2-internal.zos.ctyun.cn",
"readOnly": False,
}
]
}
sandbox = Sandbox.create(
metadata={
"age.sandbox.oss": json.dumps(oss_config),
},
template='my-template', api_key=apikey, domain=domain, timeout=1800)