SageMaker AI コンソールからライフサイクル設定を作成する - Amazon SageMaker AI
前提条件手順 1: 新しいライフサイクル設定を作成する手順 2: ライフサイクル設定をアタッチする手順 3: ライフサイクル設定を使用してアプリケーションを起動する手順 4: ライフサイクル設定のログを表示する

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

SageMaker AI コンソールからライフサイクル設定を作成する

重要

Amazon SageMaker Studio または Amazon SageMaker Studio Classic が Amazon SageMaker リソースを作成できるようにするカスタムIAMポリシーでは、それらのリソースにタグを追加するアクセス許可も付与する必要があります。Studio と Studio Classic は、作成したリソースに自動的にタグ付けするため、リソースにタグを追加するアクセス許可が必要になります。IAM ポリシーで Studio と Studio Classic にリソースの作成は許可されているが、タグ付けが許可されていない場合、リソースの作成時にAccessDenied「」エラーが発生する可能性があります。詳細については、「 SageMaker AI リソースにタグ付けするためのアクセス許可を提供する」を参照してください。

AWS Amazon SageMaker AI の マネージドポリシー SageMaker リソースを作成するアクセス許可を付与する には、それらのリソースの作成中にタグを追加するアクセス許可が既に含まれています。

重要

2023 年 11 月 30 日現在、以前の Amazon SageMaker Studio エクスペリエンスは Amazon SageMaker Studio Classic という名前になりました。以下のセクションは、Studio Classic アプリケーションの使用を前提とした内容です。更新後の Studio エクスペリエンスを使用する場合は、「Amazon SageMaker 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. [設定タイプの選択] で、ライフサイクル設定をアタッチするアプリケーションタイプを選択します。ライフサイクル設定をアタッチするアプリケーションの選択の詳細については、「デフォルトのライフサイクル設定を設定する」を参照してください。

  7. [Next (次へ)] を選択します。

  8. [構成設定] セクションにライフサイクル設定の名前を入力します。

  9. [スクリプト] セクションに次の内容を入力します。

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

  10. (オプション) ライフサイクル設定のタグを作成します。

  11. [送信] を選択します。

手順 2: ドメインまたはユーザープロファイルにライフサイクル設定をアタッチする

ドメインレベルで関連付けられたライフサイクル設定スクリプトは、すべてのユーザーに継承されます。ただし、ユーザープロファイルレベルで関連付けられたスクリプトは、特定のユーザーを対象としています。

JupyterServer と の両方の KernelGateway アプリケーションのドメインまたはユーザープロファイルに複数のライフサイクル設定をアタッチできます。

注記

ライフサイクル設定を共有スペースにアタッチするには、 AWS CLIを使用する必要があります。詳細については、「AWS CLIからライフサイクル設定を作成する」を参照してください。

以下のセクションでは、ライフサイクル設定をドメインまたはユーザープロファイルにアタッチする方法を示します。

ドメインにアタッチする

AI SageMaker コンソールから既存のドメインにライフサイクル設定をアタッチする方法を次に示します。

  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 アプリケーションの起動後にデフォルトのライフサイクル設定を変更する方法については、「」を参照してくださいデフォルトのライフサイクル設定を設定する。

    アタッチされた別のライフサイクル設定を選択するには、 AWS CLIで起動する必要があります。からライフサイクル設定がアタッチされた JupyterServer アプリケーションの起動の詳細については AWS CLI、「」を参照してくださいAWS CLIからライフサイクル設定を作成する。

  • KernelGateway: Studio Classic Launcher を使用して 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 Launcher を使用する」を参照してください。

  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] を選択します。新しいタブが開き、ログが表示されます。