从 SageMaker控制台创建生命周期配置 - Amazon SageMaker
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 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 中,导航到 “正在运行的终端和内核” 图标 ( Black square icon representing a placeholder or empty image. ) 以监控您的生命周期配置。

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

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

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