すべてのプロダクト
Search
ドキュメントセンター

Platform For AI:DSW インスタンスイメージの作成

最終更新日:Jan 16, 2026

現在の DSW インスタンスの環境をカスタムイメージとして保存し、Container Registry (ACR) にプッシュすることで、迅速な再利用や共有が可能です。これにより、コード、依存関係、システム構成が保持されます。これは、特定の CUDA や Python バージョンなど、公式イメージが特定の要件を満たさない場合に役立ちます。作成されたイメージは、DLC や EAS などの他の PAI サービスとも互換性があります。

重要

  • インスタンスステータス: イメージは、実行中ステータスの DSW インスタンスからのみ作成してください。インスタンスが停止している場合、[イメージの作成] ボタンはグレー表示されます。

  • リージョン: DSW インスタンスと Container Registry (ACR) インスタンスは、同じリージョンにある必要があります。リージョンの不一致は、イメージリポジトリや名前空間が見つからない最も一般的な原因です。

  • イメージサイズの制限: 単一のイメージレイヤーは 10 GiB を超えることはできません。超えた場合、ビルドプロセスはタイムアウトまたは容量不足により失敗します。

  • 環境の制限: DSW はコンテナー化された環境であり、Docker のインストールや使用はサポートされていません。

  • ACR Personal Edition と Enterprise Edition の違い:

    機能

    ACR Personal Edition

    ACR Enterprise Edition

    コスト

    インスタンスは無料です。

    インスタンスを購入する必要があります。詳細については、「Enterprise インスタンスの課金」をご参照ください。

    ネットワーク構成

    パブリックネットワーク経由でアクセスします。特別なネットワーク構成は必要ありません。

    DSW インスタンスと同じ Virtual Private Cloud (VPC) 内にある必要があります。内部ネットワーク経由のアクセスにより、より安定したデータ転送が保証されます。

    パフォーマンスと安定性

    速度はパブリックネットワークの帯域幅に影響されます。10 GiB に近いサイズの大きなイメージのプッシュまたはプルは、ネットワークの変動により失敗する可能性があります。

    高速性と安定性を提供します。VPC 内部ネットワーク経由のデータ転送は、大きなイメージや本番環境に最適です。

    リージョンの柔軟性

    1 つの Alibaba Cloud アカウントで作成できる Personal Edition インスタンスは 1 つのリージョンのみです。DSW インスタンスが別のリージョンにある場合、使用することはできません。

    Enterprise Edition インスタンスは複数のリージョンに作成でき、異なるリージョンにある DSW インスタンスから使用できます。

    推奨シナリオ

    個人学習、機能テスト、小規模なイメージ環境のバックアップ。

    チームコラボレーション、本番環境、高い安定性と転送速度を必要とするシナリオ、およびリージョン間のイメージ使用。

手順

ステップ 1: ACR の準備

ビジネスニーズに応じて、ACR Personal Edition または ACR Enterprise Edition のいずれかを選択します。

ステップ 2: イメージの作成

実行中ステータスの DSW インスタンスで、[イメージの作成] をクリックし、[Personal Edition イメージ] または [Enterprise Edition イメージ] のいずれかを選択し、次の主要なパラメーターを構成してから、[保存] をクリックします。

image

パラメーター

説明

イメージ名 (ACR イメージバージョン名)

カスタムイメージの表示名と ACR のイメージタグ。

ACR イメージ名前空間

既存の名前空間を選択します。

ACR イメージリポジトリ

既存のイメージリポジトリを選択します。

カスタム除外パス

イメージ作成時に特定のファイルやディレクトリを除外して、作成速度の向上、ストレージ容量の節約、機密情報の保護を行います。パスを指定しない場合、システムはデフォルトの除外パスを使用します。

説明

単一のイメージレイヤーは 10 GiB を超えることはできません。超えた場合、ビルドは失敗します。不要なパスを除外して、イメージサイズを削減してください。

  • カスタム除外パス

    仕様が ecs.ebm で始まらないパブリックリソースグループ内のインスタンスのみが、カスタム除外パスをサポートします。

  • システムのデフォルト除外パス (構成不要)

    • 仕様が ecs.ebm で始まらないパブリックリソースグループ内のインスタンスの場合:
      /mnt/workspace/home/admin/workspace/home/admin/logs/tmp//etc/dsw/etc/dsw-logs

    • 一般的な計算資源グループ内のインスタンス、仕様が ecs.ebm で始まるパブリックリソースグループ内のインスタンス、および Lingjun 計算資源グループ内のインスタンスの場合:
      /mnt/workspace/home/admin/workspace/home/admin/logs/tmp//data/dev/shm/etc/dsw/etc/dsw-logs

イメージの作成後、image アイコンにポインターを合わせるとイメージアドレスを表示できます。または、[こちら] をクリックして Container Registry コンソールに移動し、イメージの詳細を表示します。

image

ステップ 3: カスタムイメージの使用

イメージが作成された後、新しい DSW インスタンスを作成する際に、[イメージ] > [カスタムイメージ] を選択してカスタムイメージを使用します。

