

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.

# Utiliser des ressources externes dans Amazon SageMaker Studio Lab
Utiliser des ressources externes

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

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

**Topics**
+ [

## Utiliser les GitHub ressources
](#studio-lab-use-external-clone-github)
+ [

## Ajout d'un bouton **Ouvrir dans Studio Lab** dans votre bloc-notes
](#studio-lab-use-external-add-button)
+ [

## Importer des fichiers depuis votre ordinateur
](#studio-lab-use-external-import)
+ [

## Connexion à Amazon S3
](#studio-lab-use-external-s3)

## Utiliser les GitHub ressources


Studio Lab propose 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 GitHub des ressources 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](https://github.com/aws/studio-lab-examples#sagemaker-studio-lab-sample-notebooks).

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 GitHub dépôt


Pour cloner un GitHub dépôt 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](studio-lab-manage-runtime.md#studio-lab-manage-runtime-start). 

1. Dans Studio Lab, choisissez l'icône **Navigateur de fichiers** (![\[Black square icon representing a placeholder or empty image.\]](http://docs.aws.amazon.com/fr_fr/sagemaker/latest/dg/images/studio/icons/folder.png)) dans le menu de gauche, afin que le panneau **Navigateur de fichiers** apparaisse à gauche. 

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

1. Dans le menu de gauche, sélectionnez l'icône **Git** (![\[Black square icon representing a placeholder or empty image.\]](http://docs.aws.amazon.com/fr_fr/sagemaker/latest/dg/images/studio/icons/git.png)) pour ouvrir un nouveau menu déroulant. 

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

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

1. Sélectionnez **Clone** (Cloner). 

### Clonez des blocs-notes individuels à 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 dépôt est privé, vous êtes invité à vous y connecter GitHub depuis la page d'aperçu 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 vous permettant de copier un GitHub bloc-notes 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, consultez [Ajout d'un bouton **Ouvrir dans Studio Lab** dans votre bloc-notes](#studio-lab-use-external-add-button).

1. Connectez-vous à Studio Lab en suivant les étapes décrites dans [Se connecter à Studio Lab](studio-lab-onboard.md#studio-lab-onboard-signin).

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

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

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

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

1. Dans la **copie de GitHub ?** boîte de dialogue, sélectionnez **Copier le bloc-notes uniquement**. Le fichier du bloc-notes est copié dans votre projet.

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


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

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

1. 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>
   ```

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

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

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

1. Dans la **copie de GitHub ?** boîte de dialogue, sélectionnez **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 GitHub référentiel public, votre contenu sera lisible par le public. Ne partagez pas de contenu privé, tel que des clés AWS d'accès ou des Gestion des identités et des accès AWS informations d'identification, 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. 

1. Ouvrez le panneau **File Browser** (Navigateur de fichiers). 

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

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

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


 AWS CLI Permet l' AWS intégration dans 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 l'utiliser AWS CLI avec Studio Lab, procédez comme suit. Pour un bloc-notes décrivant cette intégration, voir [Utilisation de Studio Lab avec AWS les ressources](https://github.com/aws/studio-lab-examples/blob/main/connect-to-aws/Access_AWS_from_Studio_Lab.ipynb).

1. Procédez AWS CLI comme suit dans la section [Installation ou mise à jour de la dernière version du AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html). 

1. Configurez vos AWS informations d'identification en suivant les étapes de la [section Configuration rapide](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-quickstart.html). Le rôle associé à votre AWS compte doit être autorisé à accéder au compartiment Amazon S3 à partir duquel vous copiez les données. 

1. 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3/cp.html).

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