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

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

设置默认生命周期配置

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

注意

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

要设置默认的生命周期配置,必须将其添加到DefaultResourceSpec相关应用程序类型。生命周期配置的行为取决于是否将其添加到DefaultResourceSpec一个 JupyterServer 或内核网关应用程序。

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

  • 内核网关应用程序:当添加到DefaultResourceSpec,Studio 默认选择从 Studio 启动器中选择生命周期配置脚本。用户可以在选定默认脚本的情况下启动笔记本或终端,也可以从生命周期配置列表中选择不同的脚本。

注意

中指定的默认内核网关生命周期配置DefaultResourceSpec应用于 Studio 域中的所有 KernelGateway 映像,除非用户从 Studio 启动器中显示的列表中选择了不同的脚本。默认脚本也会运行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>" } } }'

更新域或 UserProfile 时关联默认生命周期配置

要在更新现有 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>" } } }'