Exportation d’un environnement Amazon SageMaker Studio Lab vers Amazon SageMaker Studio Classic - Amazon SageMaker AI
Étape 1 : Exporter votre environnement Studio Lab condaÉtape 2 : enregistrer vos artefacts Studio LabÉtape 3 : Importation de vos artefacts Studio Lab dans Studio ClassicÉtape 4 : Installation de vos environnements conda Studio Lab dans Studio Classic

Exportation d’un environnement Amazon SageMaker Studio Lab vers Amazon SageMaker Studio Classic

Amazon SageMaker Studio Classic offre de nombreuses fonctionnalités pour les flux de travail de machine learning et de deep learning qui ne sont pas disponibles dans Amazon SageMaker Studio Lab. Cette page explique comment migrer un environnement Studio Lab vers Studio Classic afin de bénéficier d’une plus grande capacité de calcul, de plus de stockage et de fonctionnalités supplémentaires. Toutefois, vous souhaiterez peut-être vous familiariser avec les conteneurs préconçus de Studio Classic, qui sont optimisés pour l’ensemble du pipeline MLOP. Pour plus d’informations, consultez Amazon SageMaker Studio Lab

Pour migrer votre environnement Studio Lab vers Studio Classic, vous devez d’abord intégrer Studio Classic en suivant les étapes décrites dans Présentation du domaine Amazon SageMaker AI.

Étape 1 : Exporter votre environnement Studio Lab conda

Vous pouvez exporter un environnement conda et y ajouter des bibliothèques ou des packages en suivant les étapes décrites dans Gérer votre environnement. L’exemple suivant illustre l’utilisation de l’environnement default à exporter vers Studio Classic.

  1. Ouvrez le terminal Studio Lab en ouvrant le volet Explorateur de fichiers ( Black square icon representing a placeholder or empty image. ), choisissez le signe plus (+) dans le menu situé en haut de l’explorateur de fichiers pour ouvrir le Lanceur, puis choisissez Terminal. À partir du terminal Studio Lab, répertoriez les environnements conda en exécutant ce qui suit.

    conda env list

    Cette commande affiche une liste des environnements conda et de leurs emplacements dans le système de fichiers. Lorsque vous intégrez Studio Lab, vous activez automatiquement l'environnement conda studiolab.

    # conda environments: #
           default                  /home/studio-lab-user/.conda/envs/default
           studiolab             *  /home/studio-lab-user/.conda/envs/studiolab
           studiolab-safemode       /opt/amazon/sagemaker/safemode-home/.conda/envs/studiolab-safemode
           base                     /opt/conda

    Nous vous recommandons de ne pas exporter les environnements studiolab, studiolab-safemode ni base. Ces environnements ne sont pas utilisables dans Studio Classic pour les raisons suivantes :

    • studiolab : cela configure l’environnement JupyterLab pour Studio Lab. Studio Lab exécute une autre version majeure de JupyterLab que Studio Classic, qui n’est pas utilisable dans Studio Classic.

    • studiolab-safemode : cela configure également l’environnement JupyterLab pour Studio Lab. Studio Lab exécute une autre version majeure de JupyterLab que Studio Classic, qui n’est pas utilisable dans Studio Classic.

    • base : cet environnement est fourni avec conda par défaut. L’environnement base dans Studio Lab et l’environnement base dans Studio Classic ont des versions incompatibles de nombreux packages.

  2. Pour l’environnement conda que vous souhaitez migrer vers Studio Classic, commencez par activer l’environnement conda. L’environnement default est ensuite modifié lorsque de nouvelles bibliothèques sont installées dans celui-ci ou en sont supprimées. Pour obtenir l’état exact de l’environnement, exportez-le dans un fichier YAML à l’aide de la ligne de commande. Les lignes de commande suivantes exportent l'environnement par défaut dans un fichier YAML, en créant un fichier appelé myenv.yml.

    conda activate default
conda env export > ~/myenv.yml

Étape 2 : enregistrer vos artefacts Studio Lab

Maintenant que vous avez enregistré votre environnement dans un fichier YAML, vous pouvez déplacer le fichier d'environnement vers n'importe quelle plateforme.

