Platform For AI：為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. 未掛載儲存時，下載到執行個體中的檔案去哪了？

   檔案儲存在執行個體的系統硬碟中，會在執行個體重啟或更新後被清空，導致資料丟失。建議掛載儲存以持久化資料。