创建 JuiceFS Volume

存储配置

juiceFSVolumeConfig 的字段与 Python SDK 参数对应如下：

remoteDir 指定 JuiceFS 文件系统中的远端目录，与 Sandbox 内的本地挂载目录不同。设置为 /datasets/project-a 时，挂载内容来自该子目录；目录不存在时，系统会在挂载时自动创建。请使用以 / 开头的远端绝对路径，并确保 Token 具有创建和访问目标目录所需的权限。

平台会将 remoteDir 转换为 JuiceFS 客户端的 --subdir 参数，无需在 args 中重复设置。

不要在日志中打印请求体、JuiceFS Token 或其他凭证。

挂载配置

mountConfig.vpcConfig 可以保存访问 JuiceFS 服务所需的 VPC 配置，供创建 Sandbox 时使用。Python SDK 对应参数为 mount_config.vpc_config，通过 models.CreateVolumeInputMountConfigVpcConfig 构造。

mountConfig.vpcConfig 为可选项；填写时，必须完整提供 vpcId、securityGroupId 和 vSwitchIds 三个字段。本文示例将 VPC 配置保存在 Volume 中，后续创建 Sandbox 时直接复用。也可以在创建 Sandbox 时通过 metadata 的 fc.sandbox.network.vpc 提供 VPC 配置；两处均配置时，以 metadata 为准。

JuiceFS 通过 Token 访问文件系统，挂载 JuiceFS 本身不要求配置 mountConfig.role。Sandbox 内的本地挂载目录在挂载时通过 volume_mounts 指定。

环境变量说明

以下环境变量供本文示例读取。访问凭证按步骤一的 SDK 说明配置，其余参数在创建示例中设置。

创建示例

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

export SANDBOX_REGION_ID="<REGION>"
export SANDBOX_ENDPOINT="sandbox.${SANDBOX_REGION_ID}.aliyuncs.com"

export SANDBOX_TEAM_ID="<TEAM-ID>"
export SANDBOX_VOLUME_NAME="juicefs-workspace"

export JUICEFS_VOLUME_NAME="<JUICEFS-FILE-SYSTEM-NAME>"
export JUICEFS_BASE_URL="https://<JUICEFS-SERVICE-ADDRESS>"
export JUICEFS_TOKEN="<JUICEFS-TOKEN>"
export JUICEFS_REMOTE_DIR="/"

export SANDBOX_VPC_ID="<VPC-ID>"
export SANDBOX_SECURITY_GROUP_ID="<SECURITY-GROUP-ID>"
export SANDBOX_VSWITCH_ID="<VSWITCH-ID>"

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

import os

from alibabacloud_sandbox20260820 import models
from alibabacloud_sandbox20260820.client import Client as SandboxClient
from alibabacloud_tea_openapi import utils_models as open_api_models


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


config = open_api_models.Config(
    access_key_id=require_env("ALIBABA_CLOUD_ACCESS_KEY_ID"),
    access_key_secret=require_env("ALIBABA_CLOUD_ACCESS_KEY_SECRET"),
    security_token=os.environ.get("ALIBABA_CLOUD_SECURITY_TOKEN"),
    region_id=require_env("SANDBOX_REGION_ID"),
    endpoint=require_env("SANDBOX_ENDPOINT"),
)

pop_client = SandboxClient(config)
response = pop_client.create_volume(
    models.CreateVolumeRequest(
        body=models.CreateVolumeInput(
            team_id=require_env("SANDBOX_TEAM_ID"),
            volume_name=require_env("SANDBOX_VOLUME_NAME"),
            mount_config=models.CreateVolumeInputMountConfig(
                vpc_config=models.CreateVolumeInputMountConfigVpcConfig(
                    vpc_id=require_env("SANDBOX_VPC_ID"),
                    security_group_id=require_env("SANDBOX_SECURITY_GROUP_ID"),
                    v_switch_ids=[require_env("SANDBOX_VSWITCH_ID")],
                ),
            ),
            juice_fsvolume_config=models.JuiceFSVolumeConfig(
                volume_name=require_env("JUICEFS_VOLUME_NAME"),
                base_url=require_env("JUICEFS_BASE_URL"),
                remote_dir=require_env("JUICEFS_REMOTE_DIR"),
                token=require_env("JUICEFS_TOKEN"),
                args=[],
            ),
        )
    )
)

if response.body is None or response.body.volume is None:
    raise RuntimeError("CreateVolume 未返回 Volume")

volume = response.body.volume
print(f"request_id={response.body.request_id}")
print(f"volume_id={volume.volume_id}")
print(f"volume_name={volume.volume_name}")
print(f"storage_class={volume.storage_class}")
print(f"status={volume.status}")

在同一终端运行：

python 01_create_juicefs_volume.py

CreateVolume 不探测 JuiceFS 服务的网络连通性，也不执行真实挂载。参见挂载 JuiceFS Volume创建 Sandbox，并通过实际读写确认挂载可用。