Save to a local machine using Studio Lab GUI
Note

Le téléchargement d'un répertoire depuis l'interface graphique de Studio Lab en cliquant avec le bouton droit sur le répertoire n'est actuellement pas disponible. Si vous souhaitez exporter un répertoire, suivez les étapes à l'aide de l'onglet Save to Git repository (Enregistrer dans le référentiel Git).

L'une des options consiste à enregistrer l'environnement sur votre machine locale. Pour cela, procédez comme suit :

  1. Dans Studio Lab, choisissez l’icône Navigateur de fichiers ( Black square icon representing a placeholder or empty image. ) dans le menu de gauche, afin que le panneau Navigateur de fichiers apparaisse à gauche.

  2. Accédez à votre répertoire utilisateur en choisissant l’icône de fichier située sous la barre de recherche de fichiers.

  3. Choisissez (clic droit) le fichier myenv.yml, puis choisissez Download (Télécharger). Vous pouvez répéter ce processus pour les autres fichiers que vous souhaitez importer dans Studio Classic.

Save to a Git repository

Une autre option consiste à enregistrer votre environnement dans un référentiel Git. Cette option utilise GitHub comme exemple. Ces étapes nécessitent un compte et un référentiel GitHub. Pour plus d'informations, reportez-vous à GitHub. La procédure suivante montre comment synchroniser votre contenu avec GitHub à l’aide du terminal Studio Lab.

  1. Depuis le terminal Studio Lab, accédez à votre répertoire utilisateur et créez un nouveau répertoire contenant les fichiers que vous souhaitez exporter. 

    cd ~
mkdir <NEW_DIRECTORY_NAME>

  2. Après avoir créé un nouveau répertoire, copiez tous les fichiers et répertoires que vous souhaitez exporter vers <NEW_DIRECTORY_NAME>.

    Copiez un fichier en utilisant le format de code suivant :

    cp <FILE_NAME> <NEW_DIRECTORY_NAME>

    Par exemple, remplacez <FILE_NAME> par myenv.yml.

    Copiez tout répertoire en utilisant le format de code suivant :

    cp -r <DIRECTORY_NAME> <NEW_DIRECTORY_NAME>

    Par exemple, remplacez <DIRECTORY_NAME> par n'importe quel nom de répertoire dans votre répertoire utilisateur.

  3. Accédez au nouveau répertoire et initialisez le répertoire en tant que référentiel Git à l'aide de la commande suivante. Pour plus d’informations, consultez la documentation git-init. 

    cd <NEW_DIRECTORY_NAME>
git init

  4. À l'aide de Git, ajoutez tous les fichiers pertinents, puis validez vos modifications. 

    git add .
git commit -m "<COMMIT_MESSAGE>"

    Par exemple, remplacez <COMMIT_MESSAGE> par Add Amazon SageMaker Studio Lab artifacts to GitHub repository to migrate to Amazon SageMaker Studio Classic .

  5. Transmettez la validation dans votre référentiel distant. Ce dépôt a le format https://github.com/<GITHUB_USERNAME>/ <REPOSITORY_NAME>.git, où <GITHUB_USERNAME> est votre nom d'utilisateur GitHub et <REPOSITORY_NAME> est le nom de votre référentiel distant. Créez une branche <BRANCH_NAME> pour transférer (push) le contenu vers le référentiel GitHub.

    git branch -M <BRANCH_NAME>
git remote add origin https://github.com/<GITHUB_USERNAME>/<REPOSITORY_NAME>.git
git push -u origin <BRANCH_NAME>

Étape 3 : Importation de vos artefacts Studio Lab dans Studio Classic

La procédure suivante montre comment importer des artefacts dans Studio Classic. Les instructions relatives à l’utilisation de Feature Store via la console varient selon que vous avez activé Studio ou Studio Classic comme expérience par défaut. Pour obtenir des informations sur l’accès à Studio Classic via la console, consultez Lancement de Studio Classic si Studio est votre expérience par défaut.

Depuis Studio Classic, vous pouvez importer des fichiers depuis votre ordinateur local ou depuis un référentiel Git. Pour ce faire, vous pouvez utiliser l’interface graphique ou le terminal de Studio Classic. La procédure suivante utilise les exemples figurant dans Étape 2 : enregistrer vos artefacts Studio Lab.

