Exporter un environnement Amazon SageMaker Studio Lab vers Amazon SageMaker Studio Classic

Amazon SageMaker Studio Classic propose de nombreuses fonctionnalités pour les flux de travail de machine learning et d'apprentissage profond qui ne sont pas disponibles dans Amazon SageMaker Studio Lab. Cette page explique comment migrer un environnement Studio Lab vers Studio Classic afin de tirer parti d'une capacité de calcul, d'un stockage et de fonctionnalités accrus. Toutefois, vous souhaiterez peut-être vous familiariser avec les conteneurs prédéfinis de Studio Classic, qui sont optimisés pour l'ensemble du MLOP pipeline. Pour plus d’informations, consultez Laboratoire Amazon SageMaker Studio.

Pour migrer votre environnement Studio Lab vers Studio Classic, vous devez d'abord intégrer Studio Classic en suivant les étapes décrites dansVue d'ensemble SageMaker du domaine Amazon.

É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 montre comment utiliser l'defaultenvironnement à exporter vers Studio Classic.

1. Ouvrez le terminal Studio Lab en ouvrant le panneau du navigateur de fichiers ( ), en choisissant le signe plus (+) dans le menu en haut du navigateur de fichiers pour ouvrir le lanceur, puis en choisissant 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: Ceci permet de configurer l' JupyterLab environnement de Studio Lab. Studio Lab exécute une version majeure JupyterLab différente de Studio Classic, elle n'est donc pas utilisable dans Studio Classic.

   • studiolab-safemode: Cela permet également de configurer l' JupyterLab environnement de Studio Lab. Studio Lab exécute une version majeure JupyterLab différente de Studio Classic, elle n'est donc pas utilisable dans Studio Classic.

   • base : cet environnement est fourni avec conda par défaut. L'baseenvironnement de Studio Lab et celui base de Studio Classic comportent des versions incompatibles de nombreux packages.

2. Pour l'environnement conda que vous souhaitez migrer vers Studio Classic, activez d'abord l'environnement conda. L'defaultenvironnement est ensuite modifié lorsque de nouvelles bibliothèques sont installées ou supprimées de celui-ci. Pour obtenir l'état exact de l'environnement, exportez-le dans un YAML fichier à l'aide de la ligne de commande. Les lignes de commande suivantes exportent l'environnement par défaut dans un YAML fichier, 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 YAML fichier, 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 le Studio Lab en GUI 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 ( ) 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 GitHub sert d'exemple. Ces étapes nécessitent un GitHub compte et un référentiel. Pour plus d'informations, consultez GitHub. La procédure suivante indique comment synchroniser votre contenu à 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, veuillez consulter 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ù se <GITHUB_USERNAME> trouve votre nom GitHub d'utilisateur et le <REPOSITORY_NAME> nom de votre dépôt distant. Créez une branche <BRANCH_NAME> pour transférer le contenu vers le GitHub référentiel.

   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 : importez vos artefacts Studio Lab dans Studio Classic

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

À partir de Studio Classic, vous pouvez importer des fichiers depuis votre machine locale ou depuis un dépôt Git. Vous pouvez le faire à l'aide du Studio Classic GUI ou du terminal. 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 suivant les étapes ci-dessous.

1. Ouvrez le panneau Explorateur de fichiers ( ) en haut à gauche de Studio Classic.

2. Cliquez sur l'icône Charger des fichiers ( ) dans le menu en haut du panneau du navigateur 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 machine locale dans un fichier. Sur un Mac, cliquez avec le bouton droit sur le répertoire et choisissez «  Compresser »<DIRECTORY_NAME>«. Sous Windows, cliquez avec le bouton droit sur le répertoire et choisissez Envoyer vers, puis sélectionnez Dossier compressé (zippé). 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 GitHub dépôt dans Studio Classic. Vous pouvez utiliser Studio Classic GUI en choisissant l'onglet Git ( ) sur le côté gauche de Studio Classic. Choisissez Cloner un dépôt, puis collez votre GitHub dépôt URL depuisÉtape 2 : enregistrer vos artefacts Studio Lab. Une autre option consiste à utiliser le terminal Studio Classic en suivant la procédure suivante.

1. Ouvrez le lanceur Studio Classic. Pour plus d'informations sur l'ouverture du lanceur, consultez Amazon SageMaker Studio Classic Launcher.

2. Dans Launcher (Lanceur), dans la section Notebooks and compute resources (Blocs-notes et ressources de calcul), choisissez Change environment (Modifier l'environnement).

3. Dans Studio Classic, ouvrez le lanceur. Pour ouvrir le lanceur, choisissez Amazon SageMaker Studio Classic dans le coin supérieur gauche de Studio Classic.

   Pour en savoir plus sur toutes les méthodes disponibles pour ouvrir Launcher (Lanceur), consultez Utiliser le 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 de 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 Studio Lab conda dans Studio Classic

Vous pouvez désormais recréer votre environnement conda en utilisant votre YAML fichier dans votre instance Studio Classic. Ouvrez le lanceur Studio Classic. Pour plus d'informations sur l'ouverture du lanceur, consultez Amazon SageMaker Studio Classic Launcher. Dans Launcher (Lanceur), choisissez Open image terminal (Ouvrir le terminal d'image). Dans le terminal, naviguez jusqu'au répertoire qui contient le YAML fichier, 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>.