本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 将自定义映像附加到域
<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. 打开 A [SageMaker I 控制台](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. 打开 A [SageMaker I 控制台](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. 从 A SageMaker I 图像存储中选择现有的图像和图像版本。

   如果您无法查看映像版本，则可能需要创建映像版本。有关更多信息，请参阅 [查看自定义映像详细信息（控制台）](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 项目，则需要从 Uni SageMaker fied Studio 中启动该应用程序。有关更多信息，请参阅 *Amazon SageMaker Unified Studio 用户指南*中的[启动您的自定义镜像](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-launch-custom-image.html)。