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 にプッシュしたイメージを登録する場合に使用します。
操作手順
PAI コンソールを開き、対象のワークスペースを選択します。
[AI アセット管理] > [イメージ] に移動します。
[カスタムイメージ] タブで、[イメージの登録] をクリックし、[既存イメージのインポート] を選択します。
以下のパラメーターを設定します。

パラメーター | 説明 |
イメージタイプ |
|
Enterprise Edition インスタンス / イメージ名前空間 / イメージリポジトリ / イメージバージョン / カスタムドメイン名 | 既存のインスタンス、名前空間、リポジトリ、バージョン、カスタムドメイン名を選択するか、Container Registry コンソールに移動して作成します。 説明
|
可視性 |
|
チップタイプ | ターゲットのハードウェアに合わせて [CPU] または [GPU] を選択します。 |
[確認] をクリックして、イメージを登録します。
方法 2: 新しいイメージのビルド
この方法は、PAI で直接カスタムイメージをビルドする場合に使用します。現在、ビルドできるのは Enterprise Edition イメージのみです。
操作手順
PAI コンソールを開き、対象のワークスペースを選択します。
[AI 資産管理] > [イメージ] に移動します。
[カスタムイメージ] タブで、[イメージの登録] をクリックし、[新しいイメージのビルド] を選択します。
基本情報を設定します。

パラメーター | 説明 |
基本情報 | |
イメージタイプ | 現在、ビルドできるのは Enterprise Edition イメージのみです。詳細については、「Container Registry (ACR) とは」をご参照ください。 |
Enterprise Edition インスタンス / イメージ名前空間 / イメージリポジトリ / カスタムドメイン名 | 既存のインスタンス、名前空間、リポジトリ、カスタムドメイン名を選択するか、Container Registry コンソールに移動して作成します。 説明 権限エラーが発生した場合は、RAM ユーザーに |
可視性 |
|
チップタイプ | ターゲットのハードウェアに合わせて [CPU] または [GPU] を選択します。 |
ランタイム情報 | |
リソース | ビルドジョブの計算リソースを選択します。Dockerfile にコンパイルステップが含まれる場合は、より高いスペックを選択してください。 |
VPC 設定 / セキュリティグループ | Enterprise Edition インスタンスにバインドされている VPC と、適切なセキュリティグループを選択します。 説明 ビルドジョブでパブリックネットワークへのアクセス (依存関係のダウンロードなど) が必要な場合は、インターネット NAT ゲートウェイを作成し、EIP をアタッチして SNAT ルールを設定します。詳細については、「専用ゲートウェイを使用したパブリックネットワークアクセス速度の向上」をご参照ください。 |
ビルド設定 | |
ビルド方法 |
|
上記の表に従ってランタイム情報を設定します。
ビルド設定を構成し、希望のビルド方法を選択します。
[確定] をクリックしてビルドジョブを開始します。
ビルドジョブのモニタリング
イメージビルドジョブの進捗を追跡し、問題をトラブルシューティングします。
[カスタムイメージ] タブで、[ジョブの表示] をクリックします。
対象のビルドジョブを見つけ、そのステータスを表示します。

[ログの表示]をクリックしてビルド出力を確認し、問題をデバッグします。
[モニタリングの表示] をクリックして、DLC ジョブのリソース使用状況を確認します。

カスタムイメージの使用
登録後、カスタムイメージはトレーニングジョブで使用できる状態になります。
[カスタムイメージ] タブで、イメージを見つけ、そのレジストリアドレスをコピーします。

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