Platform For AI: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 イメージ内の指定されたパスから一時的なローカルボリュームにファイルをコピーし、それをサービスインスタンスにマウントします。大きなディレクトリは大量のローカルストレージを消費し、起動時間を増加させます。必要な場合にのみ使用してください。

• 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": "/mnt/temp"
        }
    ]
}

{
    "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/oss_data/"
        },
        {
            "nfs": {
                "path": "/",
                "server": "06ba74****-a****.cn-hangzhou.nas.aliyuncs.com",
                "readOnly": false
            },
            "mount_path": "/mnt/nfs_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/git_code/"
        }
    ],
    "metadata": {
        "cpu": 1,
        "instance": 1,
        "resource": "eas-r-xxx"
    }
}

よくある質問

1. OSS バケットをマウントした後に「file not found」エラーが発生するのはなぜですか？

   このエラーは通常、パスが正しくないことが原因です。マウント設定とアクセスパスを確認してください。

   たとえば、oss://my-bucket/ を /mnt/data にマウントした場合、OSS 内の oss://my-bucket/subfolder/myfile.txt にあるファイルには、コンテナ内の /mnt/data/myfile.txt ではなく、/mnt/data/subfolder/myfile.txt パスからアクセスする必要があります。

2. ネットワーク接続の問題で NAS マウントが失敗した場合はどうすればよいですか？

   NAS マウントには、EAS サービスと NAS マウントターゲットが同じ VPC にある必要があります。次の項目を確認してください：

   • VPC の一貫性：EAS サービスと NAS マウントターゲットの両方で VPC ID が同じであることを確認してください。

   • ネットワーク設定：NAS にアクセスするには、「EAS からパブリックリソースまたは内部リソースへのアクセス」の指示に従ってネットワークを設定してください。

   • マウントターゲットのステータス：NAS マウントターゲットが存在し、Available 状態であることを確認してください。

3. 認証エラーで Git マウントが失敗した場合はどうすればよいですか？

   次の設定を確認してください：

   • アクセストークンの有効性：Git アクセストークンが期限切れでなく、リポジトリに対する読み取り権限があることを確認してください。

   • リポジトリの権限：プライベートリポジトリの場合、ユーザー名とパスワードまたはトークンが正しく、読み取り権限があることを確認してください。

   • リポジトリのアドレス形式：HTTPS プロトコルを使用してください (例：https://github.com/user/repo.git)。Git プロトコルはサポートされていません。

   • ブランチ/コミットの存在：指定されたブランチ名またはコミット ID がリポジトリに存在することを確認してください。

4. マウントパスの競合によりサービスが起動しない場合はどうすればよいですか？

   マウントパスの競合は、次の理由で発生する可能性があります：

   • マウントパスの重複：同じサービス内で、複数のストレージ設定が同じマウントパスを使用しています。各ストレージの mount_path が一意であることを確認してください。

   • システムディレクトリの競合：マウントパスは、/bin、/etc、/usr、/lib などの重要なシステムディレクトリにすることはできません。/mnt または /data 以下のパスを使用してください。

   • 不正なパス形式：マウントパスは、スラッシュ (/) で始まる絶対パスである必要があります。

5. FTP または SSH ツールを使用してインスタンスに接続し、ファイルをアップロードまたはダウンロードできますか？

   いいえ。EAS インスタンスは FTP または SSH アクセスを提供していません。

6. EAS サービスとは異なるリージョンにある OSS バケットをマウントできますか？

   いいえ。EAS はリージョンをまたいで OSS バケットをマウントすることはできません。OSS のクロスリージョンレプリケーション機能を使用して、EAS サービスと同じリージョン内の OSS バケットにデータを同期してください。

7. ストレージがマウントされていない場合、インスタンスにダウンロードしたファイルはどこに保存されますか？

   ファイルはインスタンスの一時的なシステムディスクに保存されます。システムディスク上のデータは、インスタンスが再起動または更新されると失われます。データを永続化するには、外部ストレージをマウントしてください。