生命周期配置创建
本主题包括创建生命周期配置并将其与 JupyterLab 关联的说明。您可以使用 AWS Command Line Interface (AWS CLI) 或 AWS Management Console 自动自定义 JupyterLab 环境。
生命周期配置是由 JupyterLab 生命周期事件(例如启动新的 JupyterLab 笔记本)触发的 shell 脚本。有关生命周期配置的更多信息,请参阅使用 JupyterLab 进行生命周期配置。
创建生命周期配置 (AWS CLI)
了解如何使用 AWS Command Line Interface (AWS CLI) 创建生命周期配置,以便自动自定义您的 Studio 环境。
先决条件
在开始之前,请满足以下先决条件:
-
按照安装最新 AWS CLI 版本中的步骤更新 AWS CLI。
-
在本地计算机上运行
aws configure
并提供您的 AWS 凭证。有关 AWS 凭证的信息,请参阅了解并获取您的 AWS 凭证。 -
加入 Amazon SageMaker 域。有关概念性信息,请参阅 Amazon SageMaker 域概述。有关快速入门指南,请参阅 使用 Amazon SageMaker 的快速设置功能。
步骤 1:创建生命周期配置
以下过程演示如何创建打印 Hello World
的生命周期配置脚本。
注意
每个脚本最多可以包含 16384 个字符。
-
在本地计算机上,创建一个名为
my-script.sh
的文件,内容如下:#!/bin/bash set -eux echo 'Hello World!'
-
使用以下方法将
my-script.sh
文件转换为 base64 格式。此要求可防止因空格和换行编码而出现错误。LCC_CONTENT=`openssl base64 -A -in my-script.sh`
-
创建用于 Studio 的生命周期配置。下面的命令创建一个生命周期配置,该配置在启动关联的
JupyterLab
应用程序时运行:aws sagemaker create-studio-lifecycle-config \ --region
region
\ --studio-lifecycle-config-namemy-jl-lcc
\ --studio-lifecycle-config-content $LCC_CONTENT \ --studio-lifecycle-config-app-type JupyterLab请记录为新创建的生命周期配置返回的 ARN。将生命周期配置附加到应用程序时需要此 ARN。
步骤 2:将生命周期配置附加到 Amazon SageMaker 域(域)或用户配置文件
要附加生命周期配置,必须更新域的 UserSettings
或用户配置文件。在域级别关联的生命周期配置脚本由所有用户继承。但是,在用户配置文件级别关联的脚本的作用域限定为特定用户。
您可以使用以下命令创建附加生命周期配置的新用户配置文件、域或空间:
下面的命令创建了一个具有生命周期配置的用户配置文件。将上一步中的生命周期配置 ARN 添加到用户的 JupyterLabAppSettings
中。您可以通过传递列表同时添加多个生命周期配置。当用户使用 AWS CLI 启动 JupyterLab 应用程序时,他们可以指定生命周期配置,而不是使用默认配置。用户传递的生命周期配置必须属于 JupyterLabAppSettings
中的生命周期配置列表。
# Create a new UserProfile aws sagemaker create-user-profile --domain-id
domain-id
\ --user-profile-nameuser-profile-name
\ --regionregion
\ --user-settings '{ "JupyterLabAppSettings": { "LifecycleConfigArns": [lifecycle-configuration-arn-list
] } }'
创建生命周期配置(管理控制台)
了解如何使用 AWS Management Console 创建生命周期配置,以便自动自定义您的 Studio 环境。
步骤 1:创建生命周期配置
使用以下过程创建打印 Hello World
的生命周期配置脚本。
创建生命周期配置
通过 https://console.aws.amazon.com/sagemaker/
打开 Amazon SageMaker 管理控制台。 -
在左侧导航窗格中,选择管理员配置。
-
在管理员配置下,选择生命周期配置。
-
选择 JupyterLab 选项卡。
-
选择创建配置。
-
在名称中,指定生命周期配置的名称。
-
在脚本下的文本框中,指定以下生命周期配置:
#!/bin/bash set -eux echo 'Hello World!'
-
选择创建配置。
步骤 2:将生命周期配置附加到 Amazon SageMaker 域(域)或用户配置文件
在域级别关联的生命周期配置脚本由所有用户继承。但是,在用户配置文件级别关联的脚本的作用域限定为特定用户。
您可以为 JupyterLab 的域或用户配置文件附加多个生命周期配置。
使用以下步骤将生命周期配置附加到域。
将生命周期配置附加到域
通过 https://console.aws.amazon.com/sagemaker/
打开 Amazon SageMaker 管理控制台。 -
在左侧导航窗格中,选择管理员配置。
-
在管理员配置下,选择域。
-
从域列表中,选择要将生命周期配置附加到的域。
-
在域详细信息页面上,选择环境选项卡。
-
在个人 Studio 应用程序的生命周期配置下,选择附加。
-
在来源下,选择现有配置。
-
在 Studio 生命周期配置下,选择在上一步中创建的生命周期配置。
-
选择附加到域。
使用以下步骤将生命周期配置附加到用户配置文件。
将生命周期配置附加到用户配置文件
通过 https://console.aws.amazon.com/sagemaker/
打开 Amazon SageMaker 管理控制台。 -
在左侧导航窗格中,选择管理员配置。
-
在管理员配置下,选择域。
-
从域列表中,选择包含要附加生命周期配置的用户配置文件的域。
-
在用户配置文件下,选择用户配置文件。
-
在用户详细信息页面上,选择编辑。
-
在左侧导航中,选择 Studio 设置。
-
在附加到用户的生命周期配置下,选择附加。
-
在来源下,选择现有配置。
-
在 Studio 生命周期配置下,选择在上一步中创建的生命周期配置。
-
选择附加到用户配置文件。