從 Amazon SageMaker Studio Classic 的 SageMaker AI 主控台建立生命週期組態 - Amazon SageMaker AI
先決條件步驟 1：建立新生命週期組態步驟 2：連接生命週期組態步驟 3：使用生命週期組態啟動應用程式步驟 4：檢視生命週期組態的日誌

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

從 Amazon SageMaker Studio Classic 的 SageMaker AI 主控台建立生命週期組態

重要

允許 Amazon SageMaker Studio 或 Amazon SageMaker Studio Classic 建立 Amazon SageMaker 資源的自訂 IAM 政策也必須授與許可，才能將標籤新增至這些資源。需要將標籤新增至資源的許可，因為 Studio 和 Studio Classic 會自動標記它們建立的任何資源。如果 IAM 政策允許 Studio 和 Studio Classic 建立資源，但不允許標記，則在嘗試建立資源時可能會出現「AccessDenied」錯誤。如需詳細資訊，請參閱提供標記 SageMaker AI 資源的許可。

提供許可來建立 SageMaker 資源的 AWSAmazon SageMaker AI 的 受管政策 已包含建立這些資源時新增標籤的許可。

重要

自 2023 年 11 月 30 日起，先前的 Amazon SageMaker Studio 體驗現在命名為 Amazon SageMaker Studio Classic。下節專門介紹如何使用 Studio Classic 應用程式。如需使用已更新 Studio 體驗的資訊，請參閱 Amazon SageMaker Studio。

Studio Classic 仍會針對現有工作負載進行維護，但無法再用於加入。您只能停止或刪除現有的 Studio Classic 應用程式，而且無法建立新的應用程式。建議您將工作負載遷移至新的 Studio 體驗。

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

先決條件

開始本教學課程之前，你必須先完成下列先決條件：

步驟 1：建立新生命週期組態

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

注意

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

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

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

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

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

  4. 選擇 Studio 索引標籤。

  5. 選擇建立組態。

  6. 在選取組態類型下，選取應連接生命週期組態的應用程式類型。如需選取要連接生命週期組態之應用程式的更多資訊，請參閱設定 Amazon SageMaker Studio Classic 的預設生命週期組態。

  7. 選擇下一步。

  8. 在名為組態設定的區段中，輸入生命週期組態的名稱。

  9. 在指令碼區段中，輸入下列內容。

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

  10. (選擇性) 建立生命週期組態的標籤。

  11. 選擇提交。

步驟 2：將生命週期組態連接至網域或使用者設定檔

所有使用者都會繼承與網域層級相關聯的生命週期組態指令碼。但是，在使用者設定檔層級關聯的指令碼範圍是特定使用者。

您可以將多個生命週期組態連接至網域或使用者設定檔，以供 JupyterServer 和 KernelGateway 應用程式使用。

注意

若要將生命週期組態連接至共用空間，您必須使用 AWS CLI。如需詳細資訊，請參閱從 Amazon SageMaker Studio Classic 的 AWS CLI 建立生命週期組態。

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

連接至網域

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

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

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

  3. 在管理員組態下，選擇網域。

  4. 從網域清單中，選取要連接生命週期組態的網域。

  5. 從網域詳細資料中，選擇環境索引標籤。

  6. 在個人 Studio 應用程式的生命週期組態下，選擇連接。

  7. 在來源下，選擇現有的組態。

  8. 在 Studio 生命週期組態下，選取您在上一個步驟中建立的生命週期組態。

  9. 選取連接至網域。

連接至您的使用者設定檔

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

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

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

  3. 在管理員組態下，選擇網域。

  4. 從網域清單中，選取包含要連接生命週期組態之使用者設定檔的網域。

  5. 在使用者設定檔下，選取使用者設定檔。

  6. 在使用者詳細資訊頁面，選擇編輯。

  7. 在左側導覽選擇 Studio 設定。

  8. 在連接至使用者的生命週期組態下，選擇連接。

  9. 在來源下，選擇現有的組態。

  10. 在 Studio 生命週期組態下，選取您在上一個步驟中建立的生命週期組態。

  11. 選擇連接至使用者設定檔。

步驟 3：使用生命週期組態啟動應用程式

將生命週期組態連接至網域或使用者設定檔後，您可以啟動具有該連接生命週期組態的應用程式。根據應用程式類型，選擇要啟動的生命週期組態。

  • JupyterServer：從主控台啟動 JupyterServer 應用程式時，SageMaker AI 一律會使用預設生命週期組態。從主控台啟動時，您無法使用不同的生命週期組態。如需有關在啟動 JupyterServer 應用程式之後變更預設生命週期組態的資訊，請參閱設定 Amazon SageMaker Studio Classic 的預設生命週期組態。

    若要選取不同的連接生命週期組態，您必須使用 AWS CLI。如需從 啟動具有連接生命週期組態的 JupyterServer 應用程式的詳細資訊AWS CLI，請參閱 從 Amazon SageMaker Studio Classic 的 AWS CLI 建立生命週期組態。

  • KernelGateway：您可以在使用 Studio Classic 啟動器啟動 KernelGateway 應用程式時，選取任何連接的生命週期組態。

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

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

  2. 啟動 Studio Classic。如需詳細資訊，請參閱啟動 Amazon SageMaker Studio Classic。

  3. 在 Studio Classic UI 中，開啟 Studio Classic 啟動器。如需詳細資訊，請參閱使用 Amazon SageMaker Studio Classic 啟動器。

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

  5. 按一下變更環境按鈕。

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

  7. 按一下選取。

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

步驟 4：檢視生命週期組態的日誌

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

  1. 首先，為您的 AWS Identity and Access Management(IAM) 角色提供 CloudWatch 的存取權。為下列日誌群組和日誌串流新增讀取許可。

    • 日誌群組：/aws/sagemaker/studio

    • 日誌串流：domain/user-profile/app-type/app-name/LifecycleConfigOnStart

    如需新增許可的詳細資訊，請參閱啟用來自特定 AWS服務的日誌記錄。

  2. 從 Studio Classic 內，導覽到執行中終端機和核心圖示 ( Black square icon representing a placeholder or empty image. ) 以監控您的生命週期組態。

  3. 從運作中的應用程式清單中選取應用程式。具有連接生命週期組態的應用程式會連接指示器圖示 Code brackets symbol representing programming or markup languages. 。

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

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