Utiliser des ressources externes dans Amazon SageMaker Studio Lab

Avec Amazon SageMaker Studio Lab, vous pouvez intégrer des ressources externes, telles que des blocs-notes et des données Jupyter, à partir des référentiels Git et Amazon S3. Vous pouvez également ajouter un bouton Ouvrir dans Studio Lab à votre référentiel et à vos blocs-notes GitHub. Ce bouton vous permet de cloner vos blocs-notes directement depuis Studio Lab.

Les rubriques suivantes montrent comment intégrer des ressources externes.

Utiliser des ressources GitHub

Studio Lab offre une intégration avec GitHub. Avec cette intégration, vous pouvez cloner des blocs-notes et des référentiels directement dans votre projet Studio Lab.

Les rubriques suivantes fournissent des informations sur l'utilisation des ressources GitHub avec Studio Lab.

Exemples de blocs-notes Studio Lab

Pour commencer à utiliser un référentiel d'exemples de blocs-notes adaptés à Studio Lab, consultez Exemple de bloc-notes Studio Lab.

Ce référentiel fournit des blocs-notes pour les cas d'utilisation suivants et d'autres.

• Reconnaissance d'image

• Connexion à AWS

• Création d'environnements personnalisés

• Analyse des données géospatiales

• Traitement du langage naturel

• Utilisation de R

Cloner un référentiel GitHub

Pour cloner un référentiel GitHub dans votre projet Studio Lab, procédez comme suit.

1. Démarrez l'exécution de votre projet Studio Lab. Pour plus d'informations sur le lancement de l'exécution du projet Studio Lab, consultez Démarrage de l'exécution du projet.

2. Dans Studio Lab, choisissez l'icône Navigateur de fichiers ( ) dans le menu de gauche, afin que le panneau Navigateur de fichiers apparaisse à gauche.

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

4. Dans le menu de gauche, sélectionnez l'icône Git ( ) pour ouvrir un nouveau menu déroulant.

5. Choisissez Clone a Repository (Cloner un référentiel).

6. Collez l'URL du référentiel sous URL du référentiel Git (.git).

7. Sélectionnez Clone (Cloner).

Cloner des blocs-notes séparément à partir de GitHub

Pour ouvrir un bloc-notes dans Studio Lab, vous devez avoir accès au référentiel dans lequel se trouve le bloc-notes. Les exemples suivants décrivent le comportement lié aux autorisations de Studio Lab dans différentes situations.

• Si un référentiel est public, vous pouvez automatiquement cloner le bloc-notes dans votre projet à partir de la page de prévisualisation de Studio Lab.

• Si un référentiel est privé, vous êtes invité à vous connecter à GitHub à partir de la page de prévisualisation de Studio Lab. Si vous avez accès à un référentiel privé, vous pouvez cloner le bloc-notes dans votre projet.

• Si vous n'avez pas accès à un référentiel privé, vous ne pouvez pas cloner le bloc-notes à partir de la page de prévisualisation de Studio Lab.

Les sections suivantes présentent deux options permettant de copier un bloc-notes GitHub dans votre projet Studio Lab. Ces options dépendent de la présence ou non d'un bouton Ouvrir dans Studio Lab dans le bloc-notes.

Option 1 : copier un bloc-notes avec un bouton Ouvrir dans Studio Lab

La procédure suivante indique comment copier un bloc-notes doté d'un bouton Ouvrir dans Studio Lab. Si vous souhaitez ajouter ce bouton à votre bloc-notes, veuillez consulter Ajout d'un bouton Ouvrir dans Studio Lab dans votre bloc-notes.

1. Connectez-vous à Studio Lab en suivant les étapes décrites dans Se connecter à Studio Lab.

2. Dans un nouvel onglet du navigateur, accédez au bloc-notes GitHub que vous souhaitez cloner.

3. Dans le bloc-notes, sélectionnez le bouton Ouvrir dans Studio Lab pour ouvrir une nouvelle page dans Studio Lab avec un aperçu du bloc-notes.

4. Si l'exécution de votre projet n'est pas déjà en cours, démarrez-la en choisissant l'option Démarrer l'exécution en haut de la page d'aperçu. Attendez le démarrage de l'exécution avant de passer à l'étape suivante.

5. Une fois l'exécution du projet démarrée, sélectionnez Copier dans le projet pour ouvrir l'exécution du projet dans un nouvel onglet du navigateur.

