Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Créez une configuration du cycle de vie à partir du AWS CLI pour Amazon SageMaker Studio Classic
**Important**
Les politiques IAM personnalisées qui permettent à Amazon SageMaker Studio ou Amazon SageMaker Studio Classic de créer des SageMaker ressources Amazon doivent également accorder des autorisations pour ajouter des balises à ces ressources. L’autorisation d’ajouter des balises aux ressources est requise, car Studio et Studio Classic balisent automatiquement toutes les ressources qu’ils créent. Si une politique IAM autorise Studio et Studio Classic à créer des ressources mais n'autorise pas le balisage, des erreurs « AccessDenied » peuvent se produire lors de la tentative de création de ressources. Pour de plus amples informations, veuillez consulter [Fournir des autorisations pour le balisage des ressources d' SageMaker IA](security_iam_id-based-policy-examples.md#grant-tagging-permissions).
[AWS politiques gérées pour Amazon SageMaker AI](security-iam-awsmanpol.md)qui donnent des autorisations pour créer des SageMaker ressources incluent déjà des autorisations pour ajouter des balises lors de la création de ces ressources.
**Important**
Depuis le 30 novembre 2023, l'expérience Amazon SageMaker Studio précédente s'appelle désormais Amazon SageMaker Studio Classic. La section suivante est spécifique à l’utilisation de l’application Studio Classic. Pour en savoir plus sur l’utilisation de l’expérience Studio mise à jour, consultez [Amazon SageMaker Studio](studio-updated.md).
Studio Classic est toujours maintenu pour les charges de travail existantes, mais n'est plus disponible pour l'intégration. Vous pouvez uniquement arrêter ou supprimer des applications Studio Classic existantes et vous ne pouvez pas en créer de nouvelles. Nous vous recommandons de [migrer votre charge de travail vers la nouvelle expérience Studio](studio-updated-migrate.md).
La rubrique suivante explique comment créer une configuration de cycle de vie AWS CLI à l'aide du pour automatiser la personnalisation de votre environnement Studio Classic.
## Conditions préalables
Avant de commencer, effectuez les opérations obligatoires suivantes :
+ Mettez à jour le AWS CLI en suivant les étapes de [la section Installation de la AWS CLI version actuelle](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv1.html#install-tool-bundled).
+ À partir de votre ordinateur local, exécutez `aws configure` et fournissez vos informations d’identification AWS . Pour plus d'informations sur les AWS informations d'identification, voir [Comprendre et obtenir vos AWS informations d'identification](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html).
+ Intégrez le domaine SageMaker AI en suivant les étapes décrites dans[Présentation du domaine Amazon SageMaker AI](gs-studio-onboard.md).
## Étape 1 : Créer une configuration de cycle de vie
La procédure suivante montre comment créer un script de configuration du cycle de vie qui imprime `Hello World`.
**Note**
Chaque script peut comporter jusqu'à **16 384 caractères**.
1. À partir de votre ordinateur local, créez un fichier nommé `my-script.sh` avec le contenu suivant.
```
#!/bin/bash
set -eux
echo 'Hello World!'
```
1. Convertissez votre fichier `my-script.sh` au format Base64. Cette exigence évite les erreurs dues à l’encodage des espacements et des sauts de ligne.
```
LCC_CONTENT=`openssl base64 -A -in my-script.sh`
```
1. Créez une configuration de cycle de vie à utiliser avec Studio Classic. La commande suivante crée une configuration de cycle de vie qui s’exécute au lancement d’une application `KernelGateway` associée.
```
aws sagemaker create-studio-lifecycle-config \
--region region \
--studio-lifecycle-config-name my-studio-lcc \
--studio-lifecycle-config-content $LCC_CONTENT \
--studio-lifecycle-config-app-type KernelGateway
```
Notez l'ARN de la configuration de cycle de vie nouvellement créée qui est renvoyée. Cet ARN est requis pour attacher la configuration du cycle de vie à votre application.
## Étape 2 : Attacher la configuration de cycle de vie à votre domaine, profil utilisateur ou espace partagé
Pour attacher la configuration de cycle de vie, vous devez mettre à jour `UserSettings` pour votre domaine ou votre profil utilisateur, ou `SpaceSettings` pour un espace partagé. Les scripts de configuration du cycle de vie associés au niveau du domaine sont hérités par tous les utilisateurs. Toutefois, les scripts associés au niveau du profil utilisateur sont limités à un utilisateur spécifique, tandis que les scripts associés au niveau de l'espace partagé sont limités à l'espace partagé.
L’exemple suivant montre comment créer un profil utilisateur auquel la configuration du cycle de vie est attachée. Vous pouvez également créer un domaine ou un espace avec une configuration de cycle de vie attachée à l'aide des commandes [create-domain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/create-domain.html) et [create-space](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/create-space.html), respectivement.
Ajoutez l'ARN de la configuration de cycle de vie de l'étape précédente aux paramètres du type d'application approprié. Par exemple, placez-le dans les `JupyterServerAppSettings` de l’utilisateur. Vous pouvez ajouter plusieurs configurations de cycle de vie à la fois en transmettant une liste de configurations de cycle de vie. Lorsqu'un utilisateur lance une JupyterServer application avec le AWS CLI, il peut transmettre une configuration de cycle de vie à utiliser au lieu de la configuration par défaut. La configuration de cycle de vie transmise par l'utilisateur doit figurer dans la liste des configurations de cycle de vie de `JupyterServerAppSettings`.
```
# Create a new UserProfile
aws sagemaker create-user-profile --domain-id domain-id \
--user-profile-name user-profile-name \
--region region \
--user-settings '{
"JupyterServerAppSettings": {
"LifecycleConfigArns":
[lifecycle-configuration-arn-list]
}
}'
```
L'exemple suivant montre comment mettre à jour un espace partagé existant pour y attacher la configuration de cycle de vie. Vous pouvez également mettre à jour un domaine ou un profil utilisateur existant avec une configuration de cycle de vie associée à l'aide de la [commande update-domain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/update-domain.html). [update-user-profile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/update-user-profile.html) Lorsque vous mettez à jour la liste des configurations de cycle de vie attachées, vous devez transmettre toutes les configurations de cycle de vie dans la liste. Si une configuration de cycle de vie ne figure pas dans cette liste, elle ne sera pas attachée à l'application.
```
aws sagemaker update-space --domain-id domain-id \
--space-name space-name \
--region region \
--space-settings '{
"JupyterServerAppSettings": {
"LifecycleConfigArns":
[lifecycle-configuration-arn-list]
}
}'
```
Pour plus d'informations sur la définition d'une configuration de cycle de vie par défaut pour une ressource, consultez [Définir les configurations de cycle de vie par défaut pour Amazon SageMaker Studio Classic](studio-lcc-defaults.md).
## Étape 3 : Lancer une application avec la configuration de cycle de vie
Après avoir attaché une configuration de cycle de vie à un domaine, un profil utilisateur ou un espace, l'utilisateur peut la sélectionner lors du lancement d'une application avec AWS CLI. Cette section explique comment lancer une application associée à une configuration du cycle de vie. Pour plus d'informations sur la modification de la configuration du cycle de vie par défaut après le lancement d'une JupyterServer application, consultez[Définir les configurations de cycle de vie par défaut pour Amazon SageMaker Studio Classic](studio-lcc-defaults.md).
Lancez le type d'application de votre choix à l'aide de la commande `create-app` et spécifiez l'ARN de la configuration de cycle de vie dans l'argument `resource-spec`.
+ L'exemple suivant montre comment créer une application `JupyterServer` avec une configuration de cycle de vie associée. Lors de la création de `JupyterServer`, `app-name` doit être `default`. L'ARN de configuration du cycle de vie transmis dans le cadre du `resource-spec` paramètre doit faire partie de la liste des configurations de cycle de vie ARNs spécifiée `UserSettings` pour votre domaine ou votre profil utilisateur, ou `SpaceSettings` pour un espace partagé.
```
aws sagemaker create-app --domain-id domain-id \
--region region \
--user-profile-name user-profile-name \
--app-type JupyterServer \
--resource-spec LifecycleConfigArn=lifecycle-configuration-arn \
--app-name default
```
+ L’exemple suivant montre comment créer une application `KernelGateway` avec une configuration de cycle de vie associée.
```
aws sagemaker create-app --domain-id domain-id \
--region region \
--user-profile-name user-profile-name \
--app-type KernelGateway \
--resource-spec LifecycleConfigArn=lifecycle-configuration-arn,SageMakerImageArn=sagemaker-image-arn,InstanceType=instance-type \
--app-name app-name
```