本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 從 Amazon SageMaker Studio Classic 的 SageMaker AI 主控台建立生命週期組態
<a name="studio-lcc-create-console"></a>

**重要**  
允許 Amazon SageMaker Studio 或 Amazon SageMaker Studio Classic 建立 Amazon SageMaker 資源的自訂 IAM 政策也必須授與許可，才能將標籤新增至這些資源。需要將標籤新增至資源的許可，因為 Studio 和 Studio Classic 會自動標記它們建立的任何資源。如果 IAM 政策允許 Studio 和 Studio Classic 建立資源，但不允許標記，則在嘗試建立資源時可能會發生 "AccessDenied" 錯誤。如需詳細資訊，請參閱[提供標記 SageMaker AI 資源的許可](security_iam_id-based-policy-examples.md#grant-tagging-permissions)。  
提供許可來建立 SageMaker 資源的 [AWS Amazon SageMaker AI 的 受管政策](security-iam-awsmanpol.md) 已包含建立這些資源時新增標籤的許可。

**重要**  
自 2023 年 11 月 30 日起，先前的 Amazon SageMaker Studio 體驗現在命名為 Amazon SageMaker Studio Classic。下節專門介紹如何使用 Studio Classic 應用程式。如需使用已更新 Studio 體驗的資訊，請參閱 [Amazon SageMaker Studio](studio-updated.md)。  
Studio Classic 仍會針對現有工作負載進行維護，但無法再用於加入。您只能停止或刪除現有的 Studio Classic 應用程式，而且無法建立新的應用程式。我們建議您[將工作負載遷移至新的 Studio 體驗](studio-updated-migrate.md)。

以下主題說明如何從 Amazon SageMaker AI 主控台建立生命週期組態，以自動自訂您的 Studio Classic 環境。

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

開始本教學課程之前，你必須先完成下列先決條件：
+ 加入 Amazon SageMaker Studio Classic。如需詳細資訊，請參閱[加入 Amazon SageMaker Studio Classic](https://docs.aws.amazon.com/sagemaker/latest/dg/gs-studio-onboard.html)。

## 步驟 1：建立新生命週期組態
<a name="studio-lcc-create-console-step1"></a>

您可以從 Amazon SageMaker AI 主控台輸入指令碼來建立生命週期組態。

**注意**  
每個指令碼最多可以有 **16,384** 個字元。

下列程序示範如何建立列印 `Hello World` 生命週期組態指令碼。

1. 開啟 Amazon SageMaker AI 主控台，網址為 [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)。

1. 在左側導覽窗格中，選擇**管理員組態**。

1. 在**管理員組態**下，選擇**生命週期組態**。

1. 選擇 **Studio** 索引標籤。

1. 選擇**建立組態**。

1. 在**選取組態類型**下，選取應連接生命週期組態的應用程式類型。如需選取要連接生命週期組態之應用程式的更多資訊，請參閱[設定 Amazon SageMaker Studio Classic 的預設生命週期組態](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 Classic 的 建立生命週期組態](studio-lcc-create-cli.md)。

下列各節說明如何將生命週期組態連接至網域或使用者設定檔。

### 連接至網域
<a name="studio-lcc-create-console-step2-domain"></a>

以下說明如何從 SageMaker AI 主控台將生命週期組態連接至您的現有網域。

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. 選取**連接至網域**。

### 連接至您的使用者設定檔
<a name="studio-lcc-create-console-step2-userprofile"></a>

以下說明如何將生命週期組態連接至您現有的使用者設定檔。

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. 選擇**連接至使用者設定檔**。

## 步驟 3：使用生命週期組態啟動應用程式
<a name="studio-lcc-create-console-step3"></a>

將生命週期組態連接至網域或使用者設定檔後，您可以啟動具有該連接生命週期組態的應用程式。根據應用程式類型，選擇要啟動的生命週期組態。
+ **JupyterServer**：從主控台啟動 JupyterServer 應用程式時，SageMaker AI 一律會使用預設生命週期組態。從主控台啟動時，您無法使用不同的生命週期組態。如需有關在啟動 JupyterServer 應用程式之後變更預設生命週期組態的資訊，請參閱[設定 Amazon SageMaker Studio Classic 的預設生命週期組態](studio-lcc-defaults.md)。

  若要選取不同的連接生命週期組態，您必須使用 AWS CLI。如需從 啟動具有連接生命週期組態的 JupyterServer 應用程式的詳細資訊 AWS CLI，請參閱 [從 AWS CLI Amazon SageMaker Studio Classic 的 建立生命週期組態](studio-lcc-create-cli.md)。
+ **KernelGateway**：您可以在使用 Studio Classic 啟動器啟動 KernelGateway 應用程式時，選取任何連接的生命週期組態。

下列程序說明如何從 SageMaker AI 主控台透過連接的生命週期組態啟動 KernelGateway 應用程式。

1. 開啟 Amazon SageMaker AI 主控台，網址為 [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)。

1. 啟動 Studio Classic。如需詳細資訊，請參閱[啟動 Amazon SageMaker Studio Classic](studio-launch.md)。

1. 在 Studio Classic UI 中，開啟 Studio Classic 啟動器。如需詳細資訊，請參閱[使用 Amazon SageMaker Studio Classic 啟動器](studio-launcher.md)。

1. 在 Studio Classic 啟動器中，導覽至**筆記本和運算資源**區段。

1. 按一下**變更環境**按鈕。

1. 在**變更環境**對話方塊中，使用下拉式功能表選取**映像**、**核心**、**執行個體類型**和**啟動指令碼**。如果沒有預設生命週期組態，**啟動指令碼**值會預設為 `No script`。否則，**啟動指令碼**值就是您的預設生命週期組態。選取生命週期組態之後，就可以檢視整個命令檔。

1. 按一下**選取**。

1. 回到啟動器，按一下**建立筆記本**，以使用您選取的映像檔和生命週期組態啟動新的筆記本核心。

## 步驟 4：檢視生命週期組態的日誌
<a name="studio-lcc-create-console-step4"></a>

您可以在生命週期組態連接至網域或使用者設定檔後，檢視其記錄。

1. 首先，為您的 AWS Identity and Access Management (IAM) 角色提供 CloudWatch 的存取權。為下列日誌群組和日誌串流新增讀取許可。
   + **日誌群組：**`/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_tw/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_tw/sagemaker/latest/dg/images/studio/studio-lcc-indicator-icon.png)。

1. 選取應用程式的指示器圖示。這會開啟列出生命週期組態的新面板。

1. 從新面板中選取 `View logs`。這會開啟顯示記錄的新索引標籤。