カスタムイメージを使用すると、既存のイメージをインポートしたり、PAI 上で直接新しいイメージをビルドしたりでき、開発およびトレーニングのワークフローをサポートします。
概要
カスタムイメージは、次の 2 つの方法で追加できます。
-
既存のイメージをインポート：ローカルまたはクラウドサーバーでイメージをビルドし、Alibaba Cloud Container Registry (ACR) にプッシュします。その後、PAI コンソールで ACR イメージの詳細を入力して、PAI のカスタムイメージとして登録します。
-
新しいイメージをビルド：PAI コンソールで ACR イメージの詳細、ランタイム設定、ビルド構成を入力します。ビルド完了後、イメージは自動的に ACR にプッシュされ、PAI のカスタムイメージとして登録されます。
権限
-
Alibaba Cloud アカウント (主アカウント)：すべての権限を持ちます。追加の認可は不要です。
-
RAM ユーザー (サブアカウント)：ワークスペースのメンバーとして追加し、ロールを割り当てる必要があります。詳細については、「Manage workspaces - Members and roles」をご参照ください。
イメージの登録：既存イメージのインポート
AI アセット管理 > イメージに移動してワークスペースを選択します。カスタムイメージ タブで、[イメージの登録] をクリックし、[既存イメージのインポート] を選択して、Alibaba Cloud Container Registry (ACR) のイメージを PAI カスタムイメージとして登録します。
主要パラメータ：
|
パラメータ |
説明 |
|
イメージタイプ |
|
|
Enterprise Edition インスタンス / イメージ名前空間 / イメージリポジトリ / イメージタグ / カスタムドメイン |
既存の Enterprise Edition インスタンス、名前空間、リポジトリ、イメージタグ、カスタムドメインを選択するか、Container Registry console に移動して作成します。 説明
|
|
可視性 |
|
|
チップタイプ |
イメージの実行対象環境に基づいて、CPU、GPU、または PPU を選択します。 |
イメージの登録：新規イメージのビルド
AI アセット管理 > イメージ に移動し、ワークスペースを選択します。カスタムイメージ タブで、[イメージの登録] をクリックし、[新しいイメージをビルド] を選択します。ビルドが完了すると、イメージは自動的に ACR にプッシュされ、PAI カスタムイメージとして登録されます。
主要パラメータ：
|
パラメータ |
説明 |
|
基本情報 |
|
|
イメージタイプ |
ビルドできるのは Enterprise Edition のイメージのみです。詳細については、「What is Container Registry?」をご参照ください。 |
|
Enterprise Edition インスタンス / イメージ名前空間 / イメージリポジトリ / カスタムドメイン |
既存の Enterprise Edition インスタンス、名前空間、リポジトリ、カスタムドメインを選択するか、Container Registry console に移動して作成します。 説明
権限エラーが表示される場合は、RAM ユーザーに AliyunContainerRegistryReadOnlyAccess ポリシーをアタッチします。詳細については、「Manage RAM user permissions」をご参照ください。 |
|
可視性 |
|
|
チップタイプ |
イメージの実行対象環境に基づいて、CPU、GPU、または PPU を選択します。 |
|
ランタイム設定 |
|
|
ランタイムリソース |
ビルド構成に含まれる依存関係または Dockerfile の命令のリソース要件に基づいて、ビルドジョブのコンピューティングリソースを選択します。たとえば、Dockerfile にコンパイル手順が含まれている場合は、より多くのリソースを選択します。 |
|
VPC / セキュリティグループ |
Enterprise Edition インスタンスにバインドされている Virtual Private Cloud (VPC) を選択します。 説明
ビルドジョブがインターネットにアクセスする必要がある場合 (例：サードパーティのベースイメージのプル、または ビルド構成で指定した依存関係のインストール) は、VPC にパブリック NAT ゲートウェイを作成し、Elastic IP アドレス (EIP) を関連付け、SNAT ルールを設定します。詳細については、「パブリック NAT ゲートウェイを使用したインターネットアクセスの改善」をご参照ください。 |
|
ビルド構成 |
|
|
ビルド方法 |
|
イメージビルドジョブの表示
-
カスタムイメージ タブで、タスクの表示 をクリックしてイメージビルドジョブのリストを表示します。
-
[操作] 列の 詳細 をクリックして、イメージビルドジョブの詳細 を表示します。
-
[ランタイム設定] セクションで、ログを表示 と [モニタリングの表示] をクリックして、対応する DLC ジョブのログとモニタリングデータを確認します。
カスタムイメージの表示
登録後、カスタムイメージ タブに移動して、登録済みのイメージアドレスを確認します。これらのイメージをトレーニングジョブで使用します。
イメージリストの [Image address] 列には、各イメージの VPC アドレスが <registry-name>-vpc.<region>.cr.aliyuncs.com/<namespace>/<image>:<tag> の形式で表示されます。このアドレスを使用して、トレーニングジョブでカスタムイメージを参照します。
よくある質問
Q：Dockerfile を使用してイメージをビルドすると、ログに dial tcp xxx:443: i/o timeout が表示されます。対処方法を教えてください。
このエラーは、ビルドジョブがベースイメージをホストしているレジストリに到達できないことを示します。
-
FROM命令または Based on existing image フィールドのイメージアドレスが パブリックドメインを使用しているかどうかを確認します。使用している場合は、対応する VPC ドメインに置き換えます (パブリックドメイン形式：<registry>.cn-xxx.cr.aliyuncs.com、VPC ドメイン形式：<registry>-vpc.cn-xxx.cr.aliyuncs.com)。 -
VPC / セキュリティグループで選択した VPC が、Enterprise Edition インスタンスの アクセス制御 > VPC でバインドされていることを確認します。
-
タイムアウトが解消しない場合は、セキュリティグループルールで、ビルドジョブから ACR VPC エンドポイントへのアウトバウンドトラフィックが許可されているか確認します。
関連トピック
-
イメージを PAI のカスタムイメージとして登録した後、トレーニングジョブで使用できます。詳細については、「Create a training job」をご参照ください。