将自定义映像附加到域

此页面提供了有关如何将自定义映像附加到域的说明。使用以下步骤使用 Amazon SageMaker AI 控制台导航到您的域并开始附加图片流程。

以下说明假设您已将映像推送到与您的域名Amazon Web Services 区域相同的 Amazon ECR 存储库。如果您尚未这样做，请参阅创建自定义映像并将其推送到 Amazon ECR。

当您选择附加映像时，将有两个选项：

附加新图片：此选项将在您的 SageMaker AI 图像存储中创建图像和图像版本，然后将其附加到您的网域。

注意
如果要继续执行 BYOI 流程，请在创建自定义映像并将其推送到 Amazon ECR中，使用新镜像选项。
附加现有图像：如果您已经在 SageMaker AI 图像存储中创建了预期的自定义图像，请使用此选项。此选项会将现有自定义映像附加到域。要在 SageMaker AI 图像存储中查看您的自定义图像，请参阅查看自定义映像详细信息（控制台）。

New image

打开 A SageMaker I 控制台。
展开管理员配置部分（如果尚未这样做）。
在管理员配置下，选择域。
在域列表中，选择要将映像附加到的域。

注意
如果您要将图像附加到 SageMaker Unified Studio 项目，并且需要说明要使用哪个域，请参阅查看与您的项目关联的 SageMaker AI 域详细信息。
打开环境选项卡。
在个人 Studio 应用程序的自定义镜像部分，选择附加镜像。
对于镜像源，选择新镜像。
包含 Amazon ECR 映像 URI。格式如下所示。
```
account-id.dkr.ecr.aws-region.amazonaws.com/repository-name:tag
```
1. 要获取 Amazon ECR 映像 URI，请导航到 Amazon ECR 私有存储库页面。
2. 选择存储库名称链接。
3. 选择与映像版本对应的复制 URI 图标（镜像标签）。
按照其余说明操作以附加自定义映像。

注意
确保您使用的应用程序类型与您的 Dockerfile 一致。有关更多信息，请参阅 Dockerfile 示例。

成功将映像附加到域后，您可以在环境选项卡中查看映像。

Existing image

打开 A SageMaker I 控制台。
展开管理员配置部分（如果尚未这样做）。
在管理员配置下，选择域。
在域列表中，选择要将映像附加到的域。

注意
如果您要将图像附加到 SageMaker Unified Studio 项目，并且需要说明要使用哪个域，请参阅查看与您的项目关联的 SageMaker AI 域详细信息。
打开环境选项卡。
在个人 Studio 应用程序的自定义镜像部分，选择附加镜像。
对于镜像源，选择现有镜像。
从 A SageMaker I 图像存储中选择现有的图像和图像版本。

如果您无法查看映像版本，则可能需要创建映像版本。有关更多信息，请参阅查看自定义映像详细信息（控制台）。
按照其余说明操作以附加自定义映像。

注意
确保您使用的应用程序类型与您的 Dockerfile 一致。有关更多信息，请参阅 Dockerfile 示例。

成功将映像附加到域后，您可以在环境选项卡中查看映像。

在映像成功附加到域后，域用户可以为其应用程序选择该映像。有关更多信息，请参阅在 Studio 中启动自定义映像。

如果您已将自定义映像附加到 SageMaker Unified Studio 项目，则需要从 Uni SageMaker fied Studio 中启动该应用程序。有关更多信息，请参阅 Amazon SageMaker Unified Studio 用户指南中的启动您的自定义镜像。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

创建自定义映像并将其推送到 Amazon ECR

更新容器配置