6. Dans la boîte de dialogue Copy from GitHub? (Copier à partir de GitHub ?), sélectionnez Copy notebook only (Copier le bloc-notes uniquement). Le fichier du bloc-notes est copié dans votre projet.

Option 2 : cloner n'importe quel bloc-notes GitHub

La procédure suivante indique comment copier n'importe quel bloc-notes depuis GitHub.

1. Accédez au bloc-notes dans GitHub.

2. Dans la barre d'adresse du navigateur, modifiez l'URL du bloc-notes, comme suit.

   # Original URL
   https://github.com/<PATH_TO_NOTEBOOK>
   
   # Modified URL 
   https://studiolab.sagemaker.aws/import/github/<PATH_TO_NOTEBOOK>

3. Accédez à l'URL modifiée. Une prévisualisation du bloc-notes s'ouvre dans Studio Lab.

4. Si l'exécution de votre projet n'est pas déjà en cours, démarrez-la en choisissant l'option Démarrer l'exécution en haut de la page d'aperçu. Attendez le démarrage de l'exécution avant de passer à l'étape suivante.

5. Une fois l'exécution du projet démarrée, sélectionnez Copier dans le projet pour ouvrir l'exécution du projet dans un nouvel onglet du navigateur.

6. Dans la boîte de dialogue Copy from GitHub? (Copier à partir de GitHub ?), sélectionnez Copy notebook only (Copier le bloc-notes uniquement) pour copier le fichier du bloc-notes dans votre projet.

Ajout d'un bouton Ouvrir dans Studio Lab dans votre bloc-notes

Lorsque vous ajoutez le bouton Ouvrir dans Studio Lab dans vos blocs-notes, d'autres utilisateurs peuvent cloner vos blocs-notes ou référentiels directement vers leurs projets Studio Lab. Si vous partagez votre bloc-notes dans un référentiel GitHub public, votre contenu sera lisible publiquement. Ne partagez pas de contenu privé, tel que des clés d'accès AWS ou des informations d'identification AWS Identity and Access Management, dans votre bloc-notes.

Pour ajouter le bouton Ouvrir dans Studio Lab sur votre bloc-notes ou votre référentiel Jupyter, ajoutez le markdown suivant en haut de votre bloc-notes ou de votre référentiel.

[![Open In SageMaker Studio Lab](https://studiolab.sagemaker.aws/studiolab.svg)](https://studiolab.sagemaker.aws/import/github/<PATH_TO_YOUR_NOTEBOOK_ON_GITHUB>)

Importer des fichiers depuis votre ordinateur

Les étapes suivantes expliquent comment importer des fichiers de votre ordinateur vers votre projet Studio Lab. 

1. Ouvrez l'exécution de projet Studio Lab.

2. Ouvrez le panneau File Browser (Navigateur de fichiers).

3. Dans la barre d'actions du panneau Navigateur de fichiers, sélectionnez le bouton Upload Files (Charger des fichiers).

4. Sélectionnez les fichiers que vous souhaitez télécharger depuis votre ordinateur local.

5. Sélectionnez Open (Ouvrir).

Vous pouvez également glisser et déposer des fichiers de votre ordinateur vers le panneau File Browser (Navigateur de fichiers).

Connexion à Amazon S3

La AWS CLI permet d'intégrer AWS à votre projet Studio Lab. Avec cette intégration, vous pouvez extraire des ressources d'Amazon S3 pour les utiliser avec vos blocs-notes Jupyter.

Pour utiliser la AWS CLI avec Studio Lab, procédez comme suit. Pour voir un bloc-notes qui décrit cette intégration, veuillez consulter Using Studio Lab with AWS Resources.

1. Installer la AWS CLI en suivant les étapes décrites dans Installing or updating the latest version of the AWS CLI.

2. Configurez vos informations d'identification AWS en suivant les étapes décrites dans Quick setup. Le rôle de votre compte AWS doit disposer d'autorisations pour accéder au compartiment Amazon S3 à partir duquel vous copiez des données.

3. Depuis votre bloc-notes Jupyter, clonez les ressources du compartiment Amazon S3, si nécessaire. La commande suivante montre comment cloner toutes les ressources d'un chemin Amazon S3 vers votre projet. Pour plus d'informations, consultez la référence de la commande AWS CLI.

   !aws s3 cp s3://<BUCKET_NAME>/<PATH_TO_RESOURCES>/ <PROJECT_DESTINATION_PATH>/ --recursive