

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
<a name="studio-lab-use-external"></a>

**Note**  
Amazon SageMaker Studio Lab n'est plus ouvert aux nouveaux clients. Les clients existants peuvent continuer à utiliser le service normalement. AWS continue d'investir dans l'amélioration de la sécurité et de la disponibilité de Studio Lab, mais nous ne prévoyons pas d'introduire de nouvelles fonctionnalités. Pour de plus amples informations, veuillez consulter [Modification de la disponibilité de Studio Lab](studio-lab-availability-change.md). 

Avec Amazon SageMaker Studio Lab, vous pouvez intégrer des ressources externes, telles que des blocs-notes et des données Jupyter, à partir 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)
+ [Ajoutez un **Ouvrir dans Studio Lab** bouton sur 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
<a name="studio-lab-use-external-clone-github"></a>

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
<a name="studio-lab-use-external-clone-examples"></a>

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
<a name="studio-lab-use-external-clone-repo"></a>

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.](https://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.](https://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
<a name="studio-lab-use-external-clone-individual"></a>

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 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 qui vous permettent 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 le bloc-notes à l'aide d'un **Ouvrir dans Studio Lab** bouton
<a name="studio-lab-use-external-clone-individual-button"></a>

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 [Ajoutez un **Ouvrir dans Studio Lab** bouton sur 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 de 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
<a name="studio-lab-use-external-clone-individual-general"></a>

La procédure suivante montre 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.

## Ajoutez un **Ouvrir dans Studio Lab** bouton sur votre bloc-notes
<a name="studio-lab-use-external-add-button"></a>

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
<a name="studio-lab-use-external-import"></a>

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
<a name="studio-lab-use-external-s3"></a>

 AWS CLI Cela 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 des ressources](https://github.com/aws/studio-lab-examples/blob/main/connect-to-aws/Access_AWS_from_Studio_Lab.ipynb).

1. Installez en AWS CLI suivant les étapes décrites 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 disposer des autorisations nécessaires pour 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
   ```