ライフサイクル設定の作成と関連付け

このトピックでは、ライフサイクル設定を作成して に関連付ける手順について説明します JupyterLab。 AWS Command Line Interface （AWS CLI) または を使用して AWS Management Console 、 JupyterLab 環境のカスタマイズを自動化します。

ライフサイクル設定は、新しい JupyterLab ノートブックの開始などの JupyterLab ライフサイクルイベントによってトリガーされるシェルスクリプトです。ライフサイクル設定についての詳細は、「でのライフサイクル設定の使用 JupyterLab」を参照してください。

ライフサイクル設定を作成する (AWS CLI）

AWS Command Line Interface （AWS CLI) を使用してライフサイクル設定を作成し、Studio 環境のカスタマイズを自動化する方法について説明します。

前提条件

開始する前に、次の前提条件を完了します。

• 「現在の AWS CLI バージョン のインストール」の AWS CLI 手順に従って を更新します。

• ローカルマシンで aws configure を実行し、 AWS 認証情報を入力します。 AWS 認証情報の詳細については、「認証情報の理解と取得」を参照してください AWS。

• Amazon SageMaker ドメインにオンボードします。概念については、「Amazon SageMaker ドメインの概要」を参照してください。クイックスタートガイドについては、「」を参照してくださいAmazon へのクイックセットアップ SageMaker。

手順 1: ライフサイクル設定を作成する

以下の手順では、Hello World を出力するライフサイクル設定スクリプトを作成する方法について説明します。

注記

各スクリプトには最大 16,384 文字まで入力できます。

1. ローカルマシンから、次の内容my-script.shで という名前のファイルを作成します。

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

2. 以下を使用して、my-script.shファイルを base64 形式に変換します。これにより、スペースと改行のエンコードによって発生するエラーを防止できます。

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

3. 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 ドメイン (ドメイン) とユーザープロファイルにアタッチする

ライフサイクル設定をアタッチするには、ドメインまたはユーザープロファイルUserSettingsの を更新する必要があります。ドメインレベルで関連付けられたライフサイクル設定スクリプトは、すべてのユーザーに継承されます。ただし、ユーザープロファイルレベルで関連付けられたスクリプトは、特定のユーザーを対象としています。

次のコマンドを使用して、ライフサイクル設定がアタッチされた新しいユーザープロファイル、ドメイン、またはスペースを作成できます。

• create-user-profile

• create-domain

• create-space

次のコマンドは、ライフサイクル設定を使用してユーザープロファイルを作成します。前のステップのライフサイクル設定 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 Management Console 、Studio 環境のカスタマイズを自動化する方法について説明します。

手順 1: ライフサイクル設定を作成する

を出力するライフサイクル設定スクリプトを作成するには、次の手順に従いますHello World。

ライフサイクル設定を作成するには

1. https://console.aws.amazon.com/sagemaker/ で Amazon SageMaker コンソールを開きます。

2. 左側のナビゲーションペインで、[管理設定]‭ を選択します。

3. [管理設定] で、[ライフサイクル設定] を選択します。

4. [JupyterLab] タブを選択します。

5. [Create configuration] (設定を作成) をクリックします。

6. 名前 には、ライフサイクル設定の名前を指定します。

7. スクリプト のテキストボックスには、次のライフサイクル設定を指定します。

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

8. [Create configuration] (設定を作成) をクリックします。

ステップ 2: ライフサイクル設定を Amazon SageMaker ドメイン (ドメイン) とユーザープロファイルにアタッチする

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

のドメインまたはユーザープロファイルに複数のライフサイクル設定をアタッチできます JupyterLab。

次の手順に従って、ライフサイクル設定をドメインにアタッチします。

ライフサイクル設定をドメインにアタッチするには

1. https://console.aws.amazon.com/sagemaker/ で Amazon SageMaker コンソールを開きます。

2. 左のナビゲーションペインで、[管理設定‭] を選択します。

3. 管理者設定 で、ドメイン を選択します。

4. ドメインのリストから、ライフサイクル設定をアタッチするドメインを選択します。

5. [ドメインの詳細] ページで、[環境] タブを選択します。

6. [個人用 Studio アプリのライフサイクル設定] で、[アタッチ] を選択します。

7. [ソース] で、[既存の設定] を選択します。

8. [Studio ライフサイクル設定] で、前の手順で作成したライフサイクル設定を選択します。

9. [ドメインにアタッチ] を選択します。

次の手順を使用して、ライフサイクル設定をユーザープロファイルにアタッチします。

ライフサイクル設定をユーザープロファイルにアタッチするには

1. https://console.aws.amazon.com/sagemaker/ で Amazon SageMaker コンソールを開きます。

2. 左のナビゲーションペインで、[管理設定‭] を選択します。

3. 管理者設定 で、ドメイン を選択します。

4. ドメインのリストから、ライフサイクル設定をアタッチするユーザープロファイルを含むドメインを選択します。

5. [ユーザープロファイル] で、ユーザープロファイルを選択します。

6. [ユーザーの詳細] ページで、[編集] を選択します。

7. 左側のナビゲーションで、[Studio の設定] を選択します。

8. [ユーザーにアタッチされたライフサイクル設定] で、[アタッチ] を選択します。

9. [ソース] で、[既存の設定] を選択します。

10. [Studio ライフサイクル設定] で、前の手順で作成したライフサイクル設定を選択します。

11. [ユーザープロファイルにアタッチ] を選択します。