设置默认周期配置 - 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 应放在两个位置,DefaultResourceSpecLifecycleConfigArns在中列出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>" } } }'