

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# カスタムイメージをドメインにアタッチする
<a name="studio-updated-byoi-how-to-attach-to-domain"></a>

このページでは、カスタムイメージをドメインにアタッチする方法について説明します。Amazon SageMaker AI コンソールを使用してドメインに移動し、**イメージをアタッチ**するプロセスを開始するには、次の手順に従います。

次の手順では、 ドメインと同じ の Amazon ECR リポジトリにイメージをプッシュしていることを前提 AWS リージョン としています。まだプッシュしていない場合は、「[カスタムイメージを作成して Amazon ECR にプッシュする](studio-updated-byoi-how-to-prepare-image.md)」を参照してください。

イメージをアタッチする場合は、次の 2 つのオプションがあります。
+ **新しいイメージ**をアタッチする: このオプションでは、SageMaker AI イメージストアでイメージとイメージバージョンが作成され、ドメインにアタッチされます。
**注記**  
BYOI プロセスを続行する場合は、「[カスタムイメージを作成して Amazon ECR にプッシュする](studio-updated-byoi-how-to-prepare-image.md)」に記載の**新しいイメージ**オプションを使用します。
+ **既存のイメージ**をアタッチする: 使用するカスタムイメージを SageMaker AI イメージストアで既に作成している場合は、このオプションを使用します。このオプションでは、既存のカスタムイメージがドメインにアタッチされます。SageMaker AI イメージストアでカスタムイメージを表示するには、「[カスタムイメージの詳細を表示する (コンソール)](studio-updated-byoi-view-images.md#studio-updated-byoi-view-images-console)」を参照してください。

------
#### [ New image ]

**新しいイメージをドメインにアタッチするには**

1. [SageMaker AI コンソール](https://console.aws.amazon.com/sagemaker)を開きます。

1. **[管理者設定]** セクションが展開されていない場合は、展開します。

1. **[管理設定]** で、**[ドメイン]** を選択します。

1. **[ドメイン]** のリストから、イメージをアタッチするドメインを選択します。
**注記**  
イメージを SageMaker Unified Studio プロジェクトにアタッチし、使用するドメインを明確にする必要がある場合は、[「プロジェクトに関連付けられた SageMaker AI ドメインの詳細を表示する](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/view-project-details.html#view-project-details-smai-domain)」を参照してください。

1. **[環境]** タブを開きます。

1. **[パーソナル Studio アプリ用のカスタムイメージ]** セクションで、**[イメージをアタッチ]** をクリックします。

1. **[イメージソース]** で、**[新しいイメージ]** をクリックします。

1. Amazon ECR イメージの URI を追加します。形式は次のとおりです。

   ```
   {{account-id}}.dkr.ecr.{{aws-region}}.amazonaws.com/{{repository-name}}:{{tag}}
   ```

   1. Amazon ECR イメージ URI を取得するには、[[Amazon ECR プライベートリポジトリ]](https://console.aws.amazon.com/ecr/private-registry/repositories) ページに移動します。

   1. リポジトリ名のリンクをクリックします。

   1. Choose the icon that イメージバージョン (**イメージのタグ**) に対応する **[URI をコピー]** アイコンをクリックします。

1. 残りの手順に従って、カスタムイメージをアタッチします。
**注記**  
`Dockerfile` と一致するアプリケーションタイプを使用していることを確認します。詳細については、「[Dockerfile サンプル](studio-updated-byoi-specs.md#studio-updated-byoi-specs-dockerfile-templates)」を参照してください。

イメージがドメインに正常にアタッチされると、**[環境]** タブでイメージを表示できます。

------
#### [ Existing image ]

**既存のイメージをドメインにアタッチするには**

1. [SageMaker AI コンソール](https://console.aws.amazon.com/sagemaker)を開きます。

1. **[管理者設定]** セクションが展開されていない場合は、展開します。

1. **[管理設定]** で、**[ドメイン]** を選択します。

1. **[ドメイン]** のリストから、イメージをアタッチするドメインを選択します。
**注記**  
イメージを SageMaker Unified Studio プロジェクトにアタッチし、使用するドメインを明確にする必要がある場合は、[「プロジェクトに関連付けられた SageMaker AI ドメインの詳細を表示する](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/view-project-details.html#view-project-details-smai-domain)」を参照してください。

1. **[環境]** タブを開きます。

1. **[パーソナル Studio アプリ用のカスタムイメージ]** セクションで、**[イメージをアタッチ]** をクリックします。

1. **[イメージソース]** で、**[既存のイメージ]** をクリックします。

1. SageMaker AI イメージストアから既存のイメージとイメージバージョンを選択します。

   イメージバージョンを表示できない場合は、イメージバージョンを作成する必要がある場合があります。詳細については、「[カスタムイメージの詳細を表示する (コンソール)](studio-updated-byoi-view-images.md#studio-updated-byoi-view-images-console)」を参照してください。

1. 残りの手順に従って、カスタムイメージをアタッチします。
**注記**  
`Dockerfile` と一致するアプリケーションタイプを使用していることを確認します。詳細については、「[Dockerfile サンプル](studio-updated-byoi-specs.md#studio-updated-byoi-specs-dockerfile-templates)」を参照してください。

イメージがドメインに正常にアタッチされると、**[環境]** タブでイメージを表示できます。

------

イメージがドメインに正常にアタッチされると、ドメインユーザーはアプリケーション用のイメージを選択できます。詳細については、「[Studio でカスタムイメージを起動する](studio-updated-byoi-how-to-launch.md)」を参照してください。

**注記**  
SageMaker Unified Studio プロジェクトにカスタムイメージをアタッチした場合は、SageMaker Unified Studio 内からアプリケーションを起動する必要があります。詳細については、「*Amazon SageMaker Unified Studio ユーザーガイド*」の「[カスタムイメージを起動する](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-launch-custom-image.html)」を参照してください。