本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 生命週期組態建立
本主題包含建立生命週期組態並將其與 JupyterLab 建立關聯的指示。您可以使用 AWS Command Line Interface (AWS CLI) 或 AWS 管理主控台 來自動化 JupyterLab 環境的自訂。
生命週期組態是由 JupyterLab 生命週期事件觸發的 Shell 指令碼，例如啟動新的 JupyterLab 筆記本。如需生命週期組態的更多相關資訊，請參閱[搭配 JupyterLab 的生命週期組態](jl-lcc.md)。
## 建立生命週期組態 (AWS CLI)
了解如何使用 AWS Command Line Interface (AWS CLI) 建立生命週期組態，以自動化 Studio 環境的自訂。
### 先決條件
開始之前，請先完成以下先決條件：
+ 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 網域。如需相關概念資訊，請參閱 [Amazon SageMaker AI 網域概觀](gs-studio-onboard.md)。如需快速入門指南，請參閱 [使用 Amazon SageMaker AI 的快速設定](onboard-quick-start.md)。
### 步驟 1：建立生命週期組態
下列程序示範如何建立 `Hello World` 生命週期組態指令碼。
**注意**
每個指令碼最多可以有 **16,384** 個字元。
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 網域 (網域) 和使用者設定檔
若要連接生命週期組態，您必須針對網域或使用者設定檔更新 `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]
}
}'
```
## 建立生命週期組態 (主控台)
了解如何使用 建立生命週期組態 AWS 管理主控台 ，以自動化 Studio 環境的自訂。
### 步驟 1：建立生命週期組態
使用下列程序來建立一個列印 `Hello World` 的生命週期組態指令碼。
**建立生命週期組態**
1. 開啟 Amazon SageMaker AI 主控台，網址為 [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 網域 (網域) 和使用者設定檔
所有使用者都會繼承與網域層級相關聯的生命週期組態指令碼。但是，在使用者設定檔層級關聯的指令碼範圍是特定使用者。
您可以將多個生命週期組態連接至 JupyterLab 的網域或使用者設定檔。
使用下列程序將生命週期組態連接至網域。
**將生命週期組態連接至網域**
1. 開啟 Amazon SageMaker AI 主控台，網址為 [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)。
1. 在左側導覽窗格中，選擇**管理員組態**。
1. 在**管理員組態**下，選擇**網域**。
1. 從網域清單中，選取要連接生命週期組態的網域。
1. 從**網域詳細資料**中，選擇**環境**索引標籤。
1. 在**個人 Studio 應用程式的生命週期組態**下，選擇**連接**。
1. 在**來源**下，選擇**現有的組態**。
1. 在 **Studio 生命週期組態**下，選取您在上一個步驟中建立的生命週期組態。
1. 選取**連接至網域**。
使用下列程序將生命週期組態連接至使用者設定檔。
**將生命週期組態連接至使用者設定檔**
1. 開啟 Amazon SageMaker AI 主控台，網址為 [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)。
1. 在左側導覽窗格中，選擇**管理員組態**。
1. 在**管理員組態**下，選擇**網域**。
1. 從網域清單中，選取包含要連接生命週期組態之使用者設定檔的網域。
1. 在**使用者設定檔**下，選取使用者設定檔。
1. 在**使用者詳細資訊**頁面，選擇**編輯**。
1. 在左側導覽選擇 **Studio 設定**。
1. 在**連接至使用者的生命週期組態**下，選擇**連接**。
1. 在**來源**下，選擇**現有的組態**。
1. 在 **Studio 生命週期**組態下，選取您在上一個步驟中建立的生命週期組態。
1. 選擇**連接至使用者設定檔**。