更新时间:2026-10-29 GMT+08:00
分享

创建沙箱实例

沙箱实例基于沙箱模板创建,创建时从模板继承镜像、资源规格、网络配置等参数,同时支持覆盖部分配置(如环境变量等)。实例创建后自动进入运行中状态,即可接受Agent任务执行。本文介绍如何创建沙箱实例。

前提条件

如果您需要使用OBS对象存储,需要先配置访问OBS服务的VPC终端节点,详情请参见配置访问OBS/SWR服务的终端节点。

约束与限制

沙箱创建完成后的磁盘大小为30GiB,暂不支持调整。

创建沙箱实例

  1. 登录AgentSphere控制台。
  2. 在左侧导航栏中选择“沙箱实例”,并单击右上角的“创建沙箱实例”。
  3. 填写基础配置。

    参数

    参数说明

    沙箱名称

    自定义沙箱名称。

    沙箱名称需以小写字母开头,以小写字母或数字结尾,可以包含小写字母、数字和中划线,长度为1-56个字符。

    选择沙箱模板

    选择沙箱创建的模板,沙箱模板中定义了沙箱资源配额、网络配置、权限配置等必要参数。

    如果没有可选沙箱模板,您可单击“创建沙箱模板”进行创建,完成创建后单击刷新按钮。相关配置说明请参见创建沙箱模板。

    选择模板快照

    选择一个属于该沙箱模板的快照,模板快照在首次创建、更新模板时会自动构建。

    元数据标签

    用于标识、分类和筛选沙箱资源,便于在大规模部署或自动化测试中进行批量管理。元数据标签采用键值对的形式,最多可以添加10个。

    环境变量

    运行沙箱时动态入的配置参数,允许在不重新构建镜像的情况下,灵活调整应用的行为和设置。环境变量采用键值对的形式,最多可以添加50个。

  4. 填写存储配置。

    仅当沙箱模板中的出站(Outbound)网络配置为“VPC模式”时,支持“SFS Turbo文件存储”和“OBS对象存储”配置。

    参数

    参数说明

    SFS Turbo文件存储

    选择是否挂载SFS Turbo文件存储,勾选后,您可以选择将指定的文件系统目录挂载至沙箱目录。SFS Turbo安全组需要放通沙箱模板选择的VPC网段。

    如果没有可选文件系统,您可单击“创建文件系统”进行创建,完成创建后单击刷新按钮。相关配置说明请参见创建SFS Turbo文件系统。

    您最多可以同时挂载5个存储路径(支持选择不同文件系统)。

    • 存储路径:填写文件系统的存储路径,存储路径必须以/开头,且不能包含“..”。
      注意:

      请保证文件系统存储路径已存在,不存在时将挂载失败。

    • 读写权限:为此挂载路径设置“读写”或“只读”权限。
      注意:

      如果要对挂载路径进行读写操作,不仅要保证沙箱开启挂载路径的读写权限,还需要保证SFS Turbo文件系统目录允许Linux用户进行读写,具体说明请参见访问文件无权限。

    • 挂载路径:挂载路径必须为绝对路径,以/home、/mnt、/data、/tmp开头,且不能包含“..”。

    OBS对象存储

    选择是否挂载OBS对象存储,勾选后,您可以选择将指定的OBS对象存储桶目录挂载至沙箱目录。

    如果没有可选对象桶,您可单击“创建OBS桶”进行创建,完成创建后单击刷新按钮。相关配置说明请参见创建桶。

    注意:
    • 使用OBS对象存储时,沙箱镜像中需要存在/etc/passwd文件。
    • 部分多AZ存储的对象桶可能挂载失败,如果需要挂载多AZ存储的对象桶,请提交工单给OBS服务并提供对象桶名称进行确认。

    您最多可以同时挂载5个桶目录(支持选择不同对象桶)。

    • 桶目录:填写对象桶目录。
      注意:

      请保证桶目录已存在,不存在时将挂载失败。

    • 读写权限:支持设置“读写”或“只读”权限。
    • 挂载路径:挂载路径必须为绝对路径,以/home、/mnt、/data、/tmp开头,且不能包含“..”。

  5. 填写高级配置。

    参数

    参数说明

    超时时间

    沙箱无操作时保持活跃的时长,您可以选择在指定的超时时间结束后,沙箱实例自动释放或者自动休眠。

    说明:
    • 若沙箱有新任务或操作时,超时时间会重置。
    • 若持续有新任务及操作时,沙箱最大运行时长不超过24小时。

  6. 完成上述配置后,单击“立即创建”。

相关文档

相关文档