Import using the Studio Classic GUI

Si vous avez enregistré les fichiers sur votre ordinateur local, vous pouvez les importer dans Studio Classic en procédant comme suit.

  1. Ouvrez le volet Explorateur de fichiers ( Black square icon representing a placeholder or empty image. ) en haut à gauche de Studio Classic.

  2. Choisissez l’icône Charger des fichiers ( Black square icon representing a placeholder or empty image. ) dans le menu situé en haut du panneau Explorateur de fichiers.

  3. Accédez au fichier que vous souhaitez importer, puis choisissez Ouvrir.

Note

Pour importer un répertoire dans Studio Classic, compressez d’abord le répertoire sur votre ordinateur local dans un fichier. Sur un Mac, cliquez avec le bouton droit sur le répertoire et choisissez Compresser « <NOM_RÉPERTOIRE> ». Dans Windows, effectuez un clic droit sur le répertoire et choisissez Envoyer vers, puis Dossier compressé. Une fois le répertoire compressé, importez le fichier compressé en suivant les étapes précédentes. Décompressez le fichier compressé en accédant au terminal Studio Classic et en exécutant la commande <DIRECTORY_NAME>.zip.

Import using a Git repository

Cet exemple propose deux options pour cloner un référentiel GitHub dans Studio Classic. Vous pouvez utiliser l’interface graphique de Studio Classic en choisissant l’onglet Git ( Black square icon representing a placeholder or empty image. ) sur le côté gauche de Studio Classic. Choisissez Cloner un référentiel, puis collez l’URL de votre référentiel GitHub à partir de Étape 2 : enregistrer vos artefacts Studio Lab. Une autre option consiste à utiliser le terminal Studio Classic à l’aide de la procédure suivante.

  1. Ouvrez le Lanceur Studio Classic. Pour plus d’informations sur l’ouverture du Lanceur, consultez Lanceur Amazon SageMaker Studio Classic.

  2. Dans le lanceur, dans la section Blocs-notes et ressources de calcul, choisissez Modifier l’environnement.

  3. Dans Studio Classic, ouvrez le Lanceur. Pour ouvrir le Lanceur, choisissez Amazon SageMaker Studio Classic dans l’angle supérieur gauche de Studio Classic.

    Pour en savoir plus sur toutes les méthodes disponibles pour ouvrir Launcher (Lanceur), consultez Utilisation du Lanceur Amazon SageMaker Studio Classic.

  4. Dans la boîte de dialogue Change environment (Modifier l'environnement), utilisez la liste déroulante Image pour sélectionner l'image Data Science (Science des données) et choisissez Select (Sélectionner). Cette image est fournie préinstallée avec conda.

  5. Dans le Lanceur Studio Classic, choisissez Ouvrir le terminal d’image.

  6. Depuis le terminal d’image, exécutez la commande suivante pour cloner votre référentiel. Cette commande crée un répertoire nommé d’après <REPOSITORY_NAME> dans votre instance Studio Classic et clone vos artefacts dans ce référentiel.

    git clone https://github.com/<GITHUB_USERNAME>/<REPOSITORY_NAME>.git

Étape 4 : Installation de vos environnements conda Studio Lab dans Studio Classic

Vous pouvez désormais recréer votre environnement conda en utilisant votre fichier YAML dans votre instance Studio Classic. Ouvrez le Lanceur Studio Classic. Pour plus d’informations sur l’ouverture du Lanceur, consultez Lanceur Amazon SageMaker Studio Classic. Dans Lanceur, choisissez Ouvrir le terminal d’image. Dans le terminal, accédez au répertoire contenant le fichier YAML, puis exécutez les commandes suivantes. 

conda env create --file <ENVIRONMENT_NAME>.yml
conda activate <ENVIRONMENT_NAME>

Une fois ces commandes terminées, vous pouvez sélectionner votre environnement comme noyau pour vos instances de bloc-notes Studio Classic. Pour afficher l’environnement disponible, exécutez conda env list. Pour activer votre environnement, exécutez conda activate <ENVIRONMENT_NAME>.