本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 將自訂映像連接至您的網域
<a name="studio-updated-byoi-how-to-attach-to-domain"></a>

此頁面提供如何將自訂映像連接至網域的指示。使用下列程序，以使用 Amazon SageMaker AI 主控台導覽至您的網域，並啟動**連接映像**程序。

下列指示假設您已將映像推送到與您網域 AWS 區域 相同的 Amazon ECR 儲存庫。如果您尚未這麼做，則請參閱[建立自訂映像並推送至 Amazon ECR](studio-updated-byoi-how-to-prepare-image.md)。

當您選擇連接映像時，您將有兩個選項：
+ 連接**新映像**：此選項會在 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. 選擇對應至映像版本的**複製 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)。