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

Platform For AI:カスタムイメージ

最終更新日:Jan 29, 2026

PAI のカスタムイメージ機能を使用すると、既存のコンテナイメージをインポートしたり、プラットフォーム上で直接新しいイメージをビルドしたりできます。カスタムイメージは、多様なトレーニングワークフローをサポートし、生産性を向上させます。

前提条件

開始する前に、以下の条件が満たされていることを確認してください。

  • Alibaba Cloud アカウント: PAI が有効化され、ワークスペースが作成済みであること。

  • ACR の設定: Enterprise Edition イメージの場合、Container Registry (ACR) Enterprise Edition インスタンスを作成し、名前空間とリポジトリが作成済みであること。

  • 権限

    • Alibaba Cloud アカウント: デフォルトですべての権限を持っています。

    • RAM ユーザー: ワークスペースのメンバーとして追加され、ロールの権限が割り当てられている必要があります。詳細については、「ワークスペースのメンバーとロールの管理」をご参照ください。

概要

PAI では、カスタムイメージを追加するために 2 つの方法を提供しています。

方法

最適なケース

複雑さ

既存のイメージのインポート

既にビルド済みのイメージの再利用

中 - 手動での ACR 設定が必要

新しいイメージのビルド

PAI を使用したイメージの新規作成

低 - ワンストップのワークフロー

  • 既存のイメージのインポート: ローカルまたは ECS 上でイメージをビルドし、ACR にプッシュしてから PAI に登録します。既存のイメージを再利用する場合に最適です。

  • 新しいイメージのビルド: PAI コンソールで ACR の宛先、ランタイム、ビルド設定を構成します。PAI がイメージのビルド、プッシュ、登録を自動的に行います。一か所でイメージのビルドと登録を行う、合理化されたワークフローです。

方法 1: 既存のイメージのインポート

この方法は、既に ACR にプッシュしたイメージを登録する場合に使用します。

操作手順

  1. PAI コンソールを開き、対象のワークスペースを選択します。

  2. [AI アセット管理] > [イメージ] に移動します。

  3. [カスタムイメージ] タブで、[イメージの登録] をクリックし、[既存イメージのインポート] を選択します。

  4. 以下のパラメーターを設定します。

Register Image dialog - Import Existing Image

パラメーター

説明

イメージタイプ

Enterprise Edition インスタンス / イメージ名前空間 / イメージリポジトリ / イメージバージョン / カスタムドメイン名

既存のインスタンス、名前空間、リポジトリ、バージョン、カスタムドメイン名を選択するか、Container Registry コンソールに移動して作成します。

説明
  • [Enterprise Edition インスタンス] および [カスタムドメイン名] パラメーターは、Enterprise Edition イメージの場合にのみ必須です。

  • 権限エラーが発生した場合は、RAM ユーザーに AliyunContainerRegistryReadOnlyAccess 権限を付与してください。詳細については、「RAM ユーザーの権限管理」をご参照ください。

可視性

  • 自分にのみ表示: ご自身とワークスペースの管理者のみがこのイメージを閲覧できます。

  • 現在のワークスペースに表示: ワークスペースのすべてのメンバーがこのイメージを閲覧できます。

チップタイプ

ターゲットのハードウェアに合わせて [CPU] または [GPU] を選択します。

  1. [確認] をクリックして、イメージを登録します。

方法 2: 新しいイメージのビルド

この方法は、PAI で直接カスタムイメージをビルドする場合に使用します。現在、ビルドできるのは Enterprise Edition イメージのみです。

操作手順

  1. PAI コンソールを開き、対象のワークスペースを選択します。

  2. [AI 資産管理] > [イメージ] に移動します。

  3. [カスタムイメージ] タブで、[イメージの登録] をクリックし、[新しいイメージのビルド] を選択します。

  4. 基本情報を設定します。

Register Image dialog - Build New Image

パラメーター

説明

基本情報

イメージタイプ

現在、ビルドできるのは Enterprise Edition イメージのみです。詳細については、「Container Registry (ACR) とは」をご参照ください。

Enterprise Edition インスタンス / イメージ名前空間 / イメージリポジトリ / カスタムドメイン名

既存のインスタンス、名前空間、リポジトリ、カスタムドメイン名を選択するか、Container Registry コンソールに移動して作成します。

説明

権限エラーが発生した場合は、RAM ユーザーに AliyunContainerRegistryReadOnlyAccess 権限を付与してください。詳細については、「RAM ユーザーの権限管理」をご参照ください。

可視性

  • 自分にのみ表示: ご自身とワークスペースの管理者のみがこのイメージを閲覧できます。

  • 現在のワークスペースに表示: ワークスペースのすべてのメンバーがこのイメージを閲覧できます。

チップタイプ

ターゲットのハードウェアに合わせて [CPU] または [GPU] を選択します。

ランタイム情報

リソース

ビルドジョブの計算リソースを選択します。Dockerfile にコンパイルステップが含まれる場合は、より高いスペックを選択してください。

VPC 設定 / セキュリティグループ

Enterprise Edition インスタンスにバインドされている VPC と、適切なセキュリティグループを選択します。

説明

ビルドジョブでパブリックネットワークへのアクセス (依存関係のダウンロードなど) が必要な場合は、インターネット NAT ゲートウェイを作成し、EIP をアタッチして SNAT ルールを設定します。詳細については、「専用ゲートウェイを使用したパブリックネットワークアクセス速度の向上」をご参照ください。

ビルド設定

ビルド方法

  • 既存のイメージをベースにする: 公式、カスタム、またはサードパーティのイメージから開始します。pip2、pip3、yum、または apt を使用して依存関係をインストールします。非公開リポジトリの場合は、認証情報を入力します。

  • Dockerfile をベースにする: カスタムの Dockerfile 命令を記述します。構文の詳細については、「Dockerfile リファレンス」をご参照ください。

  1. 上記の表に従ってランタイム情報を設定します。

  2. ビルド設定を構成し、希望のビルド方法を選択します。

  3. [確定] をクリックしてビルドジョブを開始します。

ビルドジョブのモニタリング

イメージビルドジョブの進捗を追跡し、問題をトラブルシューティングします。

  1. [カスタムイメージ] タブで、[ジョブの表示] をクリックします。

  2. 対象のビルドジョブを見つけ、そのステータスを表示します。

    View Jobs interface showing build job list

  3. [ログの表示]をクリックしてビルド出力を確認し、問題をデバッグします。

  4. [モニタリングの表示] をクリックして、DLC ジョブのリソース使用状況を確認します。

    Job details page with View Log and View Monitoring

カスタムイメージの使用

登録後、カスタムイメージはトレーニングジョブで使用できる状態になります。

  1. [カスタムイメージ] タブで、イメージを見つけ、そのレジストリアドレスをコピーします。

    Custom Image tab showing registered images

  2. トレーニングジョブを作成する際に、このアドレスを使用します。詳細については、「トレーニングジョブの作成」をご参照ください。

参考