生命周期配置创建 - Amazon SageMaker

生命周期配置创建

本主题包括创建生命周期配置并将其与 JupyterLab 关联的说明。您可以使用 AWS Command Line Interface (AWS CLI) 或 AWS Management Console 自动自定义 JupyterLab 环境。

生命周期配置是由 JupyterLab 生命周期事件(例如启动新的 JupyterLab 笔记本)触发的 shell 脚本。有关生命周期配置的更多信息,请参阅使用 JupyterLab 进行生命周期配置

创建生命周期配置 (AWS CLI)

了解如何使用 AWS Command Line Interface (AWS CLI) 创建生命周期配置,以便自动自定义您的 Studio 环境。

先决条件

在开始之前,请满足以下先决条件:

步骤 1:创建生命周期配置

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

注意

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

  1. 在本地计算机上,创建一个名为 my-script.sh 的文件,内容如下:

    #!/bin/bash set -eux echo 'Hello World!'
  2. 使用以下方法将 my-script.sh 文件转换为 base64 格式。此要求可防止因空格和换行编码而出现错误。

    LCC_CONTENT=`openssl base64 -A -in my-script.sh`
  3. 创建用于 Studio 的生命周期配置。下面的命令创建一个生命周期配置,该配置在启动关联的 JupyterLab 应用程序时运行:

    aws sagemaker create-studio-lifecycle-config \ --region region \ --studio-lifecycle-config-name my-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-name user-profile-name \ --region region \ --user-settings '{ "JupyterLabAppSettings": { "LifecycleConfigArns": [lifecycle-configuration-arn-list] } }'

创建生命周期配置(管理控制台)

了解如何使用 AWS Management Console 创建生命周期配置,以便自动自定义您的 Studio 环境。

步骤 1:创建生命周期配置

使用以下过程创建打印 Hello World 的生命周期配置脚本。

创建生命周期配置
  1. 通过 https://console.aws.amazon.com/sagemaker/ 打开 Amazon SageMaker 管理控制台。

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

  3. 管理员配置下,选择生命周期配置

  4. 选择 JupyterLab 选项卡。

  5. 选择创建配置

  6. 名称中,指定生命周期配置的名称。

  7. 脚本下的文本框中,指定以下生命周期配置:

    #!/bin/bash set -eux echo 'Hello World!'
  8. 选择创建配置

步骤 2:将生命周期配置附加到 Amazon SageMaker 域(域)或用户配置文件

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

您可以为 JupyterLab 的域或用户配置文件附加多个生命周期配置。

使用以下步骤将生命周期配置附加到域。

将生命周期配置附加到域
  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. 选择附加到用户配置文件