设置默认周期配置 - Amazon SageMaker
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

设置默认周期配置

要以编程方式将生命周期配置设置为域或 UserProfile 的默认配置，您可以创建新资源或更新现有资源。要将生命周期配置关联为默认值，首先需要按照中的步骤创建生命周期配置创建和关联生命周期配置. 在域级别设置的默认生命周期配置由所有用户继承，而在用户级别设置的默认生命周期配置则限定为特定用户。

注意

用户级别默认值将覆盖在域级别设置的默认值。

要设置默认的生命周期配置，必须将其添加到DefaultResourceSpec适当的应用程序类型。生命周期配置的行为取决于是否将其添加到DefaultResourceSpec的 JupyterServer 要么 KernelGateway 应用程序。

  • jupyterServer 应用程序：当添加到DefaultResourceSpec的 JupyterServer 应用程序，当用户首次登录 Studio 或重新启动 Studio 时，默认的生命周期配置脚本将自动运行。这可用于为 Studio 开发人员环境自动执行一次性设置操作，例如安装笔记本扩展程序或设置 GitHub 存储库。有关此示例，请参阅定制亚马逊 SageMaker Studio 使用生命周期配置.

  • KernelGateway 应用程序：当添加到DefaultResourceSpec的 KernelGateway app，Studio 默认为从 Studio 启动器中选择生命周期配置脚本。用户可以在选择默认脚本的情况下启动笔记本或终端，也可以从生命周期配置列表中选择其他脚本。

注意

一个默认 KernelGateway 在中指定的生命周期DefaultResourceSpec适用于所有 KernelGateway 除非用户从 Studio 启动器中显示的列表中选择了不同的脚本，否则 Studio Domain 中的映像。默认脚本也会运行No Script是由用户选择的。有关如何选择脚本的更多信息，请参阅第 3 步：启动新应用程序时选择生命周期配置.

在创建新域或 UserProfile 时关联默认的生命周期配置

要在创建新的 Studio 域或 UserProfile 时关联生命周期配置，您需要创建的生命周期配置的 ARN。此 ARN 传递给以下 API 调用之一：

例如，以下 API 调用创建了一个新的 UserProfile 使用关联的生命周期配置。

aws sagemaker create-user-profile --domain-id <DOMAIN-ID> \
--user-profile-name <USER-PROFILE-NAME> \
--region <REGION> \
--user-settings '{
"KernelGatewayAppSettings": {
    "DefaultResourceSpec": { 
            "InstanceType": "ml.t3.medium",
            "LifecycleConfigArn": "<LIFECYCLE-CONFIGURATION-ARN>"
         }
  }
}'

更新域或用户配置文件时关联默认的生命周期配置

要在更新现有 Studio 域或 UserProfile 时关联生命周期配置，您需要创建的生命周期配置的 ARN。此 ARN 传递给以下 API 调用之一：

生命周期配置 ARN 应放在两个位置，DefaultResourceSpec和LifecycleConfigArns在中列出KernelGatewayAppSettings. 例如，以下 API 调用更新了 UserProfile 使用关联的生命周期配置。

aws sagemaker update-user-profile --domain-id <DOMAIN-ID> \
--user-profile-name <USER-PROFILE-NAME> \
--region <REGION> \
--user-settings '{
"KernelGatewayAppSettings": {
    "DefaultResourceSpec": {
            "InstanceType": "ml.t3.medium",
            "LifecycleConfigArn": "<LIFECYCLE-CONFIGURATION-ARN>"
         }
  }
}'