本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
从 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 环境进行自定义。
先决条件
在开始本教程之前,请满足以下先决条件:
-
登上亚马逊 SageMaker Studio 经典版。有关更多信息,请参阅 “登录 Amazon SageMaker Studio 经典版”。
步骤 1:创建新的生命周期配置
您可以通过从 Amazon SageMaker 控制台输入脚本来创建生命周期配置。
注意
每个脚本最多可以包含 16384 个字符。
以下过程演示如何创建打印 Hello World
的生命周期配置脚本。
打开亚马逊 SageMaker 控制台,网址为https://console.aws.amazon.com/sagemaker/
。 -
在左侧导航窗格中,选择管理员配置。
-
在管理员配置下,选择生命周期配置。
-
选择 Studio 选项卡。
-
选择创建配置。
-
在选择配置类型下,选择生命周期配置应附加到的应用程序的类型。有关选择将生命周期配置附加到哪个应用程序的更多信息,请参阅 设置默认生命周期配置。
-
选择下一步。
-
在名为配置设置的部分中,输入生命周期配置的名称。
-
在脚本部分中,输入以下内容。
#!/bin/bash set -eux echo 'Hello World!'
-
(可选)为您的生命周期配置创建标签。
-
选择提交。
步骤 2:将生命周期配置附加到域或用户配置文件
在域级别关联的生命周期配置脚本由所有用户继承。但是,在用户配置文件级别关联的脚本的作用域限定为特定用户。
您可以将多个生命周期配置附加到域名或用户配置文件 JupyterServer 和 KernelGateway 应用程序的用户配置文件中。
注意
要将生命周期配置附加到共享空间,必须使用 Amazon CLI。有关更多信息,请参阅 通过 Amazon CLI创建生命周期配置。
下面几节将介绍如何将生命周期配置附加到域或用户配置文件。
附加到域
以下内容显示了如何通过 SageMaker 控制台将生命周期配置附加到现有域中。
打开亚马逊 SageMaker 控制台,网址为https://console.aws.amazon.com/sagemaker/
。 -
在左侧导航窗格中,选择管理员配置。
-
在管理员配置下,选择域。
-
从域列表中,选择要将生命周期配置附加到的域。
-
在域详细信息页面上,选择环境选项卡。
-
在个人 Studio 应用程序的生命周期配置下,选择附加。
-
在来源下,选择现有配置。
-
在 Studio 生命周期配置下,选择在上一步中创建的生命周期配置。
-
选择附加到域。
附加到用户配置文件
下面显示如何将生命周期配置附加到现有用户配置文件。
打开亚马逊 SageMaker 控制台,网址为https://console.aws.amazon.com/sagemaker/
。 -
在左侧导航窗格中,选择管理员配置。
-
在管理员配置下,选择域。
-
从域列表中,选择包含要附加生命周期配置的用户配置文件的域。
-
在用户配置文件下,选择用户配置文件。
-
在用户详细信息页面上,选择编辑。
-
在左侧导航中,选择 Studio 设置。
-
在附加到用户的生命周期配置下,选择附加。
-
在来源下,选择现有配置。
-
在 Studio 生命周期配置下,选择在上一步中创建的生命周期配置。
-
选择附加到用户配置文件。
步骤 3:使用生命周期配置启动应用程序
将生命周期配置附加到域或用户配置文件之后,您可以使用附加的生命周期配置启动应用程序。选择使用哪种生命周期配置启动取决于应用程序类型。
-
JupyterServer:从控制台启动 JupyterServer应用程序时, SageMaker 始终使用默认的生命周期配置。从控制台启动时,不能使用不同的生命周期配置。有关在启动 JupyterServer 应用程序后更改默认生命周期配置的信息,请参阅设置默认生命周期配置。
要选择其他附加的生命周期配置,必须使用 Amazon CLI启动。有关从中启动带有附加生命周期配置的 JupyterServer 应用程序的更多信息 Amazon CLI,请参阅通过 Amazon CLI创建生命周期配置。
-
KernelGateway:使用 Studio Classic Launcher 启动 KernelGateway 应用程序时,您可以选择任何附加的生命周期配置。
以下过程介绍如何从 SageMaker 控制台启动附加了生命周期配置的 KernelGateway 应用程序。
打开亚马逊 SageMaker 控制台,网址为https://console.aws.amazon.com/sagemaker/
。 -
启动 Studio 经典版。有关更多信息,请参阅 推出亚马逊 SageMaker Studio 经典版。
-
在 Studio 经典版用户界面中,打开 Studio Classic 有关更多信息,请参阅 使用 Amazon SageMaker Studio 经典启动器。
-
在 Studio Classic 启动器中,导航到 “笔记本和计算资源” 部分。
-
单击更改环境按钮。
-
在更改环境对话框中,使用下拉菜单选择映像、内核、实例类型和启动脚本。如果没有默认生命周期配置,则启动脚本值默认为
No script
。否则,启动脚本值就是您的默认生命周期配置。选择生命周期配置后,可以查看整个脚本。 -
单击选择。
-
返回至启动程序,单击创建笔记本,使用所选映像和生命周期配置启动新的笔记本内核。
步骤 4:查看生命周期配置的日志
您可以在生命周期配置附加到域或用户配置文件后查看其日志。
-
首先, CloudWatch 为你的 Amazon Identity and Access Management (IAM) 角色提供对的访问权限。添加对以下日志组和日志流的读取权限。
日志组:
/aws/sagemaker/studio
日志流:
domain
/user-profile
/app-type
/app-name
/LifecycleConfigOnStart
有关添加权限的信息,请参阅启用某些 Amazon 服务的日志记录。
-
在 Studio Classic 中,导航到 “正在运行的终端和内核” 图标 ( ) 以监控您的生命周期配置。
-
从正在运行的应用程序列表中选择一个应用程序。附加生命周期配置的应用程序有一个附加指示图标 。
-
选择应用程序的指示图标。这将打开一个新的面板,其中列出了生命周期配置。
-
在新面板中,选择
View logs
。这将打开一个显示日志的新选项卡。