Création de configurations de cycle de vie - Amazon SageMaker
Création d'une configuration du cycle de vie (AWS CLI)Création d'une configuration du 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 de configurations 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 du 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.

Prérequis

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 machine locale, 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 my-script.sh fichier 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 lorsque vous lancez une JupyterLab application 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 la configuration ARN du cycle de vie nouvellement créée qui est renvoyée. Cela ARN est nécessaire pour associer la configuration du cycle de vie à votre application.

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

Pour associer la configuration du cycle de vie, vous devez mettre à jour la configuration UserSettings correspondant à 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 nouveau profil utilisateur, un nouveau domaine ou un nouvel espace associé à une configuration de cycle de vie à l'aide des commandes suivantes :

La commande suivante crée un profil utilisateur avec une configuration du cycle de vie. Ajoutez la configuration du cycle ARN de vie de l'étape précédente à celle JupyterLabAppSettings de l'utilisateur. Vous pouvez ajouter plusieurs configurations de cycle de vie en même temps en transmettant une liste de ces configurations. Lorsqu'un utilisateur lance une JupyterLab application avec le AWS 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 du 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 du cycle de vie qui s'imprimeHello World.

Pour créer une configuration de cycle de vie

  1. Ouvrez la SageMaker console Amazon à 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. Choisissez l'JupyterLabonglet.

  5. Choisissez Create configuration (Créer une configuration).

  6. Dans Nom, spécifiez le nom de la configuration du 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 Create configuration (Créer une configuration).

Étape 2 : associez la configuration du cycle de vie à votre SageMaker domaine Amazon (domaine) et à 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 associer plusieurs configurations de cycle de vie à un domaine ou à un profil utilisateur pour JupyterLab.

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

Pour associer une configuration de cycle de vie à un domaine

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

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

  3. Sous Configurations d'administration, sélectionnez les domaines.

  4. Dans la liste des domaines, sélectionnez le domaine auquel associer la configuration du 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 Studio lifecycle configurations (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 associer une configuration de cycle de vie à un profil utilisateur.

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

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

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

  3. Sous Configurations d'administration, sélectionnez les domaines.

  4. Dans la liste des domaines, sélectionnez le domaine qui contient le profil utilisateur auquel associer la configuration du 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).