Création d’une configuration de cycle de vie à partir de la console SageMaker AI pour Amazon SageMaker Studio Classic - Amazon SageMaker AI
PrérequisÉtape 1 : Créer une configuration de cycle de vieÉtape 2 : attacher la configuration du cycle de vieÉtape 3 : Lancer une application à l'aide de la configuration de cycle de vieÉtape 4 : Afficher les journaux d'une configuration de cycle de vie

Création d’une configuration de cycle de vie à partir de la console SageMaker AI pour Amazon SageMaker Studio Classic

Important

Les politiques IAM personnalisées qui autorisent Amazon SageMaker Studio ou Amazon SageMaker Studio Classic à créer des ressources Amazon SageMaker 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 plus d’informations, consultez Octroi d’autorisations pour baliser les ressources SageMaker AI.

Les Politiques gérées par AWS pour Amazon SageMaker AI qui autorisent la création de ressources SageMaker incluent déjà des autorisations permettant d’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.

La rubrique suivante montre comment créer une configuration du cycle de vie à partir de la console Amazon SageMaker AI afin d’automatiser la personnalisation pour votre environnement Studio Classic.

Prérequis

Avant de commencer le didacticiel, suivez les conditions préalables requises :

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

Vous pouvez créer une configuration de cycle de vie en saisissant un script à partir de la console Amazon SageMaker AI.

Note

Chaque script peut comporter jusqu’à 16 384 caractères.

La procédure suivante montre comment créer un script de configuration du cycle de vie qui imprime Hello World.

  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. Choisissez l’onglet Studio.

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

  6. Sous Sélectionner le type de configuration, sélectionnez le type d’application auquel la configuration du cycle de vie doit être attachée. Pour plus d'informations sur la sélection de l'application à laquelle attacher la configuration de cycle de vie, consultez Définition de configurations de cycle de vie par défaut pour Amazon SageMaker Studio Classic.

  7. Choisissez Suivant.

  8. Dans la section Configuration settings (Paramètres de configuration), nommez votre configuration du cycle de vie.

  9. Dans la section Scripts, saisissez le contenu suivant.

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

  10. (Facultatif) Créez une balise pour votre configuration du cycle de vie.

  11. Sélectionnez Soumettre.

Étape 2 : Attacher la configuration de cycle de vie à un domaine ou un 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 attacher plusieurs configurations de cycle de vie à un domaine ou un profil utilisateur pour les applications JupyterServer et KernelGateway.

Note

Pour attacher une configuration de cycle de vie à un espace partagé, vous devez utiliser AWS CLI. Pour plus d’informations, consultez Création d’une configuration de cycle de vie à partir de l’AWS CLI pour Amazon SageMaker Studio Classic.

Les sections suivantes vous montrent comment attacher une configuration de cycle de vie à votre domaine ou votre profil utilisateur.

Attacher à un domaine

La procédure suivante montre comment attacher une configuration de cycle de vie à votre domaine existant à partir de la console SageMaker AI.

  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).

Attacher à votre profil utilisateur

Ce qui suit montre comment associer une configuration du cycle de vie à un domaine Studio ou profil d’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).

Étape 3 : Lancer une application à l'aide de la configuration de cycle de vie

Après avoir attaché une configuration de cycle de vie à un domaine ou un profil utilisateur, vous pouvez lancer une application avec cette configuration de cycle de vie attachée. Le choix de la configuration de cycle de vie à lancer dépend du type d’application.

  • JupyterServer : lors du lancement d’une application JupyterServer à partir de la console, SageMaker AI utilise toujours la configuration de cycle de vie par défaut. Vous ne pouvez pas utiliser une autre configuration de cycle de vie lors du lancement à partir de la console. Pour plus d'informations sur la modification de la configuration de cycle de vie par défaut après le lancement d'une application JupyterServer, consultez Définition de configurations de cycle de vie par défaut pour Amazon SageMaker Studio Classic.

    Pour sélectionner une autre configuration de cycle de vie attachée, vous devez lancer l'application avec AWS CLI. Pour plus d’informations sur le lancement d’une application JupyterServer avec une configuration de cycle de vie attachée à partir d’AWS CLI, consultez Création d’une configuration de cycle de vie à partir de l’AWS CLI pour Amazon SageMaker Studio Classic.

  • KernelGateway : vous pouvez sélectionner n’importe laquelle des configurations de cycle de vie attachées lorsque vous lancez une application KernelGateway à l’aide du Lanceur Studio Classic.

La procédure suivante explique comment lancer une application KernelGateway avec une configuration de cycle de vie attachée à partir de la console SageMaker AI.

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

  2. Lancez Studio Classic. Pour plus d’informations, consultez Lancement d’Amazon SageMaker Studio Classic.

  3. Dans l’interface utilisateur de Studio Classic, ouvrez le Lanceur Studio Classic. Pour plus d’informations, consultez Utilisation du Lanceur Amazon SageMaker Studio Classic.

  4. Dans le Lanceur Studio Classic, accédez à la section Blocs-notes et ressources de calcul.

  5. Cliquez sur le bouton Change environment (Modifier l’environnement).

  6. Dans la boîte de dialogue Change environment (Modifier l'environnement), utilisez les menus déroulants pour sélectionner votre Image, votre Kernel (Noyau), votre Instance type (Type d'instance) et votre Start-up script (Script de démarrage). S'il n'y a pas de configuration de cycle de vie par défaut, la valeur par défaut de Script de démarrage est No script. Sinon, la valeur de Script de démarrage est votre configuration de cycle de vie par défaut. Une fois la configuration du cycle de vie sélectionnée, vous pouvez afficher l’intégralité du script.

  7. Cliquez sur Select (Sélectionner).

  8. Dans le lanceur, cliquez sur Create notebook (Créer un bloc-notes) pour lancer un nouveau noyau de bloc-notes avec l'image sélectionnée et la configuration du cycle de vie.

Étape 4 : Afficher les journaux d'une configuration de cycle de vie

Vous pouvez afficher les journaux de votre configuration de cycle de vie après l'avoir attachée à un domaine ou un profil utilisateur.

  1. Tout d’abord, fournissez l’accès à CloudWatch pour votre rôle (IAM) AWS Identity and Access Management. Ajoutez des autorisations de lecture pour le groupe de journaux et le flux de journaux suivants.

    • Groupe de journaux :/aws/sagemaker/studio

    • Flux de journaux :domain/user-profile/app-type/app-name/LifecycleConfigOnStart

    Pour plus d’informations sur l’ajout d’autorisations, consultez Activation de la journalisation à partir de certains AWS services.

  2. Dans Studio Classic, accédez à l’icône Exécution des terminaux et des noyaux ( Black square icon representing a placeholder or empty image. ) pour surveiller votre configuration de cycle de vie.

  3. Sélectionnez une application dans la liste des applications en cours d’exécution. Les applications avec des configurations du cycle de vie attachées ont une icône d'indicateur attachée Code brackets symbol representing programming or markup languages. .

  4. Cliquez sur l'icône d'indicateur de votre application. Cela ouvre un nouveau panneau qui répertorie les configurations du cycle de vie.

  5. Dans le nouveau panneau, sélectionnez View logs. Un nouvel onglet s’ouvre alors et affiche les journaux.