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

# 从 SageMaker AI 控制台为 Amazon SageMaker Studio Classic 创建生命周期配置
<a name="studio-lcc-create-console"></a>

**重要**  
允许 Amazon SageMaker Studio 或 Amazon SageMaker Studio Classic 创建亚马逊 SageMaker资源的自定义 IAM 策略还必须授予向这些资源添加标签的权限。之所以需要为资源添加标签的权限，是因为 Studio 和 Studio Classic 会自动为创建的任何资源添加标签。如果 IAM 策略允许 Studio 和 Studio Classic 创建资源但不允许标记，则在尝试创建资源时可能会出现 AccessDenied “” 错误。有关更多信息，请参阅 [提供标记 A SageMaker I 资源的权限](security_iam_id-based-policy-examples.md#grant-tagging-permissions)。  
[AWS 亚马逊 A SageMaker I 的托管策略](security-iam-awsmanpol.md)授予创建 SageMaker 资源的权限已经包括在创建这些资源时添加标签的权限。

**重要**  
截至 2023 年 11 月 30 日，之前的亚马逊 SageMaker Studio 体验现在被命名为 Amazon St SageMaker udio Classic。以下部分专门介绍如何使用 Studio Classic 应用程序。有关使用更新的 Studio 体验的信息，请参阅 [亚马逊 SageMaker Studio](studio-updated.md)。  
Studio Classic 仍针对现有工作负载进行维护，但不再可供入门使用。您只能停止或删除现有的 Studio Classic 应用程序，不能创建新的应用程序。我们建议您将[工作负载迁移到全新 Studio 体验](studio-updated-migrate.md)。

以下主题介绍如何从 Amazon A SageMaker I 控制台创建生命周期配置，以自动对 Studio Classic 环境进行自定义。

## 先决条件
<a name="studio-lcc-create-console-prerequisites"></a>

在开始本教程之前，请满足以下先决条件：
+ 登上亚马逊 SageMaker Studio 经典版。有关更多信息，请参阅 “[登录 Amazon SageMaker Studio 经典版](https://docs.aws.amazon.com/sagemaker/latest/dg/gs-studio-onboard.html)”。

## 步骤 1：创建新的生命周期配置
<a name="studio-lcc-create-console-step1"></a>

您可以通过从 Amazon A SageMaker I 控制台输入脚本来创建生命周期配置。

**注意**  
每个脚本最多可以包含 **16384 个字符**。

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

1. 打开 Amazon A SageMaker I 控制台，网址为[https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)。

1. 在左侧导航窗格中，选择**管理员配置**。

1. 在**管理员配置**下，选择**生命周期配置**。

1. 选择 **Studio** 选项卡。

1. 选择**创建配置**。

1. 在**选择配置类型**下，选择生命周期配置应附加到的应用程序的类型。有关选择将生命周期配置附加到哪个应用程序的更多信息，请参阅 [为 Amazon SageMaker Studio 经典版设置默认生命周期配置](studio-lcc-defaults.md)。

1. 选择**下一步**。

1. 在名为**配置设置**的部分中，输入生命周期配置的名称。

1. 在**脚本**部分中，输入以下内容。

   ```
   #!/bin/bash
   set -eux
   echo 'Hello World!'
   ```

1. （可选）为您的生命周期配置创建标签。

1. 选择**提交**。

## 步骤 2：将生命周期配置附加到域或用户配置文件
<a name="studio-lcc-create-console-step2"></a>

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

您可以将多个生命周期配置附加到域名或用户配置文件 JupyterServer 和 KernelGateway 应用程序的用户配置文件中。

**注意**  
要将生命周期配置附加到共享空间，必须使用 AWS CLI。有关更多信息，请参阅 [使用 AWS CLI 适用于 Amazon SageMaker Studio 的经典版创建生命周期配置](studio-lcc-create-cli.md)。

下面几节将介绍如何将生命周期配置附加到域或用户配置文件。

### 附加到域
<a name="studio-lcc-create-console-step2-domain"></a>

以下内容显示了如何从 SageMaker AI 控制台将生命周期配置附加到现有域。

1. 打开 Amazon A SageMaker I 控制台，网址为[https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)。

1. 在左侧导航窗格中，选择**管理员配置**。

1. 在**管理员配置**下，选择**域**。

1. 从域列表中，选择要将生命周期配置附加到的域。

1. 在**域详细信息**页面上，选择**环境**选项卡。

1. 在**个人 Studio 应用程序的生命周期配置**下，选择**附加**。

1. 在**来源**下，选择**现有配置**。

1. 在 **Studio 生命周期配置**下，选择在上一步中创建的生命周期配置。

1. 选择**附加到域**。

### 附加到用户配置文件
<a name="studio-lcc-create-console-step2-userprofile"></a>

下面显示如何将生命周期配置附加到现有用户配置文件。

1. 打开 Amazon A SageMaker I 控制台，网址为[https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)。

1. 在左侧导航窗格中，选择**管理员配置**。

1. 在**管理员配置**下，选择**域**。

1. 从域列表中，选择包含要附加生命周期配置的用户配置文件的域。

1. 在**用户配置文件**下，选择用户配置文件。

1. 在**用户详细信息**页面上，选择**编辑**。

1. 在左侧导航中，选择 **Studio 设置**。

1. 在**附加到用户的生命周期配置**下，选择**附加**。

1. 在**来源**下，选择**现有配置**。

1. 在 **Studio 生命周期配置**下，选择在上一步中创建的生命周期配置。

1. 选择**附加到用户配置文件**。

## 步骤 3：使用生命周期配置启动应用程序
<a name="studio-lcc-create-console-step3"></a>

将生命周期配置附加到域或用户配置文件之后，您可以使用附加的生命周期配置启动应用程序。选择使用哪种生命周期配置启动取决于应用程序类型。
+ **JupyterServer**：从控制台启动 JupyterServer应用程序时， SageMaker AI 始终使用默认的生命周期配置。从控制台启动时，不能使用不同的生命周期配置。有关在启动 JupyterServer 应用程序后更改默认生命周期配置的信息，请参阅[为 Amazon SageMaker Studio 经典版设置默认生命周期配置](studio-lcc-defaults.md)。

  要选择其他附加的生命周期配置，必须使用 AWS CLI启动。有关从中启动带有附加生命周期配置的 JupyterServer 应用程序的更多信息 AWS CLI，请参阅[使用 AWS CLI 适用于 Amazon SageMaker Studio 的经典版创建生命周期配置](studio-lcc-create-cli.md)。
+ **KernelGateway**：使用 Studio Classic Launcher 启动 KernelGateway 应用程序时，您可以选择任何附加的生命周期配置。

以下过程介绍如何从 SageMaker AI 控制台启动附加了生命周期配置的 KernelGateway 应用程序。

1. 打开 Amazon A SageMaker I 控制台，网址为[https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)。

1. 启动 Studio Classic。有关更多信息，请参阅 [推出亚马逊 SageMaker Studio 经典版](studio-launch.md)。

1. 在 Studio Classic UI 中，打开 Studio Classic 启动程序。有关更多信息，请参阅 [使用 Amazon SageMaker Studio 经典启动器](studio-launcher.md)。

1. 在 Studio Classic 启动程序中，导航到**笔记本和计算资源**部分。

1. 单击**更改环境**按钮。

1. 在**更改环境**对话框中，使用下拉菜单选择**映像**、**内核**、**实例类型**和**启动脚本**。如果没有默认生命周期配置，则**启动脚本**值默认为 `No script`。否则，**启动脚本**值就是您的默认生命周期配置。选择生命周期配置后，可以查看整个脚本。

1. 单击**选择**。

1. 返回至启动程序，单击**创建笔记本**，使用所选映像和生命周期配置启动新的笔记本内核。

## 步骤 4：查看生命周期配置的日志
<a name="studio-lcc-create-console-step4"></a>

您可以在生命周期配置附加到域或用户配置文件后查看其日志。

1. 首先， CloudWatch 为您的 AWS Identity and Access Management (IAM) 角色提供访问权限。添加对以下日志组和日志流的读取权限。
   + **日志组：**`/aws/sagemaker/studio`
   + **日志流：**`domain/user-profile/app-type/app-name/LifecycleConfigOnStart`

    有关添加权限的信息，请参阅[启用某些 AWS 服务的日志记录](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html)。

1. 在 Studio Classic 中，导航到**运行的终端和内核**图标 (![\[Black square icon representing a placeholder or empty image.\]](http://docs.aws.amazon.com/zh_cn/sagemaker/latest/dg/images/studio/icons/running-terminals-kernels.png)) 以监控您的生命周期配置。

1. 从正在运行的应用程序列表中选择一个应用程序。附加生命周期配置的应用程序有一个附加指示图标 ![\[Code brackets symbol representing programming or markup languages.\]](http://docs.aws.amazon.com/zh_cn/sagemaker/latest/dg/images/studio/studio-lcc-indicator-icon.png)。

1. 选择应用程序的指示图标。这将打开一个新的面板，其中列出了生命周期配置。

1. 在新面板中，选择 `View logs`。这将打开一个显示日志的新选项卡。