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.
# Commencer à utiliser Git et AWS CodeCommit
Si vous utilisez Git pour la première CodeCommit fois, ce didacticiel vous aide à apprendre quelques commandes simples pour démarrer. Si vous êtes déjà familiarisé avec Git, vous pouvez ignorer ce didacticiel et accéder à [Commencer avec CodeCommit ](getting-started-cc.md).
Dans ce didacticiel, vous allez créer un dépôt qui représente une copie locale du CodeCommit référentiel, que nous appelons dépôt local.
Après avoir créé le dépôt local, vous devez y apporter quelques modifications. Ensuite, vous envoyez (push) vos modifications au CodeCommit dépôt.
Vous simulez également un environnement d'équipe dans lequel deux utilisateurs valident indépendamment les modifications apportées à leur dépôt local et les transmettent au CodeCommit référentiel. Les utilisateurs extraient ensuite les modifications du CodeCommit référentiel vers leur propre dépôt local pour voir les modifications apportées par l'autre utilisateur.
Vous créez également des branches et des tags et gérez certaines autorisations d'accès dans le CodeCommit référentiel.
Après avoir terminé ce didacticiel, vous devriez avoir acquis suffisamment de pratique avec les principaux concepts Git et CodeCommit pour les utiliser dans vos propres projets.
Exécutez [les prérequis et la configuration](setting-up.md) :
+ Attribuez des autorisations à l'utilisateur IAM.
+ Configurez CodeCommit pour vous connecter à un référentiel via [HTTPS](setting-up-gc.md), SSH ou [**git-remote-codecommit**](setting-up-git-remote-codecommit.md). Pour plus d'informations sur ces choix, consultez [Configuration pour AWS CodeCommit](setting-up.md).
+ Configurez le AWS CLI si vous souhaitez utiliser la ligne de commande ou le terminal pour toutes les opérations, y compris la création du référentiel.
**Topics**
+ [Étape 1 : Création d'un CodeCommit référentiel](#getting-started-create-repo)
+ [Étape 2 : créer un dépôt local](#getting-started-set-up-folders)
+ [Étape 3 : Créez votre premier commit](#getting-started-create-commit)
+ [Étape 4 : Pussez votre premier commit](#getting-started-init-repo)
+ [Étape 5 : partager le CodeCommit dépôt, puis envoyer et extraire un autre commit](#getting-started-pull-commits)
+ [Étape 6 : créer et partager une branche](#getting-started-branching)
+ [Étape 7 : créer et partager un tag](#getting-started-tags)
+ [Étape 8 : configurer les autorisations d'accès](#getting-started-permissions)
+ [Étape 9 : nettoyer](#getting-started-clean-up)
## Étape 1 : Création d'un CodeCommit référentiel
Au cours de cette étape, vous devez utiliser la CodeCommit console pour créer le référentiel.
Vous pouvez ignorer cette étape si vous avez déjà un CodeCommit dépôt que vous souhaitez utiliser.
**Note**
En fonction de votre utilisation, la création ou l'accès à un référentiel peuvent vous être facturés. Pour plus d'informations, consultez la section [Tarification](https://aws.amazon.com/codecommit/pricing) sur la page d'informations CodeCommit du produit.
**Pour créer le CodeCommit référentiel**
1. Ouvrez la CodeCommit console sur [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home).
1. Utilisez le sélecteur de région pour choisir l' Région AWS endroit où vous souhaitez créer le référentiel. Pour de plus amples informations, veuillez consulter [Régions et points de terminaison de connexion Git](regions.md).
1. Dans la page **Référentiels**, choisissez **Créer un référentiel**.
1. Sur la page **Créer un référentiel**, pour **Nom du référentiel**, entrez un nom pour votre référentiel (par exemple, **MyDemoRepo**).
**Note**
Les noms des référentiels sont sensibles à la casse et ne peuvent pas comporter plus de 100 caractères. Pour plus d’informations, consultez [Limites ](limits.md#limits-repository-names).
1. (Facultatif) Dans **Description**, saisissez une description (par exemple, **My demonstration repository**). Cela peut aider d'autres utilisateurs et vous-même à identifier la fonction du référentiel.
1. (Facultatif) Choisissez **Ajouter une balise** pour ajouter une ou plusieurs balises de référentiel (étiquette d'attribut personnalisée qui vous aide à organiser et à gérer vos AWS ressources) à votre référentiel. Pour de plus amples informations, veuillez consulter [Marquage des référentiels dans AWS CodeCommit](how-to-tag-repository.md).
1. (Facultatif) Développez **la configuration supplémentaire** pour indiquer si vous souhaitez utiliser la clé par défaut Clé gérée par AWS ou la clé gérée par le client pour chiffrer et déchiffrer les données de ce référentiel. Si vous choisissez d'utiliser votre propre clé gérée par le client, vous devez vous assurer qu'elle est disponible Région AWS là où vous créez le référentiel et que la clé est active. Pour de plus amples informations, veuillez consulter [AWS Key Management Service et chiffrement pour les AWS CodeCommit référentiels](encryption.md).
1. (Facultatif) Sélectionnez **Activer Amazon CodeGuru Reviewer pour Java et Python** si ce référentiel doit contenir du code Java ou Python et que vous souhaitez que CodeGuru Reviewer analyse ce code. CodeGuru Reviewer utilise plusieurs modèles d'apprentissage automatique pour détecter les défauts du code et pour suggérer automatiquement des améliorations et des corrections dans les pull requests. Pour plus d'informations, consultez le guide de l'utilisateur Amazon CodeGuru Reviewer.
1. Choisissez **Créer**.
**Note**
Les étapes restantes de ce `MyDemoRepo` didacticiel concernent le nom du CodeCommit référentiel. Si vous choisissez un autre nom, veillez à l'utiliser tout au long de ce didacticiel.
Pour plus d'informations sur la création de référentiels, notamment la création d'un référentiel depuis le terminal ou la ligne de commande, consultez [Création d'un référentiel ](how-to-create-repository.md).
## Étape 2 : créer un dépôt local
Dans cette étape, vous configurez un référentiel local sur votre ordinateur local pour vous connecter à votre référentiel. Pour ce faire, vous sélectionnez sur votre ordinateur local un répertoire qui représente le référentiel local. Vous utilisez Git pour cloner et initialiser une copie de votre CodeCommit dépôt vide dans ce répertoire. Ensuite, vous spécifiez le nom d'utilisateur Git et l'adresse e-mail utilisés pour annoter vos validations.
1. Ouvrez la CodeCommit console sur [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home).
1. Dans le sélecteur de région, choisissez l' Région AWS endroit où le référentiel a été créé. Les référentiels sont spécifiques à un Région AWS. Pour de plus amples informations, veuillez consulter [Régions et points de terminaison de connexion Git](regions.md).
1. Trouvez le référentiel auquel vous souhaitez vous connecter dans la liste et choisissez-le. Choisissez **Clone URL (Cloner URL)**, puis choisissez le protocole que vous souhaitez utiliser lors du clonage ou de la connexion au référentiel. Cette opération copie l'URL de clonage.
+ Copiez l'URL HTTPS si vous utilisez les informations d'identification Git avec votre utilisateur IAM ou l'assistant d'identification inclus dans le. AWS CLI
+ Copiez l'URL HTTPS (GRC) si vous utilisez la commande **git-remote-codecommit** sur votre ordinateur local.
+ Copiez l'URL SSH si vous utilisez une paire de public/private clés SSH avec votre utilisateur IAM.
**Note**
Si vous voyez une page de **bienvenue** au lieu d'une liste de référentiels, aucun référentiel n'est associé à votre AWS compte dans l' Région AWS endroit où vous êtes connecté. Pour créer un référentiel, consultez [Création d'un AWS CodeCommit référentiel](how-to-create-repository.md) ou suivez les étapes du didacticiel [Commencer à utiliser Git et CodeCommit](#getting-started).
1. (Facultatif) Nous vous recommandons de configurer votre client Git local pour l'utiliser **main** comme nom de la branche par défaut de votre dépôt. Il s'agit du nom utilisé pour la branche par défaut dans tous les exemples de ce guide. Il s'agit également du même nom de branche par défaut que celui CodeCommit utilisé si vous effectuez votre premier commit dans la console. Exécutez la commande suivante pour configurer le nom de branche par défaut de manière globale pour votre système :
```
git config --global init.defaultBranch main
```
Si vous préférez utiliser un nom de branche par défaut différent pour tous vos référentiels, remplacez-le par le nom **main** de votre choix. Ce didacticiel part du principe que votre branche par défaut est nommée *main*.
Si vous souhaitez utiliser différents noms de branche par défaut pour différents référentiels, vous pouvez définir cet attribut localement (**--local**) plutôt que globalement (**--global**).
1. Sur le terminal ou à l'invite de commande, clonez le référentiel à l'aide de la **git clone** commande et fournissez l'URL de clonage que vous avez copiée à l'étape 3. L'URL de votre clone dépend du protocole et de la configuration que vous utilisez. Par exemple, si vous utilisez le protocole HTTPS avec des informations d'identification Git pour cloner un dépôt nommé *MyDemoRepo* dans la région USA Est (Ohio) :
```
git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo
```
Si vous utilisez HTTPS avec **git-remote-codecommit** :
```
git clone codecommit://MyDemoRepo my-demo-repo
```
Si vous utilisez SSH :
```
git clone ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo
```
**Note**
Si une erreur s'affiche lorsque vous tentez de cloner un référentiel, vous n'avez peut-être pas terminé l'installation nécessaire pour votre ordinateur local. Pour de plus amples informations, veuillez consulter [Configuration pour AWS CodeCommit](setting-up.md).
## Étape 3 : Créez votre premier commit
Au cours de cette étape, vous créez votre premier commit dans votre dépôt local. Pour ce faire, vous devez créer deux exemples de fichiers dans votre dépôt local. Vous utilisez Git pour préparer la modification dans votre dépôt local, puis pour la valider dans celui-ci.
1. Utilisez un éditeur de texte pour créer les deux exemples de fichiers de texte suivants dans votre répertoire. Nommez les fichiers `cat.txt` et `dog.txt` :
```
cat.txt
-------
The domestic cat (Felis catus or Felis silvestris catus) is a small, usually furry, domesticated, and carnivorous mammal.
```
```
dog.txt
-------
The domestic dog (Canis lupus familiaris) is a canid that is known as man's best friend.
```
1. Exécutez **git config** pour ajouter votre nom d'utilisateur et votre adresse e-mail représentés par des espaces réservés *your-user-name* et *your-email-address* à votre dépôt local. Cela facilite l'identification des validations que vous effectuez :
```
git config --local user.name "your-user-name"
git config --local user.email your-email-address
```
1. Si vous n'avez pas défini votre nom de branche par défaut globalement lorsque vous avez créé le dépôt local, exécutez la commande suivante pour définir le nom de branche par défaut comme suit : **main**
```
git config --local init.defaultBranch main
```
1. Exécutez **git add** pour effectuer une copie intermédiaire de la modification :
```
git add cat.txt dog.txt
```
1. Exécutez **git commit** pour valider la modification :
```
git commit -m "Added cat.txt and dog.txt"
```
**Astuce**
Pour afficher les détails relatifs à la validation que vous venez d'effectuer, exécutez **git log**.
## Étape 4 : Pussez votre premier commit
Au cours de cette étape, vous devez transférer le commit de votre dépôt local vers votre CodeCommit dépôt.
Exécutez **git push** pour transférer votre commit via le nom distant par défaut que Git utilise pour votre CodeCommit dépôt (`origin`), à partir de la branche par défaut de votre dépôt local (`main`) :
```
git push -u origin main
```
**Astuce**
Après avoir transféré des fichiers vers votre CodeCommit dépôt, vous pouvez utiliser la CodeCommit console pour en afficher le contenu. Pour de plus amples informations, veuillez consulter [Parcourir les fichiers d'un référentiel](how-to-browse.md).
## Étape 5 : partager le CodeCommit dépôt, puis envoyer et extraire un autre commit
Au cours de cette étape, vous partagez des informations sur le CodeCommit référentiel avec un autre membre de l'équipe. Le membre de l'équipe utilise ces informations pour obtenir une copie locale, y apporter des modifications, puis transférer la copie locale modifiée dans votre CodeCommit référentiel. Vous extrayez ensuite les modifications du CodeCommit référentiel vers votre dépôt local.
Dans ce didacticiel, vous simulez l'autre utilisateur en demandant à Git de créer un répertoire distinct de celui que vous avez créé à l'[étape 2](#getting-started-set-up-folders). (Généralement, ce répertoire se situe sur un autre ordinateur.) Ce nouveau répertoire est une copie de votre CodeCommit dépôt. Toutes les modifications que vous apportez au répertoire existant ou à ce nouveau répertoire sont effectuées indépendamment. La seule façon d'identifier les modifications apportées à ces répertoires est de les extraire du CodeCommit référentiel.
Même si ces répertoires sont situés sur le même ordinateur local, nous appelons le répertoire existant votre *référentiel local* et le nouveau répertoire, le *référentiel partagé*.
À partir du nouveau répertoire, vous obtenez une copie séparée du CodeCommit référentiel. Vous ajoutez ensuite un nouveau fichier d'exemple, vous validez les modifications dans le dépôt partagé, puis vous transférez le commit du dépôt partagé vers votre CodeCommit référentiel.
Enfin, vous extrayez les modifications de votre dépôt vers votre dépôt local, puis vous le parcourez pour voir les modifications validées par l'autre utilisateur.
1. Passez au répertoire `/tmp` ou `c:\temp`.
1. Exécutez **git clone** pour transmettre une copie du référentiel vers le référentiel partagé :
Pour HTTPS :
```
git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo shared-demo-repo
```
Pour HTTPS avec **git-remote-codecommit** :
```
git clone codecommit://MyDemoRepo shared-demo-repo
```
Pour SSH :
```
git clone ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo shared-demo-repo
```
**Note**
Lorsque vous clonez un référentiel à l'aide de SSH sur des systèmes d'exploitation Windows, vous devez ajouter l'ID de clé SSH à la chaîne de connexion comme suit :
```
git clone ssh://Your-SSH-Key-ID@git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo
```
Pour de plus amples informations, veuillez consulter [Pour les connexions SSH sous Windows](setting-up-ssh-windows.md).
Dans cette commande, `MyDemoRepo` se trouve le nom de votre CodeCommit dépôt. `shared-demo-repo`est le nom du répertoire que Git crée dans le `/tmp` répertoire ou le `c:\temp` répertoire. Une fois que Git a créé le répertoire, il extrait une copie du référentiel dans le répertoire `shared-demo-repo`.
1. Passez au répertoire `shared-demo-repo` :
```
(For Linux, macOS, or Unix) cd /tmp/shared-demo-repo
(For Windows) cd c:\temp\shared-demo-repo
```
1. Exécutez **git config** pour ajouter un autre nom d'utilisateur et une autre adresse e-mail représentés par des espaces réservés *other-user-name* et*other-email-address*. Cela permet d'identifier plus facilement les validations effectuées par l'autre utilisateur :
```
git config --local user.name "other-user-name"
git config --local user.email other-email-address
```
1. Utilisez un éditeur de texte pour créer l'exemple de fichier texte suivant dans le répertoire `shared-demo-repo`. Nommez le fichier `horse.txt`:
```
horse.txt
-------
The horse (Equus ferus caballus) is one of two extant subspecies of Equus ferus.
```
1. Exécutez **git add** pour effectuer une copie intermédiaire de la modification dans le référentiel partagé :
```
git add horse.txt
```
1. Exécutez **git commit** pour valider la modification dans le référentiel partagé :
```
git commit -m "Added horse.txt"
```
1. Exécutez **git push** pour transférer votre validation initiale via le nom distant par défaut que Git utilise pour votre CodeCommit dépôt (`origin`), à partir de la branche par défaut de votre dépôt local (`main`) :
```
git push -u origin main
```
1. Passez à votre dépôt local et exécutez **git pull** pour extraire dans votre dépôt local le commit que le dépôt partagé a effectué dans le référentiel. CodeCommit Puis exécutez **git log** pour voir la validation qui a été initiée depuis le référentiel partagé.
## Étape 6 : créer et partager une branche
Au cours de cette étape, vous créez une branche dans votre dépôt local, vous apportez quelques modifications, puis vous transférez la branche vers votre CodeCommit référentiel. Vous extrayez ensuite la branche de votre CodeCommit dépôt vers le dépôt partagé.
Une branche vous permet de développer indépendamment une version différente du contenu du référentiel (par exemple, pour travailler sur une nouvelle fonctionnalité logicielle sans affecter le travail des membres de votre équipe). Lorsque cette fonctionnalité est stable, vous fusionnez la branche avec une branche plus stable du logiciel.
Vous utilisez Git pour créer la branche, puis la faites pointer sur la première validation que vous avez effectuée. Vous utilisez Git pour transférer la branche vers le CodeCommit dépôt. Vous passez ensuite à votre dépôt partagé et utilisez Git pour insérer la nouvelle branche dans votre dépôt local partagé et explorer la branche.
1. À partir de votre dépôt local**git checkout**, exécutez en spécifiant le nom de la branche (par exemple,`MyNewBranch`) et l'ID du premier commit que vous avez effectué dans le dépôt local.
Si vous ne connaissez pas l'ID de validation, exécutez **git log** pour l'obtenir. Assurez-vous que la validation comporte votre nom d'utilisateur et votre adresse e-mail, et non le nom d'utilisateur et l'adresse e-mail de l'autre utilisateur. Ceci est pour simuler qu'`main`il s'agit d'une version stable du CodeCommit référentiel et que la `MyNewBranch` branche est destinée à une nouvelle fonctionnalité relativement instable :
```
git checkout -b MyNewBranch commit-ID
```
1. Exécutez **git push** pour envoyer la nouvelle branche du dépôt local vers le CodeCommit référentiel :
```
git push origin MyNewBranch
```
1. A présent, extrayez la branche dans le référentiel partagé et vérifiez vos résultats :
1. Basculez vers le répertoire du référentiel partagé (shared-demo-repo).
1. Extrayez la nouvelle branche (**git fetch origin**).
1. Vérifiez que la branche a été extraite dans (**git branch --all** affiche une liste de toutes les branches pour le référentiel).
1. Switch to the new branch (**git checkout MyNewBranch**).
1. Vérifiez que vous avez basculé vers la branche `MyNewBranch` en exécutant la commande **git status** ou **git branch**. La sortie montre dans quelle branche vous vous trouvez. Dans ce cas, il doit s'agir de `MyNewBranch`.
1. Affichez la liste des validations dans la branche (**git log**).
Voici la liste des commandes Git à appeler :
```
git fetch origin
git branch --all
git checkout MyNewBranch
git branch or git status
git log
```
1. Revenez dans la branche `main` et affichez la liste des validations. Les commandes Git devraient ressembler à ceci :
```
git checkout main
git log
```
1. Passez à la `main` branche de votre dépôt local. Vous pouvez exécuter **git status** ou **git branch**. La sortie montre dans quelle branche vous vous trouvez. Dans ce cas, il doit s'agir de `main`. Les commandes Git devraient ressembler à ceci :
```
git checkout main
git branch or git status
```
## Étape 7 : créer et partager un tag
Au cours de cette étape, vous créez deux balises dans votre dépôt local, associez les balises à des validations, puis transférez les balises vers votre CodeCommit référentiel. Vous extrayez ensuite les modifications du CodeCommit référentiel vers le dépôt partagé.
Une balise est utilisée pour donner un nom plus explicite à une validation (ou une branche, ou même une autre balise). Vous en utilisez, par exemple, si vous souhaitez baliser une validation en tant que `v2.1`. Plusieurs balises peuvent être associées à une validation, une branche ou une balise, mais une balise individuelle ne peut être associée qu'à une seule validation, branche ou balise. Dans ce didacticiel, vous balisez une validation en tant que `release` et une validation en tant que `beta`.
Vous utilisez Git pour créer les balises, en faisant pointer la balise `release` sur la première validation que vous avez effectuée et la balise `beta` sur la validation exécutée par l'autre utilisateur. Vous utilisez ensuite Git pour transférer les balises vers le CodeCommit dépôt. Vous passez ensuite à votre dépôt partagé et utilisez Git pour extraire les balises dans votre dépôt local partagé et explorer les balises.
1. À partir de votre dépôt local**git tag**, exécutez en spécifiant le nom de la nouvelle balise (`release`) et l'ID du premier commit que vous avez effectué dans le dépôt local.
Si vous ne connaissez pas l'ID de validation, exécutez **git log** pour l'obtenir. Assurez-vous que la validation comporte votre nom d'utilisateur et votre adresse e-mail, et non le nom d'utilisateur et l'adresse e-mail de l'autre utilisateur. Cela permet de simuler que votre commit est une version stable du CodeCommit dépôt :
```
git tag release commit-ID
```
Exécutez à nouveau **git tag** pour baliser la validation effectuée par l'autre utilisateur avec la balise `beta`. Ceci vise à simuler que la validation est destinée à une nouvelle fonctionnalité relativement instable :
```
git tag beta commit-ID
```
1. Exécutez **git push --tags** pour envoyer les balises au CodeCommit référentiel.
1. A présent, extrayez les balises dans le référentiel partagé et vérifiez vos résultats :
1. Basculez vers le répertoire du référentiel partagé (shared-demo-repo).
1. Extrayez les nouvelles balises (**git fetch origin**).
1. Vérifiez que les balises ont été extraite (**git tag** affiche une liste des balises pour le référentiel).
1. Consultez les informations sur chaque balise (**git log release** et **git log beta**).
Voici la liste des commandes Git à appeler :
```
git fetch origin
git tag
git log release
git log beta
```
1. Essayez également ceci dans le dépôt local :
```
git log release
git log beta
```
## Étape 8 : configurer les autorisations d'accès
Au cours de cette étape, vous autorisez un utilisateur à synchroniser le dépôt partagé avec le CodeCommit référentiel. Il s'agit d'une étape facultative. Il est recommandé aux utilisateurs qui souhaitent savoir comment contrôler l'accès aux CodeCommit référentiels lorsque les utilisateurs utilisent des informations d'identification Git ou que des paires de clés SSH sont utilisées avec des utilisateurs IAM pour accéder aux référentiels. CodeCommit
**Note**
Si vous utilisez un accès fédéré, des informations d'identification temporaires ou un fournisseur d'identité Web tel que IAM Identity Center, configurez les utilisateurs, les accès et les autorisations pour votre fournisseur d'identité, puis utilisez. **git-remote-codecommit** Pour plus d’informations, consultez [Étapes de configuration pour les connexions HTTPS AWS CodeCommit avec git-remote-codecommit](setting-up-git-remote-codecommit.md) et [Connexion aux AWS CodeCommit référentiels avec des informations d'identification rotatives](temporary-access.md).
Pour ce faire, vous utilisez la console IAM pour créer un utilisateur qui, par défaut, n'est pas autorisé à synchroniser le dépôt partagé avec le CodeCommit référentiel. Vous pouvez exécuter **git pull** pour le vérifier. Si le nouvel utilisateur n'est pas autorisé à synchroniser, la commande ne fonctionne pas. Vous revenez ensuite à la console IAM et vous appliquez une politique qui autorise l'utilisateur à utiliser**git pull**. Là encore, vous pouvez exécuter **git pull** pour le vérifier.
Cette étape part du principe que vous êtes autorisé à créer des utilisateurs IAM dans votre compte Amazon Web Services. Si vous ne disposez pas de ces autorisations, vous ne pouvez pas effectuer les procédures décrites dans cette étape. Passez à [Étape 9 : nettoyer](#getting-started-clean-up) pour nettoyer les ressources que vous avez utilisées pour votre didacticiel.
1. Connectez-vous à la console IAM AWS Management Console et ouvrez-la à [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)l'adresse.
Veillez à vous connecter avec les mêmes nom d'utilisateur et mot de passe que ceux utilisés dans [Configuration ](setting-up.md).
1. Dans le volet de navigation, choisissez **Users**, puis **Create New Users**.
1. Dans la première zone **Enter User Names (Saisir les noms d'utilisateur)**, saisissez un exemple de nom d'utilisateur (par exemple, **JaneDoe-CodeCommit**). Cochez la case **Generate an access key for each user (Générer une clé d'accès pour chaque utilisateur)** et choisissez **Create (Créer)**.
1. Sélectionnez **Show User Security Credentials**. Notez l'ID de clé d'accès et la clé d'accès secrète, ou choisissez **Télécharger les informations d'identification**.
1. Suivez les instructions [Pour les utilisateurs HTTPS utilisant les informations d'identification Git](setting-up-gc.md) pour générer et fournir les informations d'identification de l'utilisateur IAM.
Si vous souhaitez utiliser SSH, suivez les instructions de [SSH et Linux, macOS ou Unix : configurez les clés publiques et privées pour Git et CodeCommit](setting-up-ssh-unixes.md#setting-up-ssh-unixes-keys-unixes) ou [Étape 3 : configurer les clés publiques et privées pour Git et CodeCommit](setting-up-ssh-windows.md#setting-up-ssh-windows-keys-windows) pour configurer l'utilisateur avec des clés publiques et privées.
1. Exécutez **git pull**. L'erreur suivante doit apparaître :
Pour HTTPS :
`fatal: unable to access 'https://git-codecommit.us-east-2.amazonaws.com/v1/repos/repository-name/': The requested URL returned error: 403`.
Pour SSH :
`fatal: unable to access 'ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/repository-name/': The requested URL returned error: 403`.
L'erreur apparaît parce que le nouvel utilisateur n'est pas autorisé à synchroniser le dépôt partagé avec le CodeCommit référentiel.
1. Retournez à la console IAM. Dans le volet de navigation, choisissez **Policies**, puis **Create Policy**. (Si un bouton **Mise en route** est affiché, choisissez-le, puis choisissez **Créer une stratégie**.)
1. En regard de **Create Your Own Policy** (Créez votre politique), choisissez **Select** (Sélectionner).
1. Dans la zone **Nom de la stratégie**, saisissez un nom (par exemple, **CodeCommitAccess-GettingStarted**).
1. Dans le champ **Document de stratégie**, entrez ce qui suit, qui permet à un utilisateur IAM d'extraire des données de n'importe quel référentiel associé à l'utilisateur IAM :
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codecommit:GitPull"
],
"Resource": "*"
}
]
}
```
------
**Astuce**
Si vous souhaitez que l'utilisateur IAM puisse envoyer des validations vers n'importe quel référentiel associé à l'utilisateur IAM, entrez plutôt ceci :
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codecommit:GitPull",
"codecommit:GitPush"
],
"Resource": "*"
}
]
}
```
Pour plus d'informations sur les autres autorisations d' CodeCommit action et de ressources que vous pouvez accorder aux utilisateurs, consultez[Authentification et contrôle d'accès pour AWS CodeCommit](auth-and-access-control.md).
1. Dans le panneau de navigation, choisissez **utilisateurs**.
1. Choisissez l'exemple de nom d'utilisateur (par exemple, **JaneDoe-CodeCommit**) auquel vous souhaitez attacher la stratégie.
1. Sélectionnez l’onglet **Autorisations**.
1. Dans **Managed Policies**, choisissez **Attach Policy**.
1. Sélectionnez la stratégie **CodeCommitAccess-GettingStarted** que vous venez de créer, puis choisissez **Attach Policy (Attacher la politique)**.
1. Exécutez **git pull**. Cette fois-ci, la commande va fonctionner et un message `Already up-to-date` doit apparaître.
1. Si vous utilisez HTTPS, passez à vos informations d'identification Git d'origine ou, si vous utilisez **git-remote-codecommit**, à votre profil habituel. Pour plus d'informations, consultez les instructions de [Configuration pour les utilisateurs HTTPS à l'aide des informations d'identification Git](setting-up-gc.md) ou [Étapes de configuration pour les connexions HTTPS AWS CodeCommit avec git-remote-codecommit](setting-up-git-remote-codecommit.md).
Si vous utilisez SSH, basculez vers vos clés d'origine. Pour plus d’informations, consultez [SSH et Linux, macOS ou Unix : configurez les clés publiques et privées pour Git et CodeCommit](setting-up-ssh-unixes.md#setting-up-ssh-unixes-keys-unixes) ou [Étape 3 : configurer les clés publiques et privées pour Git et CodeCommit](setting-up-ssh-windows.md#setting-up-ssh-windows-keys-windows).
Vous avez terminé ce didacticiel.
## Étape 9 : nettoyer
Au cours de cette étape, vous supprimez le CodeCommit référentiel que vous avez utilisé dans ce didacticiel. L'espace de stockage ne vous sera donc pas facturé.
Vous supprimez également le dépôt local et le dépôt partagé sur votre machine locale, car ils ne seront plus nécessaires une fois le CodeCommit dépôt supprimé.
**Important**
Une fois ce dépôt supprimé, vous ne pourrez plus le cloner dans un dépôt local ou un dépôt partagé. Vous ne pourrez pas non plus en extraire des données, ou y transférer des données, à partir d'un dépôt local ou d'un dépôt partagé. Cette action ne peut pas être annulée.
### Pour supprimer le CodeCommit référentiel (console)
1. Ouvrez la CodeCommit console sur [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home).
1. Sur la page **Dashboard (Tableau de bord)**, dans la liste des référentiels, choisissez **MyDemoRepo**.
1. Dans le panneau de navigation, sélectionnez **Settings** (Paramètres).
1. Sur la page **Settings**, dans **Delete repository**, choisissez **Delete repository**.
1. Dans la zone en regard de **Tapez le nom du référentiel pour confirmer la suppression**, saisissez **MyDemoRepo**, puis choisissez **Supprimer**.
### Pour supprimer le CodeCommit dépôt (AWS CLI)
Exécutez la commande [delete-repository](how-to-delete-repository.md#how-to-delete-repository-cli) :
```
aws codecommit delete-repository --repository-name MyDemoRepo
```
### Pour supprimer le dépôt local et le dépôt partagé
Pour Linux, macOS ou Unix :
```
cd /tmp
rm -rf /tmp/my-demo-repo
rm -rf /tmp/shared-demo-repo
```
Pour Windows :
```
cd c:\temp
rd /s /q c:\temp\my-demo-repo
rd /s /q c:\temp\shared-demo-repo
```