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

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

下面的主题介绍如何从 Amazon SageMaker 控制台创建生命周期配置，以便自动自定义您的 Studio 环境。

先决条件

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

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

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

注意

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

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

  1. 通过 https://console.aws.amazon.com/sagemaker/ 打开 Amazon 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. 通过 https://console.aws.amazon.com/sagemaker/ 打开 Amazon SageMaker 控制台。

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

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

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

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

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

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

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

  9. 选择附加到域。

附加到用户配置文件

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

  1. 通过 https://console.aws.amazon.com/sagemaker/ 打开 Amazon SageMaker 控制台。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. 通过 https://console.aws.amazon.com/sagemaker/ 打开 Amazon SageMaker 控制台。

  2. 启动 Studio。有关更多信息，请参阅 启动 Amazon SageMaker Studio。

  3. 在 Studio UI 中，打开 Studio 启动程序。有关更多信息，请参阅 使用 Amazon SageMaker Studio 启动程序。

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

  5. 单击更改环境按钮。

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

  7. 单击选择。

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

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

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

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

    • 日志组：/aws/sagemaker/studio

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

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

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

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

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

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