Création d’une configuration de cycle de vie - Amazon SageMaker AI
Création d’une configuration de cycle de vie (AWS CLI)Création d’une configuration de cycle de vie (console)

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éation d’une configuration de cycle de vie

Cette rubrique contient des instructions pour créer et associer une configuration de cycle de vie à JupyterLab. Vous utilisez le AWS Command Line Interface (AWS CLI) ou le AWS Management Console pour automatiser la personnalisation de votre JupyterLab environnement.

Les configurations du cycle de vie sont des scripts shell déclenchés par des événements JupyterLab du cycle de vie, tels que le démarrage d'un nouveau JupyterLab bloc-notes. Pour en savoir plus sur les configurations du cycle de vie, consultez Des configurations de cycle de vie avec JupyterLab.

Création d’une configuration de cycle de vie (AWS CLI)

Découvrez comment créer une configuration du cycle de vie à l'aide du AWS Command Line Interface (AWS CLI) pour automatiser la personnalisation de votre environnement Studio.

Conditions préalables

Avant de commencer, effectuez les opérations obligatoires suivantes :

É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!'

  2. Utilisez ce qui suit pour convertir 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`

  3. Créez une configuration de cycle de vie à utiliser avec Studio. La commande suivante crée une configuration de cycle de vie qui s’exécute au lancement d’une application JupyterLab associée :

    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

    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 : associez la configuration du cycle de vie à votre domaine Amazon SageMaker AI (domaine) et à votre profil utilisateur

Pour attacher la configuration de cycle de vie, vous devez mettre à jour le paramètre UserSettings pour votre domaine ou votre profil utilisateur. 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.

Vous pouvez créer un profil utilisateur, un domaine ou un espace nouveau avec une configuration de cycle de vie attachée à l’aide des commandes suivantes :

La commande suivante crée un profil utilisateur avec une configuration de cycle de vie. Ajoutez l’ARN de la configuration de cycle de vie provenant de l’étape précédente au paramètre JupyterLabAppSettings de l’utilisateur. Vous pouvez ajouter plusieurs configurations de cycle de vie à la fois en transmettant une liste de telles configurations. Lorsqu'un utilisateur lance une JupyterLab application avec leAWS CLI, il peut spécifier une configuration de cycle de vie au lieu d'utiliser 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 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]
  }
}'

Création d’une configuration de cycle de vie (console)

Découvrez comment créer une configuration du cycle de vie AWS Management Console à l'aide du pour automatiser la personnalisation de votre environnement Studio.

Étape 1 : Créer une configuration de cycle de vie

Utilisez la procédure suivante pour créer un script de configuration de cycle de vie qui affiche Hello World.

Pour créer une configuration de cycle de vie

  1. Ouvrez la console Amazon SageMaker AI à l'adresse https://console.aws.amazon.com/sagemaker/.

  2. Dans le panneau de navigation de gauche, choisissez Configurations d’administrateur.

  3. Sous Configurations d’administrateur, choisissez Configurations de cycle de vie.

  4. Cliquez sur l'onglet JupyterLab.

  5. Choisissez Créer une configuration.

  6. Pour Nom, spécifiez le nom de la configuration de cycle de vie.

  7. Dans la zone de texte située sous Scripts, spécifiez la configuration de cycle de vie suivante :

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

  8. Choisissez Créer une configuration.

Étape 2 : associez la configuration du cycle de vie à votre domaine Amazon SageMaker AI (domaine) et à votre profil utilisateur

Les scripts de configuration de 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.

Vous pouvez associer plusieurs configurations de cycle de vie à un domaine ou à un profil utilisateur pour JupyterLab.

Utilisez la procédure suivante pour attacher une configuration de cycle de vie à un domaine.

Pour attacher une configuration de cycle de vie à un domaine

  1. Ouvrez la console Amazon SageMaker AI à l'adresse https://console.aws.amazon.com/sagemaker/.

  2. Dans le panneau de navigation de gauche, choisissez Configurations d’administrateur.

  3. Sous Configurations d’administrateur, choisissez Domaines.

  4. Dans la liste des domaines, sélectionnez le domaine auquel attacher la configuration de cycle de vie.

  5. Sur la page Détails du domaine, cliquez sur l'onglet Environnement.

  6. Sous Configurations de cycle de vie pour les applications Studio personnelles, choisissez Attacher.

  7. Sous Source, choisissez Existing configuration (Configuration existante).

  8. Sous Configurations du cycle de vie Studio, sélectionnez la configuration du cycle de vie créée à l’étape précédente.

  9. Sélectionnez Attach to domain (Attacher au domaine).

Utilisez la procédure suivante pour attacher une configuration de cycle de vie à un profil utilisateur.

Pour attacher une configuration de cycle de vie à un profil utilisateur

  1. Ouvrez la console Amazon SageMaker AI à l'adresse https://console.aws.amazon.com/sagemaker/.

  2. Dans le panneau de navigation de gauche, choisissez Configurations d’administrateur.

  3. Sous Configurations d’administrateur, choisissez Domaines.

  4. Dans la liste des domaines, sélectionnez le domaine qui contient le profil utilisateur auquel attacher la configuration de cycle de vie.

  5. Sous Profils utilisateur, sélectionnez le profil utilisateur.

  6. Sur la page User Details (Détails de l’utilisateur), choisissez Edit (Modifier).

  7. Dans le volet de navigation de gauche, choisissez Studio.

  8. Sous Lifecycle configurations attached to user (Configurations du cycle de vie associées à l'utilisateur), choisissez Attach (Attacher).

  9. Sous Source, choisissez Existing configuration (Configuration existante).

  10. Sous Studio lifecycle configurations (Configurations du cycle de vie Studio), sélectionnez la configuration du cycle de vie créée à l'étape précédente.

  11. Choisissez Attach to user profile (Attacher au profil utilisateur).