image

よくある質問

Q: DSW イメージの作成がタイムアウトまたは「ephemeral storage の容量不足」エラーで失敗するのはなぜですか?

  • イメージサイズが 10 GiB の制限を超えています。各イメージレイヤーには 10 GiB のハードリミットがあります。データがこれを超えると、ビルドは失敗します。

    解決策: 不要なファイルやディレクトリを除外して、イメージサイズを削減してください。一貫して大きなイメージの場合は、プライベートネットワーク経由でより優れたパフォーマンスと安定性を提供する ACR Enterprise Edition を使用してください。

  • DSW と ACR のリージョンが一致しません。 DSW インスタンスと ACR インスタンスは同じリージョンにある必要があります。
    解決策: 両方のサービスがまったく同じリージョンにデプロイされていることを確認してください。これは、ACR リポジトリが見つからない最も一般的な原因です。

  • システムディスクの容量が不足しています。
    エラーメッセージ insufficient capacity of ephemeral storage は、イメージ作成プロセス中に DSW インスタンスのシステムディスクの容量が不足したことを示します。
    解決策: イメージから不要な大きなディレクトリを除外して、サイズを削減してください。




  • ACR Personal Edition のネットワークが不安定です。
    ACR Personal Edition はパブリックインターネット経由でイメージをプッシュするため、大きなイメージの場合は速度が遅く信頼性が低くなり、しばしばタイムアウトが発生します。
    解決策: 信頼性を高めるには、DSW インスタンスと同じ VPC に構成された ACR Enterprise Edition インスタンスを使用してください。これにより、高速で安定した内部ネットワーク経由でイメージがプッシュされます。




Q: DSW で「イメージの作成」ボタンが無効になっている、または ACR リポジトリが見つからないのはなぜですか?

  1. DSW インスタンスが実行されていません。
    [イメージの作成] ボタンは、実行中 状態のインスタンスに対してのみアクティブになります。
    解決策: コンソールから DSW インスタンスを開始してください。停止 または別の状態の場合、ボタンはグレー表示されます。




  2. ACR の前提条件が満たされていません。

    • まず Container Registry (ACR) インスタンスを作成し、次にそのインスタンス内に名前空間とイメージリポジトリを作成する必要があります。

    • ACR インスタンスと DSW インスタンスが同じリージョンにあることを確認してください。

Q: DSW インスタンス内に Docker をインストールして実行する方法はありますか?

いいえ、DSW インスタンス内に Docker デーモンをインストールしたり実行したりすることはできません。

DSW 自体はコンテナー化された環境であり、ネストされたコンテナー化はサポートしていません。Docker をインストールしようとすると失敗します。

Docker イメージを使用する正しい方法は、インスタンス作成時にそれを指定することです:

  1. 目的の Docker イメージを ACR リポジトリにプッシュします。

  2. 新しい DSW インスタンスを作成する際に、[カスタムイメージ] を選択します。

  3. ACR 内のイメージの完全なアドレスを指定します。

Q: DSW インスタンスで NVIDIA ドライバーまたは CUDA バージョンをアップグレードする正しい方法は何ですか?

実行中の DSW インスタンス内で NVIDIA ドライバーまたは CUDA バージョンを手動でアップグレードしようとしないでください。これらのコンポーネントはプリインストール済みで、システムの安定性を確保するためにロックされています。これらを変更すると、インスタンスが永久に破損する可能性があります。

正しい方法は、より新しい公式イメージに基づくインスタンスに置き換えることです:

  1. 現在の DSW インスタンスの作業を停止して保存します。

  2. 新しい DSW インスタンスを作成します。

  3. イメージ選択ステップで、ターゲットの CUDA バージョンを含む公式 DSW イメージを選択します。バージョンはイメージタグから特定できます。

たとえば、...-cu118-... のようなタグを持つイメージは、CUDA バージョン 11.8 でビルドされています。

Q: カスタムイメージまたはサードパーティイメージを使用すると、DSW インスタンスの作成が失敗するのはなぜですか?

  • イメージのプル権限: これが最も一般的な原因です。エラーログに pull access denied または authorization failed と表示される場合は、権限の問題が確認されます。
    解決策: プライベートリポジトリを使用している場合は、DSW インスタンスのネットワーク構成 (例: VPC) がアクセスを許可していること、および ACR リポジトリの権限付与ポリシーが正しく設定されていることを確認してください。

  • イメージの非互換性: カスタムイメージが DSW ランタイム環境と互換性がない可能性があります。
    解決策: 互換性を保証するには、公式の DSW イメージをベースとしてカスタムイメージをビルドしてください。ゼロから始める場合は、標準の Linux ディストリビューションに基づいていることを確認してください。

  • 不正なイメージアドレス形式: システムが無効なイメージパスを解析できません。
    解決策: イメージアドレスが正しくフォーマットされていること (例: registry.region-id.aliyuncs.com/namespace/repository:tag)、および有効なイメージを指していることを再確認してください。