分离并清理自定义图像资源 - 亚马逊 SageMaker AI
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

分离并清理自定义图像资源

以下页面提供了有关如何使用 Amazon A SageMaker I 控制台或 Amazon Command Line Interface (Amazon CLI) 分离您的自定义映像和清理相关资源的说明。

重要

在从 SageMaker AI 图像存储库中删除图片之前，必须先将自定义图像与域分离。否则，您在查看域名信息或将新的自定义图像附加到域名时可能会遇到错误。

如果您在加载自定义图像时遇到错误，请参阅加载自定义镜像失败。

以下内容提供了有关如何使用控制台将您的自定义映像与 SageMaker AI 分离以及清理自定义图像资源的说明。

将您的自定义图片与您的域名分离

  1. 打开 A SageMaker I 控制台。

  2. 展开 “管理员配置” 部分。

  3. 在管理员配置下，选择域。

  4. 从域列表中选择一个域。

  5. 打开环境选项卡。

  6. 对于个人 Studio 应用程序的自定义图像，请选中要分离的图像的复选框。

  7. 选择分离。

  8. 按照说明进行分离。

删除您的自定义图片

  1. 打开 A SageMaker I 控制台。

  2. 展开 “管理员配置” 部分（如果尚未这样做）。

  3. 在管理员配置下，选择映像。

  4. 从图片列表中，选择要删除的图片。

  5. 选择删除。

  6. 按照说明从 SageMaker AI 中删除您的图像及其所有版本。

从 Amazon ECR 中删除您的自定义镜像和存储库
重要

这还将删除此存储库中的所有容器镜像和工件。

  1. 打开 Amazon ECR 控制台。

  2. 如果尚未这样做，请展开左侧导航窗格。

  3. 在 “私有注册表” 下，选择 “存储库”。

  4. 选择要删除的存储库。

  5. 选择删除。

  6. 按照说明进行删除。

以下部分显示了如何使用分离自定义映像的示例。 Amazon CLI

  1. 首先为接下来的 Amazon CLI 命令设置变量。

    ACCOUNT_ID=account-id
REGION=aws-region
APP_IMAGE_CONFIG=app-image-config
SAGEMAKER_IMAGE_NAME=custom-image-name

    • aws-region是你 Amazon Web Services 区域 的 Amazon A SageMaker I 域名。你可以在任何 Amazon 主机页面的右上角找到它。

    • app-image-config是您的应用程序映像配置的名称。使用以下 Amazon CLI 命令列出中的应用程序映像配置 Amazon Web Services 区域。

      aws sagemaker list-app-image-configs \
       --region ${REGION}

    • custom-image-name是自定义图像名称。使用以下 Amazon CLI 命令列出您的中的图像 Amazon Web Services 区域。

      aws sagemaker list-images \
       --region ${REGION}

  2. 要按照这些说明将图像和图像版本与您的网域分离，您需要创建或更新域配置 json 文件。

    注意

    如果您按照中的说明进行操作将您的自定义图片附加到您的域名，则可能已使用名为的文件更新了您的域名update-domain.json。

    如果您没有该文件，则可以改为创建一个新的 json 文件。

    创建一个名为update-domain.json的文件，用于更新您的域名。

  3. 要删除自定义图片，你需要留CustomImages空，这样"CustomImages": []。选择以下选项之一，查看代码编辑器的示例配置文件或 JupyterLab。

    Code Editor: update domain configuration file example

    代码编辑器的配置文件示例，使用CodeEditorAppSettings。

    {
    "DomainId": "domain-id",
    "DefaultUserSettings": {
        "CodeEditorAppSettings": {
            "CustomImages": [
            ]
        }
    }
}
    JupyterLab: update domain configuration file example

    的配置文件示例 JupyterLab，使用JupyterLabAppSettings。

    {
    "DomainId": "domain-id",
    "DefaultUserSettings": {
        "JupyterLabAppSettings": {
            "CustomImages": [
            ]
        }
    }
}

    domain-id是您的图片所附的域名 ID。使用以下命令列出您的域名。

    aws sagemaker list-domains \
      --region ${REGION}

  4. 保存该文件。

  5. 使用更新域配置文件调 Amazon CLI 用更新域。update-domain.json

    注意

    在更新自定义映像之前，必须先删除域中的所有应用程序。您无需删除用户个人资料或共享空间。有关删除应用程序的说明，请选择以下选项之一。

    aws sagemaker update-domain \
    --cli-input-json file://update-domain.json \
    --region ${REGION}

  6. 删除应用程序映像配置。

    aws sagemaker delete-app-image-config \
    --app-image-config-name ${APP_IMAGE_CONFIG}

  7. 删除自定义镜像。这还会删除所有图像版本。这不会删除 Amazon ECR 容器镜像和镜像版本。为此，请使用以下可选步骤。

    aws sagemaker delete-image \
    --image-name ${SAGEMAKER_IMAGE_NAME}

  8. （可选）删除您的 Amazon ECR 资源。以下列表提供了 Amazon CLI 用于获取您的 Amazon ECR 资源信息的命令，用于执行以下步骤。

    1. 为接下来的 Amazon CLI 命令设置变量。

      ECR_REPO_NAME=ecr-repository-name

      ecr-repository-name是您的 Amazon 弹性容器注册表存储库的名称。

      要列出仓库的详细信息，请使用以下命令。

      aws ecr describe-repositories \
        --region ${REGION}

    2. 从 Amazon ECR 中删除您的存储库。

      重要

      这还将删除此存储库中的所有容器镜像和工件。

      aws ecr delete-repository \
      --repository-name ${ECR_REPO_NAME} \
      --force \
      --region ${REGION}