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

# ライフサイクル設定の作成
<a name="jl-lcc-create"></a>

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

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

## ライフサイクル設定の作成 (AWS CLI)
<a name="jl-lcc-create-cli"></a>

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

### 前提条件
<a name="jl-lcc-create-cli-prerequisites"></a>

開始する前に、次の前提条件を完了します。
+ [現在の AWS CLI バージョンのインストール](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv1.html#install-tool-bundled)の AWS CLI 手順に従って、 を更新します。
+ ローカルマシンで `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: ライフサイクル設定を作成する
<a name="jl-lcc-create-cli-step1"></a>

以下の手順では、`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 ドメイン (ドメイン) およびユーザープロファイルにライフサイクル設定をアタッチする
<a name="jl-lcc-create-cli-step2"></a>

ライフサイクル設定をアタッチするには、ドメインまたはユーザープロファイルの `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]
  }
}'
```

## ライフサイクル設定の作成 (コンソール)
<a name="jl-lcc-create-console"></a>

を使用してライフサイクル設定を作成し、Studio 環境のカスタマイズ AWS マネジメントコンソール を自動化する方法について説明します。

### 手順 1: ライフサイクル設定を作成する
<a name="jl-lcc-create-console-step1"></a>

以下の手順では、`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 ドメイン (ドメイン) およびユーザープロファイルにライフサイクル設定をアタッチする
<a name="jl-lcc-create-console-step2"></a>

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

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. **[ユーザープロファイルにアタッチ]** を選択します。