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.
# Prise en main
Le moyen le plus simple de commencer CodeCommit est de suivre les étapes décrites dans[Commencer avec CodeCommit ](getting-started-cc.md). Si vous utilisez Git pour la première fois CodeCommit, vous devriez également envisager de suivre les étapes décrites dans[Commencer à utiliser Git et CodeCommit](getting-started.md). Cela vous permet de vous familiariser avec Git CodeCommit et de vous familiariser avec les bases de son utilisation lorsque vous interagissez avec vos CodeCommit référentiels.
Vous pouvez également suivre le didacticiel décrit dans [Simple Pipeline CodeCommit Walkthrough CodePipeline et](https://docs.aws.amazon.com/codepipeline/latest/userguide/getting-started-cc.html) apprendre à utiliser votre CodeCommit référentiel dans le cadre d'un pipeline de livraison continue.
Les didacticiels de cette section sont écrits en supposant que vous avez terminé les [prérequis et la configuration](setting-up.md), en particulier :
+ Attribuer des autorisations à l'utilisateur IAM.
+ Configuration de la gestion des informations d'identification pour les connexions HTTPS ou SSH sur l'ordinateur local que vous utilisez pour ce didacticiel.
+ Configuration du 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**
+ [
# Commencer avec AWS CodeCommit
](getting-started-cc.md)
+ [
# Commencer à utiliser Git et AWS CodeCommit
](getting-started.md)
# Commencer avec AWS CodeCommit
Ce didacticiel explique comment utiliser certaines CodeCommit fonctionnalités clés. Tout d'abord, vous créez un référentiel et y validez quelques modifications. Ensuite, vous parcourez les fichiers et affichez les modifications. Vous pouvez également créer une demande d'extraction pour que les autres utilisateurs puissent réviser et commenter les modifications apportées à votre code.
Si vous souhaitez migrer du code existant vers CodeCommit, consultez[Migrer vers AWS CodeCommit](how-to-migrate-repository.md).
Si vous n'êtes pas familier avec Git, vous pouvez aussi exécuter le didacticiel [Commencer à utiliser Git et CodeCommit](getting-started.md). Une fois ces didacticiels terminés, vous devriez avoir suffisamment d'expérience pour commencer à CodeCommit les utiliser pour vos propres projets et dans des environnements d'équipe.
La CodeCommit console inclut des informations utiles dans un panneau pliable que vous pouvez ouvrir à partir de l'icône d'informations (![\[The information icon that opens and closes the help panel on a page.\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-info-icon.png)) ou de n'importe quel lien **d'information** sur la page. Vous pouvez fermer ce panneau à tout moment.
![\[Affichage des conseils supplémentaires dans la console\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-guidance-open.png)
La CodeCommit console permet également de rechercher rapidement vos ressources, telles que des référentiels, des projets de création, des applications de déploiement et des pipelines. Choisissez **Go to ressource (Accéder aux ressources)** ou appuyez sur la touche `/`, puis saisissez le nom de la ressource. Toutes les correspondances s'affichent dans la liste. Les recherches ne sont pas sensibles à la casse. Vous pouvez uniquement consulter les ressources que vous êtes autorisé à afficher. Pour de plus amples informations, veuillez consulter [Affichage des ressources dans la console](auth-and-access-control-iam-identity-based-access-control.md#console-resources).
## Conditions préalables
Avant de commencer, vous devez compléter les opérations liées aux [prérequis et à la configuration](setting-up.md), notamment :
+ Attribuer des autorisations à l'utilisateur IAM.
+ Configuration de la gestion des informations d'identification pour les connexions HTTPS ou SSH sur l'ordinateur local que vous utilisez pour ce didacticiel.
+ Configuration du AWS CLI si vous souhaitez utiliser la ligne de commande ou le terminal pour toutes les opérations, y compris pour créer le référentiel.
**Topics**
+ [
## Conditions préalables
](#getting-started-cc-prereqs)
+ [
## Étape 1 : Création d'un CodeCommit référentiel
](#getting-started-cc-create-repo)
+ [
## Étape 2 : ajouter des fichiers à votre référentiel
](#getting-started-cc-add)
+ [
## Étape 3 : Parcourez le contenu de votre dépôt
](#getting-started-cc-browse)
+ [
## Étape 4 : Créez une pull request et collaborez sur celle-ci
](#getting-started-cc-pullrequest)
+ [
## Étape 5 : nettoyer
](#getting-started-cc-clean-up)
+ [
## Étape 6 : étapes suivantes
](#getting-started-cc-next)
## Étape 1 : Création d'un CodeCommit référentiel
Vous pouvez utiliser la CodeCommit console pour créer un CodeCommit référentiel. Si vous disposez déjà d'un référentiel que vous souhaitez utiliser pour ce didacticiel, vous pouvez ignorer cette étape.
**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**.
![\[Création d'un référentiel à partir de la console\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-create-repository.png)
**Note**
Si vous utilisez un nom autre que `MyDemoRepo` pour votre référentiel, veillez à l'utiliser dans les étapes restantes.
Lorsque le référentiel s'ouvre, vous pouvez voir des informations sur la façon d'ajouter des fichiers directement depuis la CodeCommit console.
## Étape 2 : ajouter des fichiers à votre référentiel
Vous pouvez ajouter des fichiers à votre référentiel en :
+ Création d'un fichier dans la CodeCommit console. Si vous créez le premier fichier d'un référentiel dans la console, une branche nommée *main* est créée pour vous. Cette branche est la branche par défaut de votre dépôt.
+ Téléchargement d'un fichier depuis votre ordinateur local à l'aide de la CodeCommit console. Si vous chargez le premier fichier d'un référentiel depuis la console, une branche nommée *main* est créée pour vous. Cette branche est la branche par défaut de votre dépôt.
+ Utiliser un client Git pour cloner le dépôt sur votre ordinateur local, puis ajouter, valider et transférer des fichiers vers le CodeCommit dépôt. Une branche est créée pour vous dans le cadre de ce premier commit à partir de Git, et elle est définie comme branche par défaut pour votre dépôt. Le nom de la branche est le choix par défaut de votre client Git. Envisagez de configurer votre client Git pour qu'il utilise *main* comme nom pour la branche initiale.
**Note**
Vous pouvez créer des branches et modifier la branche par défaut d'un référentiel à tout moment. Pour de plus amples informations, veuillez consulter [Utilisation de branches dans des AWS CodeCommit référentiels](branches.md).
Le moyen le plus simple de démarrer est d'ouvrir la CodeCommit console et d'ajouter un fichier. Ce faisant, vous créez également une branche par défaut pour votre dépôt nommée *main*. Pour obtenir des instructions sur la façon d'ajouter un fichier et de créer un premier commit dans un dépôt à l'aide du AWS CLI, voir [Créer le premier commit pour un dépôt à l'aide du AWS CLI](how-to-create-commit.md#create-first-commit).
**Pour ajouter un fichier au référentiel**
1. Dans la barre de navigation du référentiel, choisissez **Code**.
1. Choisissez **Ajouter un fichier**, puis choisissez de créer un fichier ou d'en charger un à partir de votre ordinateur. Ce didacticiel vous explique les deux méthodes.
1. Pour ajouter un fichier, procédez comme suit :
1. Dans la liste déroulante des branches, choisissez la branche dans laquelle vous souhaitez ajouter le fichier. La branche par défaut est sélectionnée automatiquement pour vous. Dans l'exemple présenté ici, la branche par défaut est nommée*main*. Si vous souhaitez ajouter le fichier à une autre branche, choisissez une autre branche.
1. Dans **Nom du fichier**, entrez un nom pour le fichier. Dans l'éditeur de code, entrez le code du fichier.
1. Dans **Nom de l'auteur**, saisissez le nom que vous souhaitez afficher à d'autres utilisateurs du référentiel.
1. Dans **Adresse e-mail**, saisissez une adresse e-mail.
1. (Facultatif) Dans **Message de validation**, saisissez un bref message. Bien que cette étape soit facultative, nous vous recommandons d'ajouter un message de validation pour aider les membres de votre équipe à comprendre pourquoi vous avez ajouté ce fichier. Si vous ne saisissez pas de message de validation, un message par défaut est utilisé.
1. Choisissez **Valider les modifications**.
Pour télécharger un fichier, procédez comme suit :
+ Si vous chargez un fichier, choisissez le fichier que vous voulez charger.
![\[Vue du téléchargement d'un fichier dans la console CodeCommit\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-commit-first-file.png)
+ Dans **Nom de l'auteur**, saisissez le nom que vous souhaitez afficher à d'autres utilisateurs du référentiel.
+ Dans **Adresse e-mail**, saisissez une adresse e-mail.
+ (Facultatif) Dans **Message de validation**, saisissez un bref message. Bien que cette étape soit facultative, nous vous recommandons d'ajouter un message de validation pour aider les membres de votre équipe à comprendre pourquoi vous avez ajouté ce fichier. Si vous ne saisissez pas de message de validation, un message par défaut est utilisé.
+ Choisissez **Valider les modifications**.
Pour de plus amples informations, veuillez consulter [Utilisation de fichiers dans des AWS CodeCommit référentiels](files.md).
Pour utiliser un client Git pour cloner le dépôt, installez Git sur votre ordinateur local, puis clonez le CodeCommit dépôt. Ajoutez des fichiers au référentiel local et transmettez-les vers le référentiel CodeCommit . Pour voir une présentation approfondie, consultez le [Commencer à utiliser Git et CodeCommit](getting-started.md). Si vous connaissez Git, mais que vous ne savez pas comment procéder avec un CodeCommit dépôt, vous pouvez consulter des exemples et des instructions dans [Création d'un commit](how-to-create-commit.md)[Étape 2 : créer un dépôt local](getting-started.md#getting-started-set-up-folders), ou[Connexion à un référentiel](how-to-connect.md).
Après avoir ajouté des fichiers au CodeCommit référentiel, vous pouvez les consulter dans la console.
## Étape 3 : Parcourez le contenu de votre dépôt
Vous pouvez utiliser la CodeCommit console pour consulter les fichiers d'un référentiel ou lire rapidement le contenu d'un fichier. Cela vous aidera à déterminer quelle branche vérifier ou si vous devez créer une copie locale d'un référentiel.
**Pour parcourir le référentiel**
1. Dans **Référentiels**, sélectionnez MyDemoRepo.
1. La page affiche le contenu de la branche par défaut de votre référentiel. Pour afficher une autre branche ou afficher le code sur une balise spécifique, choisissez la branche ou la balise à afficher dans la liste. Dans la capture d'écran suivante, la vue est définie sur la branche **principale**.
![\[Navigation dans le contenu d'un référentiel\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-code-browse.png)
1. Pour afficher le contenu d'un fichier dans votre référentiel, choisissez le fichier dans la liste. Pour modifier la couleur du code affiché, choisissez l'icône de paramètres (Settings).
![\[Affichage du contenu d'un fichier\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-code-browse-file.png)
Pour de plus amples informations, veuillez consulter [Parcourir les fichiers d'un référentiel](how-to-browse.md).
1. Pour parcourir l'historique des validations du référentiel, choisissez **Commits**. La console affiche l'historique des validations pour la branche par défaut, dans l'ordre chronologique inverse. Passez en revue les détails de validation par auteur, pat date et plus encore.
![\[Vue de l'historique de validations sur la console\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-code-history.png)
1. Pour afficher l'historique de validation par [branche](branches.md) ou par [balise Git](how-to-view-tag-details.md), choisissez la branche ou la balise à afficher dans la liste.
1. Pour voir les différences entre une validation et sa validation parent, choisissez l'ID de validation abrégé. Vous pouvez choisir la manière dont les modifications sont affichées, y compris afficher ou masquer les modifications d'espace, et définir si les modifications doivent être affichées en ligne (vue **unifiée**) ou côte à côte (vue **fractionnée**).
**Note**
Vos préférences d'affichage du code, ainsi que les autres paramètres de la console sont enregistrés en tant que cookies du navigateur chaque fois que vous les modifiez. Pour de plus amples informations, veuillez consulter [Utilisation des préférences de l'utilisateur](user-preferences.md).
![\[Modifications affichées dans la vue unifiée, avec les modifications d'espace blanc visibles\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-commit-changes2c.png)
1. Pour afficher tous les commentaires sur une validation, sélectionnez la validation et faites défiler la page pour les consulter directement. Vous pouvez également ajouter vos propres commentaires et répondre à ceux des autres utilisateurs.
Pour de plus amples informations, veuillez consulter [Commentaire relatif à une validation](how-to-commit-comment.md).
1. Pour voir les différences entre deux spécifications de validations, y compris les balises, les branches et les validations IDs, dans le volet de navigation, choisissez **Commits**, puis choisissez **Comparer les commits**.
![\[Comparaison d'une validation à la pointe de la branche dans la vue fractionnée\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-compare-4.png)
Pour plus d’informations, consultez [Parcourir l'historique des validations d'un dépôt](how-to-view-commit-details.md#how-to-view-commit-details-console-history) et [Comparer des validations](how-to-compare-commits.md).
1. Dans **Validations**, sélectionnez l'onglet **Visualiseur de validations**.
![\[Vue graphique d'un référentiel sur la console\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-cv-complex1.png)
Le graphique de validation s'affiche, avec la ligne d'objet pour chaque validation affichée en regard de son point dans le graphique. L'affichage de la ligne d'objet est limité à 80 caractères.
1. Pour en savoir plus sur une validation, sélectionnez son ID de validation abrégée. Pour afficher le graphique à partir d'une validation spécifique, choisissez ce point dans le graphique. Pour de plus amples informations, veuillez consulter [Afficher un graphique de l'historique des validations d'un dépôt](how-to-view-commit-details.md#how-to-view-commit-details-console-visualizer).
## Étape 4 : Créez une pull request et collaborez sur celle-ci
Lorsque vous travaillez dans un référentiel avec d'autres utilisateurs, vous pouvez collaborer sur le code et passer en revue les modifications. Vous pouvez créer une demande d'extraction afin que d'autres utilisateurs puissent consulter et commenter vos modifications de code dans une branche. Vous pouvez également créer une ou plusieurs règles d'approbation pour la demande d'extraction. Par exemple, vous pouvez créer une règle d'approbation qui exige qu'au moins deux autres utilisateurs approuvent la demande d'extraction pour qu'elle puisse être fusionnée. Une fois la demande d'extraction approuvée, vous pouvez fusionner ces modifications dans sa branche de destination. Si vous avez configuré des notifications pour votre référentiel, les utilisateurs du référentiel peuvent recevoir des e-mails sur les événements relatifs au référentiel (par exemple, pour les demandes d'extraction ou lorsque quelqu'un commente le code). Pour de plus amples informations, veuillez consulter [Configuration des notifications pour les événements d'un AWS CodeCommit référentiel](how-to-repository-email.md).
**Important**
Avant de créer une demande d'extraction, vous devez créer une branche qui contient les modifications de code que vous souhaitez faire vérifier. Pour de plus amples informations, veuillez consulter [Création d'une branche](how-to-create-branch.md).
**Créer et gérer une demande d'extraction de manière collaborative**
1. Dans le volet de navigation, choisissez **Demandes d'extraction**.
1. Dans **Demandes d'extraction**, sélectionnez **Créer une demande d'extraction**.
**Astuce**
Vous pouvez également créer des demandes d'extractions depuis **Branches** et **Code**.
Dans la section **Source** de **Create pull request**, recherchez la branche qui contient les modifications que vous voulez faire vérifier. Dans **Destination**, choisissez la branche dans laquelle vous souhaitez fusionner le code modifié lorsque la demande d'extraction est fermée. Choisissez **Comparer**.
1. Passez en revue les détails de la fusion et les modifications pour confirmer que la demande d'extraction contient les modifications et les validations que vous voulez faire vérifier. Si tel est le cas, dans **Titre**, saisissez un titre pour cette révision. Il s'agit du titre qui s'affiche dans la liste des demandes d'extraction pour le référentiel. Dans **Description**, saisissez les détails relatifs à la révision et toutes autres informations utiles pour les réviseurs. Choisissez **Créer**.
![\[Création d'une demande d'extraction\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-pull-request-create.png)
1. Votre demande d'extraction s'affiche dans la liste des demandes d'extraction du référentiel. Vous pouvez filtrer la vue pour afficher uniquement les demandes ouvertes, les demandes fermées, les demandes que vous avez créées, et bien plus encore.
![\[Affichage des demandes d'extraction dans un référentiel\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-pull-request-view.png)
1. Vous pouvez ajouter une règle d'approbation à votre pull request pour vous assurer que certaines conditions sont remplies avant de pouvoir la fusionner. Pour ajouter une règle d'approbation à votre demande d'extraction, choisissez la demande d'extraction dans la liste. Sous l'onglet **Approvals (Approbations)**, choisissez **Create approval rule (Créer une règle d'approbation)**.
1. Dans **Rule name (Nom de la règle)**, attribuez un nom descriptif à la règle. Par exemple, si vous souhaitez que deux personnes approuvent une demande d'extraction pour qu'elle puisse être fusionnée, vous pouvez nommer la règle **Require two approvals before merge**. Dans **Number of approvals needed (Nombre d'approbations nécessaires)**, entrez **2**, le nombre souhaité. La valeur par défaut est 1. Sélectionnez **Soumettre**. Pour de plus amples informations sur les règles d'approbation et les membres du groupe d'approbation, veuillez consulter [Création d'une règle d'approbation pour une pull request](how-to-create-pull-request-approval-rule.md).
![\[Création d'une règle d'approbation pour une demande d'extraction\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-create-approval-rule.png)
1. Si vous avez configuré des notifications pour votre référentiel et avez choisi d'informer les utilisateurs au sujet des événements de demande d'extraction, les utilisateurs reçoivent un e-mail concernant votre nouvelle demande d'extraction. Les utilisateurs peuvent visualiser les modifications et commenter des lignes de code spécifiques, des fichiers et la demande d'extraction elle-même. Ils peuvent également répondre aux commentaires avec du texte et des émoticônes. Si nécessaire, vous pouvez transmettre (push) les modifications à la branche de demande d'extraction, qui met à jour la demande d'extraction.
![\[Ajouter une réaction emoji à un commentaire sur une pull request.\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-commenting-commenttab.png)
1. Si vous êtes satisfait des modifications apportées à la demande, choisissez **Approve (Approuver)**. Vous pouvez choisir d'approuver une demande d'extraction même si aucune règle d'approbation n'est configurée pour cette demande. Vous fournissez ainsi un enregistrement clair de votre examen de la demande d'extraction et de votre approbation des modifications. Vous pouvez également choisir d'annuler votre approbation si vous changez d'avis.
![\[Affichage des approbations pour une demande d'extraction\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-pull-request-approvals.png)
**Note**
Vous ne pouvez pas approuver une demande d'extraction si vous l'avez créée.
1. Lorsque vous êtes satisfait que toutes les modifications de code ont été vérifiées et approuvées, à partir de la demande d'extraction, exécutez l'une des actions suivantes :
+ Si vous voulez fermer la demander d'extraction sans fusionner les branches, choisissez **Close pull request (Fermer la demande d’extraction)**.
+ Si vous souhaitez fusionner les branches et fermer la demande d'extraction, choisissez **Merge (Fusionner)**. Vous pouvez choisir entre les stratégies de fusion disponibles pour votre code, qui reposent sur les différences entre les branches source et de destination, et s'il convient de supprimer automatiquement la branche source une fois que la fusion est terminée. Après avoir effectué vos sélections, choisissez **Merge pull request (Fusionner la demande d’extraction)** pour terminer la fusion.
![\[Une pull request indiquant les stratégies de fusion disponibles pour la fusion dans la CodeCommit console.\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-merge-squash.png)
+ S'il existe des conflits de fusion dans les branches qui ne peuvent pas être résolus automatiquement, vous pouvez les résoudre dans la CodeCommit console, ou vous pouvez utiliser votre client Git local pour fusionner les branches, puis lancer la fusion. Pour de plus amples informations, veuillez consulter [Résoudre les conflits liés à une pull request dans un AWS CodeCommit référentiel](how-to-resolve-conflict-pull-request.md).
**Note**
Vous pouvez toujours fusionner manuellement les branches, y compris les branches de demande d'extraction, en utilisant la commande **git merge** dans le référentiel local et en envoyant les modifications.
Pour plus d’informations, consultez [Utilisation des demandes d'extraction](pull-requests.md) et [Utilisation des modèles de règles d'approbation](approval-rule-templates.md).
## Étape 5 : nettoyer
Si vous n'avez plus besoin du CodeCommit référentiel, vous devez le CodeCommit supprimer ainsi que les autres ressources que vous avez utilisées dans cet exercice afin de ne pas continuer à être facturé pour l'espace de stockage.
**Important**
Cette action ne peut pas être annulée. Après avoir supprimé ce dépôt, vous ne pouvez plus le cloner dans un dépôt local ou un dépôt partagé. Vous ne pouvez plus non plus extraire de données, y envoyer des données, ni effectuer d'opérations Git, à partir d'un dépôt local ou d'un dépôt partagé.
Si vous avez configuré les notifications pour votre référentiel, la suppression du référentiel supprime également la règle Amazon CloudWatch Events créée pour le référentiel. Cela ne supprime pas la rubrique Amazon SNS utilisée comme cible pour cette règle.
Si vous avez configuré des déclencheurs pour votre référentiel, la suppression du référentiel ne supprime pas les rubriques Amazon SNS ou les fonctions Lambda que vous avez configurées comme cibles de ces déclencheurs. Veillez à supprimer ces ressources si vous n'en avez pas besoin. Pour de plus amples informations, veuillez consulter [Supprimer des déclencheurs d'un référentiel](how-to-notify-delete.md).
**Pour supprimer 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. Dans **Référentiels**, sélectionnez le nom du référentiel que vous voulez supprimer. Si vous avez suivi la convention de dénomination de cette rubrique, il est nommé **MyDemoRepo**.
1. Dans le panneau de navigation, sélectionnez **Settings** (Paramètres).
1. Sur la page **Settings**, dans **Delete repository**, choisissez **Delete repository**.
1. Saisissez **delete**, puis sélectionnez **Delete (Supprimer)**. Le référentiel est définitivement supprimé.
## Étape 6 : étapes suivantes
Maintenant que vous vous êtes familiarisé avec certaines CodeCommit de ses fonctionnalités, envisagez de procéder comme suit :
+ Si vous utilisez Git pour la première fois CodeCommit et/ou si vous souhaitez consulter des exemples d'utilisation de Git avec CodeCommit, poursuivez le [Commencer à utiliser Git et CodeCommit](getting-started.md) didacticiel.
+ Si vous souhaitez travailler avec d'autres personnes dans un CodeCommit référentiel, consultez[Partage d'un référentiel](how-to-share-repository.md). (Si vous souhaitez partager votre référentiel avec les utilisateurs d'un autre compte Amazon Web Services, consultez[Configuration de l'accès entre comptes à un AWS CodeCommit référentiel à l'aide de rôles](cross-account.md).)
+ Si vous souhaitez migrer un référentiel vers CodeCommit, suivez les étapes décrites dans[Migrer vers CodeCommit](how-to-migrate-repository.md).
+ Si vous souhaitez ajouter votre référentiel à un pipeline de diffusion en continu, suivez les étapes de [Didacticiel : Créer un pipeline simple](https://docs.aws.amazon.com/codepipeline/latest/userguide/getting-started-cc.html).
+ Si vous voulez en savoir plus sur les produits et les services qui s'intègrent à CodeCommit, avec notamment des exemples de la communauté, consultez [Intégrations de produits et services](integrations.md).
# 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
```