为EAS服务进行存储挂载

选择存储方案

为EAS服务配置存储挂载时，需要先选择底层存储类型，再决定使用方式。本节帮助您做出合适的选择。

基础存储挂载

{
  "storage": [
        {
            "oss": {
                "path": "oss://bucket/path/",
                "readOnly": false
            },
            "mount_path": "/mnt/data/"
        }
    ]
}

{
  "storage": [
        {
            "nfs": {
                "path": "/",
                "server": "06ba74****-a****.cn-hangzhou.nas.aliyuncs.com",
                "readOnly": false
            },
            "mount_path": "/mnt/data/"
        }
    ]
}

{
  "storage": [
        {
            "git": {
                "repo": "https://codeup.aliyun.com/xxx/eas/aitest.git",
                "branch": "master",
                "commit": "xxx",
                "username": "username",
                "password": "password or access token"
            },
            "mount_path": "/mnt/data/"
        }
    ]
}

平台资产挂载

支持将PAI平台已注册的数据集、代码和模型作为AI资产挂载到服务实例中，实现资产统一管理和复用。

"storage": [
        {
            "dataset": {
                "id": "d-pcsah1t86bm8******",
                "version": "v1",
                "read_only": false
            },
            "mount_path": "/mnt/data/"
        }
    ]

"storage": [
        {
            "code": {
                "id": "code-4d3b42a1152****"
            },
            "mount_path": "/mnt/data/"
        }
    ]

高级挂载选项

除基础存储和平台资产挂载外，EAS还支持以下高级挂载方式，适用于特殊场景：

• 镜像挂载：从Docker镜像中提取文件到服务实例。注意，该方式并非直接挂载镜像目录，而是通过Shared Volume将镜像中指定目录的文件拷贝到本地，在服务运行时挂载本地Shared Volume。当挂载目录数据量较大时，会消耗较多本地存储并延长启动时间，请根据实际需要使用。

• EmptyDir挂载：提供本地临时存储空间，供实例运行时读写。实例异常重启后，写入的内容不会丢失。适用于需要本地缓存或临时文件存储的场景。

{
    "storage": [
        {
            "image": {
                "image": "registry-vpc.cn-xxxx.aliyuncs.com/eas/image_name:v1",
                "path": "/path/to/mount/"
            },
            "mount_path": "/data_image"
        }
    ]
}

{
    "storage": [
        {
            "empty_dir": {},
            "mount_path": "/data_image"
        }
    ]
}

{
    "storage": [
        {
            "empty_dir": {
              "medium": "memory",
              "size_limit": 20
            },
            "mount_path": "/dev/shm"
        }
    ]
}

JSON配置完整示例

完整的配置示例如下，更多配置详情，请参见JSON部署。

{
    "name": "service_name",
    "model_path": "http://path/to/model",
    "processor": "pmml",
    "storage": [
        {
            "oss": {
                "path": "oss://bucket/path/",
                "readOnly": false
            },
            "mount_path": "/mnt/data/"
        },
        {
            "nfs": {
                "path": "/",
                "server": "06ba74****-a****.cn-hangzhou.nas.aliyuncs.com",
                "readOnly": false
            },
            "mount_path": "/mnt/data/"
        },
        {
            "image": {
                "image": "registry-vpc.cn-shanghai.aliyuncs.com/eas/test_image:v1",
                "path": "/path/to/mount/"
            },
            "mount_path": "/data_image"
        },
        {
            "empty_dir": {
              "medium": "memory",
              "size_limit": 20
            },
            "mount_path": "/dev/shm"
        },
        {
            "git": {
                "repo": "https://codeup.aliyun.com/xxx/eas/aitest.git",
                "branch": "master",
                "commit": "xxx",
                "username": "username",
                "password": "password or access token"
            },
            "mount_path": "/mnt/data/"
        }
    ],
    "metadata": {
        "cpu": 1,
        "instance": 1,
        "resource": "eas-r-xxx"
    }
}

常见问题

1. 挂载了OSS，为何报错找不到文件？

   通常是路径错误，请检查挂载配置以及访问路径。

   例如，将 oss://my-bucket/ 挂载到 /mnt/data，OSS中文件 oss://my-bucket/subfolder/myfile.txt在容器中需通过 /mnt/data/subfolder/myfile.txt 访问，而不是 /mnt/data/myfile.txt。

2. NAS挂载失败，提示网络不通怎么办？

   NAS挂载要求EAS服务与NAS挂载点在同一VPC下。请检查：

   • VPC一致性：在EAS服务配置和NAS挂载点配置中，确认VPC ID相同。

   • 网络配置：如需访问NAS，请参见EAS访问公网或内网资源配置网络。

   • 挂载点状态：确认NAS挂载点已成功创建且处于可用状态。

3. Git挂载失败，提示认证错误怎么办？

   请检查以下配置：

   • 访问令牌有效性：确认Git访问令牌（Access Token）未过期，且具有仓库读取权限。

   • 仓库权限：对于私有仓库，确认用户名和密码/令牌正确，且具有读取权限。

   • 仓库地址格式：使用HTTPS协议（如https://github.com/user/repo.git），不支持Git协议。

   • 分支/Commit存在性：确认指定的分支名称或commit ID在仓库中存在。

4. 挂载路径冲突，服务启动失败怎么办？

   挂载路径冲突通常有以下原因：

   • 重复挂载路径：同一服务中，多个存储配置使用了相同的挂载路径。请确保每个存储的mount_path唯一。

   • 系统目录冲突：挂载路径不能使用系统关键目录，如/bin、/etc、/usr、/lib等。建议使用/mnt或/data目录下的路径。

   • 路径格式错误：挂载路径必须是绝对路径，以/开头。

5. 可以直接用FTP或SSH工具连接到实例上传/下载文件吗？

   不可以。EAS实例不提供FTP或SSH访问。

6. EAS和OSS不在同一地域，可以挂载吗？

   不可以。EAS无法跨地域挂载OSS。请使用 OSS的跨区域复制将数据同步到与EAS服务相同地域的OSS Bucket中。

7. 未挂载存储时，下载到实例中的文件去哪了？

   文件保存在实例的系统盘中，会在实例重启或更新后被清空，导致数据丢失。建议挂载存储以持久化数据。