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.
# Créez une instance de bloc-notes avec un référentiel Git associé
**Important**
Les politiques IAM personnalisées qui permettent à Amazon SageMaker Studio ou Amazon SageMaker Studio Classic de créer des SageMaker ressources Amazon doivent également accorder des autorisations pour ajouter des balises à ces ressources. L’autorisation d’ajouter des balises aux ressources est requise, car Studio et Studio Classic balisent automatiquement toutes les ressources qu’ils créent. Si une politique IAM autorise Studio et Studio Classic à créer des ressources mais n'autorise pas le balisage, des erreurs « AccessDenied » peuvent se produire lors de la tentative de création de ressources. Pour de plus amples informations, veuillez consulter [Fournir des autorisations pour le balisage des ressources d' SageMaker IA](security_iam_id-based-policy-examples.md#grant-tagging-permissions).
[AWS politiques gérées pour Amazon SageMaker AI](security-iam-awsmanpol.md)qui donnent des autorisations pour créer des SageMaker ressources incluent déjà des autorisations pour ajouter des balises lors de la création de ces ressources.
Vous pouvez associer des référentiels Git à une instance de bloc-notes lorsque vous créez l'instance de bloc-notes à l'aide du AWS Management Console, ou du AWS CLI. Si vous souhaitez utiliser un CodeCommit référentiel qui se trouve dans un AWS compte différent de celui de l'instance du bloc-notes, configurez un accès entre comptes pour le référentiel. Pour plus d'informations, consultez [Associer un CodeCommit référentiel d'un autre AWS compte à une instance de bloc-notes](nbi-git-cross.md).
**Topics**
+ [Créez une instance de bloc-notes avec un référentiel Git associé (Console)](#nbi-git-create-console)
+ [Créez une instance de bloc-notes avec un référentiel Git associé (CLI)](nbi-git-create-cli.md)
## Créez une instance de bloc-notes avec un référentiel Git associé (Console)
**Pour créer une instance de bloc-notes et associer des référentiels Git dans la console Amazon SageMaker AI**
1. Suivez les instructions décrites dans [Création d'une instance Amazon SageMaker Notebook pour le didacticiel](gs-setup-working-env.md).
1. Pour **Git repositories (Référentiels Git)**, choisissez les référentiels Git à associer à l’instance de bloc-notes.
1. Pour **Référentiel par défaut**, choisissez le référentiel que vous souhaitez utiliser comme référentiel par défaut. SageMaker AI clone ce dépôt en tant que sous-répertoire dans le répertoire de démarrage de Jupyter à l'adresse. `/home/ec2-user/SageMaker` Lorsque vous ouvrez votre instance de bloc-notes, cette dernière s’ouvre dans ce référentiel. Pour choisir un référentiel stocké en tant que ressource dans votre compte, choisissez son nom dans la liste. Pour ajouter un nouveau référentiel en tant que ressource dans votre compte, choisissez **Ajouter un référentiel à SageMaker AI (ouvre le flux Ajouter un référentiel dans une nouvelle fenêtre)**, puis suivez les instructions sur[Créez une instance de bloc-notes avec un référentiel Git associé (Console)](#nbi-git-create-console). Pour cloner un référentiel public qui n’est pas stocké dans votre compte, choisissez **Clone a public Git repository to this notebook instance only (Cloner un référentiel Git public vers cette instance de bloc-notes uniquement)**, puis spécifiez l’URL de ce référentiel.
1. Pour **Référentiel supplémentaire 1**, choisissez le référentiel que vous souhaitez ajouter en tant que répertoire supplémentaire. SageMaker AI clone ce dépôt en tant que sous-répertoire dans le répertoire de démarrage de Jupyter à l'adresse. `/home/ec2-user/SageMaker` Pour choisir un référentiel stocké en tant que ressource dans votre compte, choisissez son nom dans la liste. Pour ajouter un nouveau référentiel en tant que ressource dans votre compte, choisissez **Ajouter un référentiel à SageMaker AI (ouvre le flux Ajouter un référentiel dans une nouvelle fenêtre)**, puis suivez les instructions sur[Créez une instance de bloc-notes avec un référentiel Git associé (Console)](#nbi-git-create-console). Pour cloner un référentiel qui n’est pas stocké dans votre compte, choisissez **Clone a public Git repository to this notebook instance only (Cloner un référentiel Git public vers cette instance de bloc-notes uniquement)**, puis spécifiez l’URL de ce référentiel.
Répétez cette étape jusqu’à trois fois pour ajouter trois référentiels supplémentaires maximum à votre instance de bloc-notes.
# Créez une instance de bloc-notes avec un référentiel Git associé (CLI)
**Important**
Les politiques IAM personnalisées qui permettent à Amazon SageMaker Studio ou Amazon SageMaker Studio Classic de créer des SageMaker ressources Amazon doivent également accorder des autorisations pour ajouter des balises à ces ressources. L’autorisation d’ajouter des balises aux ressources est requise, car Studio et Studio Classic balisent automatiquement toutes les ressources qu’ils créent. Si une politique IAM autorise Studio et Studio Classic à créer des ressources mais n'autorise pas le balisage, des erreurs « AccessDenied » peuvent se produire lors de la tentative de création de ressources. Pour de plus amples informations, veuillez consulter [Fournir des autorisations pour le balisage des ressources d' SageMaker IA](security_iam_id-based-policy-examples.md#grant-tagging-permissions).
[AWS politiques gérées pour Amazon SageMaker AI](security-iam-awsmanpol.md)qui donnent des autorisations pour créer des SageMaker ressources incluent déjà des autorisations pour ajouter des balises lors de la création de ces ressources.
Pour créer une instance de bloc-notes et associer des référentiels Git à l’aide de l’ AWS CLI, utilisez la commande `create-notebook-instance` comme suit :
+ Spécifiez le référentiel à utiliser comme référentiel par défaut en tant que valeur de l’argument `default-code-repository`. Amazon SageMaker AI clone ce référentiel en tant que sous-répertoire dans le répertoire de démarrage de Jupyter à l'adresse. `/home/ec2-user/SageMaker` Lorsque vous ouvrez votre instance de bloc-notes, cette dernière s’ouvre dans ce référentiel. Pour utiliser un référentiel stocké en tant que ressource dans votre compte SageMaker AI, spécifiez le nom du référentiel comme valeur de l'`default-code-repository`argument. Pour utiliser un référentiel qui n’est pas stocké dans votre compte, spécifiez l’URL du référentiel en tant que valeur de l’argument `default-code-repository`.
+ Spécifiez jusqu'à trois référentiels supplémentaires comme valeur de l'`additional-code-repositories`argument. SageMaker AI clone ce référentiel en tant que sous-répertoire dans le répertoire de démarrage de Jupyter à l'adresse`/home/ec2-user/SageMaker`, et le référentiel est exclu du référentiel par défaut en l'ajoutant au `.git/info/exclude` répertoire du référentiel par défaut. Pour utiliser des référentiels stockés sous forme de ressources dans votre compte SageMaker AI, spécifiez le nom des référentiels comme valeur de l'`additional-code-repositories`argument. Pour utiliser des référentiels qui ne sont pas stockés dans votre compte, spécifiez le URLs référentiel comme valeur de l'`additional-code-repositories`argument.
Par exemple, la commande suivante crée une instance de bloc-notes dotée d'un référentiel nommé`MyGitRepo`, stocké en tant que ressource dans votre compte SageMaker AI, en tant que référentiel par défaut, et d'un référentiel supplémentaire hébergé sur GitHub :
```
aws sagemaker create-notebook-instance \
--notebook-instance-name "MyNotebookInstance" \
--instance-type "ml.t2.medium" \
--role-arn "arn:aws:iam::012345678901:role/service-role/AmazonSageMaker-ExecutionRole-20181129T121390" \
--default-code-repository "MyGitRepo" \
--additional-code-repositories "https://github.com/myprofile/my-other-repo"
```
**Note**
Si vous utilisez un AWS CodeCommit référentiel dont le nom ne contient pas SageMaker « », ajoutez les `codecommit:GitPush` autorisations `codecommit:GitPull` et au rôle que vous transmettez en `role-arn` argument à la `create-notebook-instance` commande. Pour obtenir des informations sur l’ajout d’autorisations à un rôle, consultez [Ajout et suppression de politiques IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) dans le *Guide de l’utilisateur Gestion des identités et des accès AWS *.