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

# ライフサイクル設定の作成とアタッチ
<a name="studio-lifecycle-configurations-create"></a>

ライフサイクル設定を作成してアタッチするには、 AWS マネジメントコンソール または を使用します AWS Command Line Interface。

**Topics**
+ [ライフサイクル設定の作成とアタッチ (AWS CLI)](#studio-lifecycle-configurations-create-cli)
+ [ライフサイクル設定の作成とアタッチ (コンソール)](#studio-lifecycle-configurations-create-console)

## ライフサイクル設定の作成とアタッチ (AWS CLI)
<a name="studio-lifecycle-configurations-create-cli"></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)」を参照してください。

以下の手順では、コードエディタまたは JupyterLab で`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-lcc \
   --studio-lifecycle-config-content $LCC_CONTENT \
   --studio-lifecycle-config-app-type application-type
   ```

   `studio-lifecycle-config-app-type` には、*CodeEditor* または *JupyterLab* を指定します。
**注記**  
新しく作成されて戻されたライフサイクル設定の ARN。この ARN は、ライフサイクル設定をアプリケーションにアタッチするために必要です。

環境が適切にカスタマイズされるように、ユーザーと管理者は異なるコマンドを使用してライフサイクル設定をアタッチします。

### デフォルトのライフサイクル設定をアタッチする (管理者)
<a name="studio-lifecycle-configurations-attach-cli-administrator"></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)

次のコマンドは、JupyterLab アプリケーションのユーザープロファイルをライフサイクル設定付きで作成します。前の手順で取得したライフサイクル設定の 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]
  }
}'
```

次のコマンドは、コードエディタアプリケーションのユーザープロファイルをライフサイクル設定付きで作成します。前の手順で取得したライフサイクル設定の ARN を、ユーザーの `CodeEditorAppSettings` に追加します。ライフサイクル設定のリストを渡すことで、複数のライフサイクル設定を一度に追加できます。ユーザーが AWS CLIを使用してコードエディタアプリケーションを起動する際に、デフォルトの代わりに使用するライフサイクル設定を指定できます。ユーザーが渡すライフサイクル設定は、`CodeEditorAppSettings` 内のライフサイクル設定のリストに含まれていなければなりません。

```
# Create a new UserProfile
aws sagemaker create-user-profile --domain-id domain-id \
--user-profile-name user-profile-name \
--region region \
--user-settings '{
"CodeEditorAppSettings": {
  "LifecycleConfigArns":
    [lifecycle-configuration-arn-list]
  }
}'
```

### 組み込みライフサイクル設定のアタッチ (ユーザー)
<a name="studio-lifecycle-configurations-attach-cli-user"></a>

ライフサイクル設定をアタッチするには、ユーザープロファイルの `UserSettings` を更新する必要があります。

次のコマンドは、JupyterLab アプリケーションのユーザープロファイルをライフサイクル設定付きで作成します。前の手順のライフサイクル設定 ARN を、ユーザープロファイルの `JupyterLabAppSettings` に追加します。

```
# Update a UserProfile
aws sagemaker update-user-profile --domain-id domain-id \
--user-profile-name user-profile-name \
--region region \
--user-settings '{
"JupyterLabAppSettings": {
  "BuiltInLifecycleConfigArn":"lifecycle-configuration-arn"
  }
}'
```

次のコマンドは、コードエディタアプリケーションのユーザープロファイルをライフサイクル設定付きで作成します。前の手順のライフサイクル設定 ARN を、ユーザープロファイルの `CodeEditorAppSettings` に追加します。ユーザーが渡すライフサイクル設定は、`CodeEditorAppSettings` 内のライフサイクル設定のリストに含まれていなければなりません。

```
# Update a UserProfile
aws sagemaker update-user-profile --domain-id domain-id \
--user-profile-name user-profile-name \
--region region \
--user-settings '{
"CodeEditorAppSettings": {
  "BuiltInLifecycleConfigArn":"lifecycle-configuration-arn"
  }
}'
```

## ライフサイクル設定の作成とアタッチ (コンソール)
<a name="studio-lifecycle-configurations-create-console"></a>

でライフサイクル設定を作成してアタッチするには AWS マネジメントコンソール、[Amazon SageMaker AI コンソール](https://console.aws.amazon.com/sagemaker)に移動し、左側のナビゲーションで**ライフサイクル設定**を選択します。コンソールに、ライフサイクル設定の作成手順の説明が表示されます。