# 创建沙箱模板 您可以创建新的沙箱模板，调整沙箱镜像或参数配置。本文介绍如何创建沙箱模板。 #### 前提条件 - 如果您需要创建自定义沙箱模板，需要先构建沙箱镜像，详情请参见[构建沙箱镜像](https://support.huaweicloud.com/usermanual-agentsphere/agentsphere_03_0007.html)。 - 如果您需要使用OBS对象存储，需要先配置访问OBS服务的VPC终端节点，详情请参见[配置访问OBS服务的终端节点](https://support.huaweicloud.com/usermanual-agentsphere/agentsphere_03_0033.html)。 #### 创建沙箱模板 1. 登录AgentSphere控制台。 2. 在左侧导航栏中选择"沙箱模板"，并单击右上角的"创建沙箱模板"。 3. 选择沙箱模板类型。 - **代码解释器沙箱**：基于函数计算的多语言代码执行环境。 - **自定义沙箱**：基于自定义镜像的完全可控开发环境。 - [代码解释器沙箱] 1. 填写**基础配置** 。 | 参数 | 参数说明 | |:---|:---| | 沙箱模板名称 | 自定义沙箱模板名称。 沙箱模板名称需以小写字母开头，以小写字母或数字结尾，可以包含小写字母、数字和中划线，长度为1-48个字符。 | | 描述 | 您可以添加该沙箱模板的描述信息，最多1000字符。 | | 资源配额 | 选择沙箱实例使用的CPU和内存，支持不同的CPU/内存配比。 您可以根据沙箱程序运行需求进行选择，资源配额过小可能导致沙箱运行失败，过大则会导致资源浪费。 | | 沙箱实例配额 | 设置此沙箱模板创建实例的上限，所有模板实例配额总数上限为10000。 | | 启动命令 | 沙箱实例启动时执行的命令，适用于需要指定应用入口、挂载点或端口映射等初始化场景。 您可以增加64个镜像启动命令，每个命令长度为1-4096个字符。 | | 环境变量 | 支持通过键值对的形式为沙箱运行环境设置变量，可用于把外部信息传递给沙箱中运行的程序。 您可以添加50个环境变量。 | 2. 填写**网络配置** 。 | 参数 || 参数说明 | |:---|---|:---| | 入站（Inbound）网关 || 入站网关用于接收外部请求，配置后可通过网关访问沙箱内的服务。 如果没有可选网关，请单击"新建入站网关实例"进行创建，完成创建后单击刷新按钮。 注意： 系统将自动创建工作负载身份，用于E2B身份验证。 | | 出站（Outbound）网络配置 | VPC模式 | 沙箱实例可以访问虚拟私有云VPC内的其他服务。 - **虚拟私有云** ：选择一个虚拟私有云VPC。 若没有可选虚拟私有云，请单击"新建虚拟私有云"进行创建，完成创建后单击刷新按钮。操作步骤详情请参见[创建虚拟私有云和子网](https://support.huaweicloud.com/usermanual-vpc/zh-cn_topic_0013935842.html)。 - **子网**：在选定的VPC下选择一个子网。 - **安全组** ：为沙箱实例选择安全组，支持同时选择多个安全组（此时安全组规则取并集）。 您可以单击"展开安全组规则"查看具体的"入方向规则"和"出方向规则"。 | | 出站（Outbound）网络配置 | 公网模式 | 沙箱实例可通过公网对外访问，适用于需要联网调用第三方API、下载依赖等场景。 | | 运行时信任委托 || 用于授予OBS桶的访问权限。当配置了OBS对象存储时，此项必填。 | 3. 填写**存储配置** 。 | 参数 | 参数说明 | |:---|:---| | SFS Turbo文件存储 | 选择是否挂载SFS Turbo文件存储，勾选后，您可以选择将指定的文件系统目录挂载至沙箱目录。**只有出站（Outbound）网络配置为** **"VPC模式"时支持SFS Turbo文件存储，同时SFS Turbo安全组需要放通沙箱模板选择的VPC网段。** 如果没有可选文件系统，您可单击"创建文件系统"进行创建，完成创建后单击刷新按钮。相关配置说明请参见[创建SFS Turbo文件系统](https://support.huaweicloud.com/usermanual-sfsturbo/sfsturbo_01_0359.html)。 您最多可以同时挂载5个存储路径（支持选择不同文件系统）。 - **存储路径**：填写文件系统的存储路径，存储路径必须以/开头，且不能包含".."。 - **读写权限** ：为此挂载路径设置"读写"或"只读"权限。 说明： 如果要对挂载路径进行读写操作，不仅要保证沙箱开启挂载路径的读写权限，还需要保证SFS Turbo文件系统目录允许Linux用户进行读写，具体说明请参见[访问文件无权限](https://support.huaweicloud.com/trouble-sfsturbo/sfsturbo_01_1032.html#sfsturbo_01_1032__section205691001152)。 - **挂载路径**：挂载路径必须为绝对路径，以/home、/mnt、/data、/tmp开头，且不能包含".."。 | | OBS对象存储 | 选择是否挂载OBS对象存储，勾选后，您可以选择将指定的OBS对象存储桶目录挂载至沙箱目录。**只有出站（Outbound）网络配置为** **"VPC模式"时** **支持OBS对象** **存储。** 如果没有可选对象桶，您可单击"创建OBS桶"进行创建，完成创建后单击刷新按钮。相关配置说明请参见[创建桶](https://support.huaweicloud.com/usermanual-obs/zh-cn_topic_0045829088.html)。 注意： 部分多AZ存储的对象桶可能挂载失败，如果需要挂载多AZ存储的对象桶，请提交工单给OBS服务并提供对象桶名称进行确认。 您最多可以同时挂载5个桶目录（支持选择不同对象桶）。 - **桶目录**：填写对象桶目录。 - **挂载路径**：挂载路径必须为绝对路径，以/home、/mnt、/data、/tmp开头，且不能包含".."。 | | 托管会话存储 | 选择是否将Session会话进行持久化存储，通过配置托管的文件存储，保留Agent会话状态，开启后需填写Session会话存储的挂载路径。 | 4. 填写**日志监控配置** 。 | 参数 | 参数说明 | |:---|:---| | 日志对接LTS | 将沙箱的标准输出和标准错误日志采集到LTS日志服务中。您可以使用LTS对云服务日志进行关键词搜索、日志可视化分析、日志告警、日志转储等多种操作。 - **日志组** ：云日志服务进行日志管理的基本单位，用于对日志流进行分类，一个日志组下面可以创建多个日志流。 如果没有可选日志组，您可单击"创建日志组"进行创建，完成创建后单击刷新按钮。相关配置说明请参见[管理日志组](https://support.huaweicloud.com/usermanual-lts/lts_04_0003.html)。 - **日志流** ：日志读写的基本单位，日志组中可以创建日志流，将不同类型的日志分类存储，方便对日志进一步分类管理。 如果没有可选日志流，您可单击"创建日志流"进行创建，完成创建后单击刷新按钮。相关配置说明请参见[管理日志流](https://support.huaweicloud.com/usermanual-lts/lts_04_0004.html)。 | | 对接AOM | 启用后沙箱的系统指标（如CPU、内存使用率）会上报到您选择的AOM实例，其中基础指标免费，其他指标按需收费，关于价格详情请参见[计费项](https://support.huaweicloud.com/price-aom2/aom_07_0005.html)。 如果没有可选AOM实例，您可单击"新建实例"进行创建，完成创建后单击刷新按钮。相关配置说明请参见[管理Prometheus实例](https://support.huaweicloud.com/usermanual-aom2/mon_01_0072.html)。 | 5. 填写**高级配置** 。 | 参数 | 参数说明 | |:---|:---| | 闲置超时时间 | 沙箱无操作时保持活跃的时长，沙箱在闲置超时时间结束后，自动释放或者休眠，若沙箱有新任务或操作时，闲置超时时间会重置。 若持续有新任务及操作时，沙箱最大运行时长不超过24小时。 | | 健康检查 | - **使用默认配置**：默认为ENVD 49983端口，协议为HTTP、检查路径为/health。 - **自定义配置**：配置应用程序健康检查的协议、端口和路径。 说明： 当镜像内有多个进程时，建议配置健康检查指向启动慢的进程。 | 6. 完成上述配置后，单击"创建"。 - [自定义沙箱] 1. 填写**基础配置** 。 | 参数 | 参数说明 | |:---|:---| | 沙箱模板名称 | 自定义沙箱模板名称。 沙箱模板名称需以小写字母开头，以小写字母或数字结尾，可以包含小写字母、数字和中划线，长度为1-48个字符。 | | 描述 | 您可以添加该沙箱模板的描述信息，最多1000字符。 | | 选择镜像 | 单击"选择镜像"，选择沙箱使用的镜像，镜像数据来源于容器镜像服务（SWR）。 如果您需要使用第三方镜像，可直接输入镜像地址，但需要同时保证沙箱环境可访问镜像仓库。 | | 资源配额 | 选择沙箱实例使用的CPU和内存，支持不同的CPU/内存配比。 您可以根据沙箱程序运行需求进行选择，资源配额过小可能导致沙箱运行失败，过大则会导致资源浪费。 | | 启动命令 | 沙箱实例启动时执行的命令，适用于需要指定应用入口、挂载点或端口映射等初始化场景。 您可以增加64个镜像启动命令，每个命令长度为1-4096个字符。 | | 环境变量 | 支持通过键值对的形式为沙箱运行环境设置变量，可用于把外部信息传递给沙箱中运行的程序。 您可以添加50个环境变量。 | 2. 填写**网络配置** 。 | 参数 || 参数说明 | |:---|---|:---| | 入站（Inbound）网关 || 入站网关用于接收外部请求，配置后可通过网关访问沙箱内的服务。 如果没有可选网关，请单击"新建入站网关实例"进行创建，完成创建后单击刷新按钮。 注意： 系统将自动创建工作负载身份，用于E2B身份验证。 | | 出站（Outbound）网络配置 | VPC模式 | 沙箱实例可以访问虚拟私有云VPC内的其他服务。 - **虚拟私有云** ：选择一个虚拟私有云VPC。 若没有可选虚拟私有云，请单击"新建虚拟私有云"进行创建，完成创建后单击刷新按钮。操作步骤详情请参见[创建虚拟私有云和子网](https://support.huaweicloud.com/usermanual-vpc/zh-cn_topic_0013935842.html)。 - **子网**：在选定的VPC下选择一个子网。 - **安全组** ：为沙箱实例选择安全组，支持同时选择多个安全组（此时安全组规则取并集）。 您可以单击"展开安全组规则"查看具体的"入方向规则"和"出方向规则"。 | | 出站（Outbound）网络配置 | 公网模式 | 沙箱实例可通过公网对外访问，适用于需要联网调用第三方API、下载依赖等场景。 | | 运行时信任委托 || 用于授予OBS桶的访问权限。当配置了OBS对象存储时，此项必填。 | 3. 填写**存储配置** 。 | 参数 | 参数说明 | |:---|:---| | SFS Turbo文件存储 | 选择是否挂载SFS Turbo文件存储，勾选后，您可以选择将指定的文件系统目录挂载至沙箱目录。**只有出站（Outbound）网络配置为** **"VPC模式"时支持SFS Turbo文件存储，同时SFS Turbo安全组需要放通沙箱模板选择的VPC网段。** 如果没有可选文件系统，您可单击"创建文件系统"进行创建，完成创建后单击刷新按钮。相关配置说明请参见[创建SFS Turbo文件系统](https://support.huaweicloud.com/usermanual-sfsturbo/sfsturbo_01_0359.html)。 您最多可以同时挂载5个存储路径（支持选择不同文件系统）。 - **存储路径**：填写文件系统的存储路径，存储路径必须以/开头，且不能包含".."。 - **读写权限** ：为此挂载路径设置"读写"或"只读"权限。 说明： 如果要对挂载路径进行读写操作，不仅要保证沙箱开启挂载路径的读写权限，还需要保证SFS Turbo文件系统目录允许Linux用户进行读写，具体说明请参见[访问文件无权限](https://support.huaweicloud.com/trouble-sfsturbo/sfsturbo_01_1032.html#sfsturbo_01_1032__section205691001152)。 - **挂载路径**：挂载路径必须为绝对路径，以/home、/mnt、/data、/tmp开头，且不能包含".."。 | | OBS对象存储 | 选择是否挂载OBS对象存储，勾选后，您可以选择将指定的OBS对象存储桶目录挂载至沙箱目录。**只有出站（Outbound）网络配置为** **"VPC模式"时** **支持OBS对象** **存储。** 如果没有可选对象桶，您可单击"创建OBS桶"进行创建，完成创建后单击刷新按钮。相关配置说明请参见[创建桶](https://support.huaweicloud.com/usermanual-obs/zh-cn_topic_0045829088.html)。 注意： 部分多AZ存储的对象桶可能挂载失败，如果需要挂载多AZ存储的对象桶，请提交工单给OBS服务并提供对象桶名称进行确认。 您最多可以同时挂载5个桶目录（支持选择不同对象桶）。 - **桶目录**：填写对象桶目录。 - **挂载路径**：挂载路径必须为绝对路径，以/home、/mnt、/data、/tmp开头，且不能包含".."。 | | 托管会话存储 | 选择是否将Session会话进行持久化存储，通过配置托管的文件存储，保留Agent会话状态，开启后需填写Session会话存储的挂载路径。 | 4. 填写**日志监控配置** 。 | 参数 | 参数说明 | |:---|:---| | 日志对接LTS | 将沙箱的标准输出和标准错误日志采集到LTS日志服务中。您可以使用LTS对云服务日志进行关键词搜索、日志可视化分析、日志告警、日志转储等多种操作。 - **日志组** ：云日志服务进行日志管理的基本单位，用于对日志流进行分类，一个日志组下面可以创建多个日志流。 如果没有可选日志组，您可单击"创建日志组"进行创建，完成创建后单击刷新按钮。相关配置说明请参见[管理日志组](https://support.huaweicloud.com/usermanual-lts/lts_04_0003.html)。 - **日志流** ：日志读写的基本单位，日志组中可以创建日志流，将不同类型的日志分类存储，方便对日志进一步分类管理。 如果没有可选日志流，您可单击"创建日志流"进行创建，完成创建后单击刷新按钮。相关配置说明请参见[管理日志流](https://support.huaweicloud.com/usermanual-lts/lts_04_0004.html)。 | | 对接AOM | 启用后沙箱的系统指标（如CPU、内存使用率）会上报到您选择的AOM实例，其中基础指标免费，其他指标按需收费，关于价格详情请参见[计费项](https://support.huaweicloud.com/price-aom2/aom_07_0005.html)。 如果没有可选AOM实例，您可单击"新建实例"进行创建，完成创建后单击刷新按钮。相关配置说明请参见[管理Prometheus实例](https://support.huaweicloud.com/usermanual-aom2/mon_01_0072.html)。 | 5. 填写**高级配置** 。 | 参数 | 参数说明 | |:---|:---| | 闲置超时时间 | 沙箱无操作时保持活跃的时长，沙箱在闲置超时时间结束后，自动释放或者休眠，若沙箱有新任务或操作时，闲置超时时间会重置。 若持续有新任务及操作时，沙箱最大运行时长不超过24小时。 | | 健康检查 | - **使用默认配置**：默认为ENVD 49983端口，协议为HTTP、检查路径为/health。 - **自定义配置**：配置应用程序健康检查的协议、端口和路径。 说明： 当镜像内有多个进程时，建议配置健康检查指向启动慢的进程。 | 6. 完成上述配置后，单击"创建"。 #### 相关文档 - 如果您需要管理已有模板，请参见[管理沙箱模板](https://support.huaweicloud.com/usermanual-agentsphere/agentsphere_03_0010.html)。 - 如果您需要构建自定义镜像，请参见[构建沙箱镜像](https://support.huaweicloud.com/usermanual-agentsphere/agentsphere_03_0007.html)。