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

# 亚马逊 SageMaker Studio 经典版中的自定义图片
<a name="studio-byoi"></a>

**重要**  
截至 2023 年 11 月 30 日，之前的亚马逊 SageMaker Studio 体验现在被命名为 Amazon St SageMaker udio Classic。以下部分专门介绍如何使用 Studio Classic 应用程序。有关使用更新的 Studio 体验的信息，请参阅 [亚马逊 SageMaker Studio](studio-updated.md)。  
Studio Classic 仍针对现有工作负载进行维护，但不再可供入门使用。您只能停止或删除现有的 Studio Classic 应用程序，不能创建新的应用程序。我们建议您将[工作负载迁移到全新 Studio 体验](studio-updated-migrate.md)。

 SageMaker 图像是一个文件，用于标识在 Ama SageMaker zon Studio Classic 中运行 Jupyter 笔记本所需的内核、语言包和其他依赖关系。这些映像用于创建一个环境，然后在该环境中运行 Jupyter 笔记本。Amazon SageMaker AI 提供了许多内置图像供您使用。有关内置映像的列表，请参阅 [亚马逊 SageMaker 图片可用于 Studio Classic 笔记本电脑](notebooks-available-images.md)。

如果您需要不同的功能，可以将自己的自定义映像添加到 Studio Classic 中。您可以使用 SageMaker AI 控制面板、和 [Amazon Command Line Interface (Amazon CLI)](https://docs.amazonaws.cn/cli/latest/reference/sagemaker/) 创建图像和图像版本，并将图像版本附加到您的域或共享空间。[适用于 Python (Boto3) 的 Amazon SDK](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker.html)即使您尚未加入 SageMaker AI 域，也可以使用 AI 控制台创建图像和图像版本。 SageMaker SageMaker AI 提供了示例 Dockerfile，可用[作 SageMaker Studio Classic 自定义 SageMaker 映像示例存储库中的自定义映像](https://github.com/aws-samples/sagemaker-studio-custom-image-samples/)的起点。

以下主题说明如何使用 SageMaker AI 控制台自带图像，或者 Amazon CLI如何在 Studio Classic 中启动图像。有关类似的博客文章，请参阅[将您自己的 R 环境引入 Amazon SageMaker Studio Classic](https://www.amazonaws.cn/blogs/machine-learning/bringing-your-own-r-environment-to-amazon-sagemaker-studio/)。有关展示如何自带图像用于训练和推理的笔记本，请参阅 [Amazon SageMaker Studio Classic 容器构建 CLI](https://github.com/aws/amazon-sagemaker-examples/tree/main/aws_sagemaker_studio/sagemaker_studio_image_build)。

## 关键术语
<a name="studio-byoi-basics"></a>

下一节定义了将自带映像与 Studio Classic 一起使用的关键术语。
+ **Dockerfile：**Dockerfile 是一个用于标识 Docker 映像的语言包和其他依赖项的文件。
+ **Docker 映像：**Docker 映像是一个内置的 Dockerfile。此图像已签入到 Amazon ECR 中，并作为 SageMaker AI 图像的基础。
+ **SageMaker 图片：镜** SageMaker 像是一组基于 Docker 镜像的 SageMaker AI 镜像版本的持有者。每个映像版本都是不可变的。
+ **镜像版本：**镜像版本代表一个 Docker SageMaker 镜像，存储在 Amazon ECR 存储库中。每个映像版本都是不可变的。这些映像版本可以附加到一个域或共享空间，并在 Studio Classic 中使用。

**Topics**
+ [关键术语](#studio-byoi-basics)
+ [亚马逊 SageMaker Studio 经典版的自定义 SageMaker 图片规格](studio-byoi-specs.md)
+ [亚马逊 SageMaker Studio 经典版中自定义图片的先决条件](studio-byoi-prereq.md)
+ [向亚马逊 ECR 添加兼容亚马逊 SageMaker Studio Classic 的 Docker 镜像](studio-byoi-sdk-add-container-image.md)
+ [为 Amazon SageMaker Studio Classic 创建自定义 SageMaker 图片](studio-byoi-create.md)
+ [在 Amazon SageMaker Studio 经典版中附加自定义 SageMaker 图片](studio-byoi-attach.md)
+ [在 Amazon SageMaker Studio 经典版中启动自定义 SageMaker 图片](studio-byoi-launch.md)
+ [清理 Amazon SageMaker Studio Classic 中自定义图片的资源](studio-byoi-cleanup.md)