沙箱挂载ZOS
更新时间 2026-05-12 11:47:14
最近更新时间: 2026-05-12 11:47:14
概述
智能体引擎中的沙箱提供了挂载天翼云对象存储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创建沙箱时,通过写入环境变量AGE_TEMPLATE_ZOS来配置ZOS挂载。AGE_TEMPLATE_ZOS的格式为:ZOS_BUCKET_NAME=Bucket名称,ZOS_MOUNT_POINT=沙箱本地目录,ZOS_URL=对象存储内网地址,ZOS_SUBDIR=Bucket子目录,ZOS_READONLY=沙箱本地目录权限,如果有多组挂载,每组之间使用空格隔开,最多支持5个挂载点。
注意: 虽然以环境变量AGE_TEMPLATE_ZOS形式动态挂载ZOS,但是该环境变量并不会写入沙箱环境变量。
sandbox = Sandbox.create(
template='xxx',
envs={"AGE_TEMPLATE_ZOS":"ZOS_BUCKET_NAME=my-bucket,ZOS_MOUNT_POINT=/home/user/a/,ZOS_URL=http://huanan-2-internal.zos.ctyun.cn,ZOS_SUBDIR=/sandbox/a/,ZOS_READONLY=false"}
)
print('创建沙箱成功')
``