从 SageMaker控制台创建生命周期配置 - Amazon SageMaker
先决条件 步骤 1：创建新的生命周期配置步骤 2：附加生命周期配置步骤 3：使用生命周期配置启动应用程序步骤 4：查看生命周期配置的日志
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

从 SageMaker控制台创建生命周期配置

重要

允许 Amazon SageMaker Studio 或 Amazon SageMaker Studio Classic 创建亚马逊 SageMaker资源的自定义 IAM 策略还必须授予向这些资源添加标签的权限。需要向资源添加标签的权限，因为 Studio 和 Studio Classic 会自动标记他们创建的任何资源。如果 IAM 策略允许 Studio 和 Studio Classic 创建资源但不允许标记，则在尝试创建资源时可能会出现 AccessDenied “” 错误。有关更多信息，请参阅 提供为资源添加标签 SageMaker的权限。

Amazon 适用于亚马逊的托管政策 SageMaker授予创建 SageMaker 资源的权限已经包括在创建这些资源时添加标签的权限。

重要

截至 2023 年 11 月 30 日，之前的亚马逊 SageMaker Studio 体验现在被命名为 Amazon St SageMaker udio Classic。以下部分专门介绍如何使用 Studio Classic 应用程序。有关使用更新后的 Studio 体验的信息，请参阅亚马逊 SageMaker Studio。

以下主题介绍如何通过 Amazon SageMaker 控制台创建生命周期配置，以自动对 Studio Classic 环境进行自定义。

先决条件

在开始本教程之前，请满足以下先决条件：

步骤 1：创建新的生命周期配置

您可以通过从 Amazon SageMaker 控制台输入脚本来创建生命周期配置。

注意

每个脚本最多可以包含 16384 个字符。

以下过程演示如何创建打印 Hello World 的生命周期配置脚本。

  1. 打开亚马逊 SageMaker 控制台，网址为 https://console.aws.amazon.com/sagemaker/。

  2. 在左侧导航窗格中，选择管理员配置。

  3. 在管理员配置下，选择生命周期配置。

  4. 选择 Studio 选项卡。

  5. 选择创建配置。

  6. 在选择配置类型下，选择生命周期配置应附加到的应用程序的类型。有关选择将生命周期配置附加到哪个应用程序的更多信息，请参阅 设置默认生命周期配置。

  7. 选择下一步。

  8. 在名为配置设置的部分中，输入生命周期配置的名称。

  9. 在脚本部分中，输入以下内容。

    #!/bin/bash
set -eux
echo 'Hello World!'

  10. （可选）为您的生命周期配置创建标签。

  11. 选择提交。

步骤 2：将生命周期配置附加到域或用户配置文件

在域级别关联的生命周期配置脚本由所有用户继承。但是，在用户配置文件级别关联的脚本的作用域限定为特定用户。

您可以将多个生命周期配置附加到域名或用户配置文件 JupyterServer 和 KernelGateway 应用程序的用户配置文件中。

注意

要将生命周期配置附加到共享空间，必须使用 Amazon CLI。有关更多信息，请参阅 通过 Amazon CLI创建生命周期配置。

下面几节将介绍如何将生命周期配置附加到域或用户配置文件。

附加到域

以下内容显示了如何通过 SageMaker 控制台将生命周期配置附加到现有域中。

  1. 打开亚马逊 SageMaker 控制台，网址为 https://console.aws.amazon.com/sagemaker/。

  2. 在左侧导航窗格中，选择管理员配置。

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

  4. 从域列表中，选择要将生命周期配置附加到的域。

  5. 在域详细信息页面上，选择环境选项卡。

  6. 在个人 Studio 应用程序的生命周期配置下，选择附加。

  7. 在来源下，选择现有配置。

  8. 在 Studio 生命周期配置下，选择在上一步中创建的生命周期配置。

  9. 选择附加到域。

附加到用户配置文件

下面显示如何将生命周期配置附加到现有用户配置文件。

  1. 打开亚马逊 SageMaker 控制台，网址为 https://console.aws.amazon.com/sagemaker/。

  2. 在左侧导航窗格中，选择管理员配置。

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

  4. 从域列表中，选择包含要附加生命周期配置的用户配置文件的域。

  5. 在用户配置文件下，选择用户配置文件。

  6. 在用户详细信息页面上，选择编辑。

  7. 在左侧导航中，选择 Studio 设置。

  8. 在附加到用户的生命周期配置下，选择附加。

  9. 在来源下，选择现有配置。

  10. 在 Studio 生命周期配置下，选择在上一步中创建的生命周期配置。

  11. 选择附加到用户配置文件。

步骤 3：使用生命周期配置启动应用程序

将生命周期配置附加到域或用户配置文件之后，您可以使用附加的生命周期配置启动应用程序。选择使用哪种生命周期配置启动取决于应用程序类型。

  • JupyterServer：从控制台启动 JupyterServer应用程序时， SageMaker 始终使用默认的生命周期配置。从控制台启动时，不能使用不同的生命周期配置。有关在启动 JupyterServer 应用程序后更改默认生命周期配置的信息，请参阅设置默认生命周期配置。

    要选择其他附加的生命周期配置，必须使用 Amazon CLI启动。有关从中启动带有附加生命周期配置的 JupyterServer 应用程序的更多信息 Amazon CLI，请参阅通过 Amazon CLI创建生命周期配置。

  • KernelGateway：使用 Studio Classic Launcher 启动 KernelGateway 应用程序时，您可以选择任何附加的生命周期配置。

以下过程介绍如何从 SageMaker 控制台启动附加了生命周期配置的 KernelGateway 应用程序。

  1. 打开亚马逊 SageMaker 控制台，网址为 https://console.aws.amazon.com/sagemaker/。

  2. 启动 Studio 经典版。有关更多信息，请参阅 推出亚马逊 SageMaker Studio 经典版。

  3. 在 Studio 经典版用户界面中，打开 Studio Classic 有关更多信息，请参阅 使用 Amazon SageMaker Studio 经典启动器。

  4. 在 Studio Classic 启动器中，导航到笔记本和计算资源部分。

  5. 单击更改环境按钮。

  6. 在更改环境对话框中，使用下拉菜单选择映像、内核、实例类型和启动脚本。如果没有默认生命周期配置，则启动脚本值默认为 No script。否则，启动脚本值就是您的默认生命周期配置。选择生命周期配置后，可以查看整个脚本。

  7. 单击选择。

  8. 返回至启动程序，单击创建笔记本，使用所选映像和生命周期配置启动新的笔记本内核。

步骤 4：查看生命周期配置的日志

您可以在生命周期配置附加到域或用户配置文件后查看其日志。

  1. 首先， CloudWatch 为您的 Amazon Identity and Access Management (IAM) 角色提供访问权限。添加对以下日志组和日志流的读取权限。

    • 日志组：/aws/sagemaker/studio

    • 日志流：domain/user-profile/app-type/app-name/LifecycleConfigOnStart

    有关添加权限的信息，请参阅启用某些 Amazon 服务的日志记录。

  2. 在 Studio Classic 中，导航到 “正在运行的终端和内核 ” 图标以监控您的生命周期配置。

  3. 从正在运行的应用程序列表中选择一个应用程序。附加生命周期配置的应用程序有一个附加指示图标 。

  4. 选择应用程序的指示图标。这将打开一个新的面板，其中列出了生命周期配置。

  5. 在新面板中，选择 View logs。这将打开一个显示日志的新选项卡。