挂载 OSS Volume

环境变量说明

挂载示例

在终端中设置以下参数，并将所有占位符替换为实际值。各变量的取值参见本文环境变量说明。

export E2B_API_KEY="<YOUR-E2B-API-KEY>"
export E2B_API_URL="https://api.<REGION>.sandbox.aliyuncs.com"
export E2B_DOMAIN="<REGION>.sandbox.aliyuncs.com"
export E2B_TEMPLATE="<TEMPLATE-ID-OR-ALIAS>"

export OSS_VOLUME_NAME="<YOUR-VOLUME-NAME>"

挂载目录位于 Sandbox 内，对应 volume_mounts 的键。建议使用 /home、/mnt、/tmp 或 /data 的子目录，本文使用 /mnt/oss。

以下示例复用 Volume 的 mountConfig.role，将 OSS Volume 挂载到 /mnt/oss。请确保 Volume 已保存有效的 RAM 角色。需要通过 metadata 指定角色时，参见配置 RAM 角色。

示例会在挂载目录中创建带随机标识的独立测试文件，写入并读取校验后删除该文件，再释放本次创建的 Sandbox。请使用具备读写权限的挂载配置。

将以下代码保存为 01_mount_oss_volume.py：

import os
from uuid import uuid4

from e2b import Sandbox


def require_env(name: str) -> str:
    value = os.environ.get(name, "").strip()
    if not value:
        raise RuntimeError(f"缺少环境变量: {name}")
    return value


mount_dir = "/mnt/oss"
marker_path = f"{mount_dir}/hello-oss-{uuid4().hex}.txt"
sandbox = None
marker_written = False

try:
    sandbox = Sandbox.create(
        template=require_env("E2B_TEMPLATE"),
        timeout=300,
        api_key=require_env("E2B_API_KEY"),
        api_url=require_env("E2B_API_URL"),
        domain=require_env("E2B_DOMAIN"),
        volume_mounts={mount_dir: require_env("OSS_VOLUME_NAME")},
    )

    info = sandbox.get_info()
    print(f"volume_mounts={info.volume_mounts}")

    sandbox.files.write(marker_path, "hello oss\n")
    marker_written = True
    content = sandbox.files.read(marker_path)
    if content != "hello oss\n":
        raise RuntimeError(f"文件内容不一致: {content!r}")
finally:
    try:
        if sandbox is not None and marker_written:
            sandbox.files.remove(marker_path)
    finally:
        if sandbox is not None:
            sandbox.kill()

print("OSS Volume 挂载读写验证成功")

运行示例：

python 01_mount_oss_volume.py

输出 OSS Volume 挂载读写验证成功 表示本次读写、测试文件清理和 Sandbox 释放已完成。