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

# 生命周期配置创建
<a name="jl-lcc-create"></a>

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

生命周期配置是由生命 JupyterLab 周期事件（例如启动新 JupyterLab 笔记本）触发的 shell 脚本。有关生命周期配置的更多信息，请参阅[生命周期配置 JupyterLab](jl-lcc.md)。

## 创建生命周期配置 (AWS CLI)
<a name="jl-lcc-create-cli"></a>

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

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

在开始之前，请满足以下先决条件：
+  AWS CLI 按照[安装当前 AWS CLI 版本中的步骤进行](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv1.html#install-tool-bundled)更新。
+ 在本地计算机上运行 `aws configure` 并提供您的 AWS 凭证。有关 AWS 证书的信息，请参阅[了解和获取您的 AWS 证书](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html)。
+ 登录 Amazon SageMaker AI 域名。有关概念性信息，请参阅 [亚马逊 SageMaker AI 域名概述](gs-studio-onboard.md)。有关快速入门指南，请参阅 [使用 Amazon A SageMaker I 的快速设置](onboard-quick-start.md)。

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

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

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

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

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

1. 使用以下方法将 `my-script.sh` 文件转换为 base64 格式。此要求可防止因空格和换行编码而出现错误。

   ```
   LCC_CONTENT=`openssl base64 -A -in my-script.sh`
   ```

1. 创建用于 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 AI 域（域）和用户个人资料
<a name="jl-lcc-create-cli-step2"></a>

要附加生命周期配置，必须更新域的 `UserSettings` 或用户配置文件。在域级别关联的生命周期配置脚本由所有用户继承。但是，在用户配置文件级别关联的脚本的作用域限定为特定用户。

您可以使用以下命令创建附加生命周期配置的新用户配置文件、域或空间：
+ [create-user-profile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/create-user-profile.html)
+ [create-domain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/create-domain.html)
+ [create-space](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/create-space.html)

下面的命令创建了一个具有生命周期配置的用户配置文件。将上一步中的生命周期配置 ARN 添加到用户的 `JupyterLabAppSettings` 中。您可以通过传递列表同时添加多个生命周期配置。当用户使用启动 JupyterLab 应用程序时 AWS CLI，他们可以指定生命周期配置，而不是使用默认配置。用户传递的生命周期配置必须属于 `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]
  }
}'
```

## 创建生命周期配置（管理控制台）
<a name="jl-lcc-create-console"></a>

了解如何使用创建生命周期配置，自动为您的 AWS 管理控制台 Studio 环境进行自定义。

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

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

**创建生命周期配置**

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

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

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

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

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

1. 在**名称**中，指定生命周期配置的名称。

1. 在**脚本**下的文本框中，指定以下生命周期配置：

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

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

### 第 2 步：将生命周期配置附加到您的 Amazon SageMaker AI 域（域）和用户个人资料
<a name="jl-lcc-create-console-step2"></a>

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

您可以将多个生命周期配置附加到域名或用户配置文件中 JupyterLab。

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

**将生命周期配置附加到域**

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. 选择**附加到域**。

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

**将生命周期配置附加到用户配置文件**

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. 选择**附加到用户配置文件**。