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.
# Utilisation des validations dans les AWS CodeCommit référentiels
Les validations sont des instantanés du contenu et des modifications du contenu de votre référentiel. Chaque fois qu'un utilisateur valide et transmet (push) une modification, ces informations sont enregistrées et stockées. Ces informations indiquent également qui a validé la modification, la date et l'heure de la validation, ainsi que les modifications effectuées dans le cadre de la validation. Vous pouvez également ajouter des balises à des validations pour identifier facilement des validations spécifiques. Dans CodeCommit, vous pouvez :
+ passer en revue les validations ;
+ afficher l'historique des validations dans un graphique ;
+ comparer une validation à son parent ou à un autre indicateur ;
+ ajouter des commentaires à vos validations et répondre à ceux des autres utilisateurs.
![\[Ajout d'un commentaire à une ligne modifiée dans une validation.\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-commenting-addlinecomment.png)
Avant de pouvoir envoyer des validations vers un CodeCommit dépôt, vous devez configurer votre ordinateur local pour qu'il se connecte au dépôt. Pour découvrir la méthode la plus simple, consultez [Pour les utilisateurs HTTPS utilisant les informations d'identification Git](setting-up-gc.md).
Pour plus d'informations sur l'utilisation d'autres aspects de votre référentiel dans CodeCommit[Utilisation des référentiels](repositories.md), voir[Travailler avec des fichiers](files.md),[Utilisation des demandes d'extraction](pull-requests.md),[Utilisation de branches](branches.md), et[Utilisation des préférences de l'utilisateur](user-preferences.md).
**Topics**
+ [Créez un commit dans AWS CodeCommit](how-to-create-commit.md)
+ [Afficher les détails de la validation dans AWS CodeCommit](how-to-view-commit-details.md)
+ [Comparez les validations dans AWS CodeCommit](how-to-compare-commits.md)
+ [Commenter un commit dans AWS CodeCommit](how-to-commit-comment.md)
+ [Créez une balise Git dans AWS CodeCommit](how-to-create-tag.md)
+ [Afficher les détails du tag Git dans AWS CodeCommit](how-to-view-tag-details.md)
+ [Supprimer une balise Git dans AWS CodeCommit](how-to-delete-tag.md)
# Créez un commit dans AWS CodeCommit
Lorsque vous créez le premier commit pour un nouveau dépôt, vous utilisez la AWS CLI **put-file** commande and. Cela crée le premier commit et vous permet de créer et de spécifier la branche par défaut pour votre nouveau dépôt. Vous pouvez utiliser Git ou le AWS CLI pour créer un commit dans un CodeCommit dépôt. Si le dépôt local est connecté à un CodeCommit dépôt, vous utilisez Git pour transférer le commit du dépôt local vers le CodeCommit dépôt. Pour créer un commit directement dans la CodeCommit console, reportez-vous aux sections [Création ou ajout d'un fichier dans un AWS CodeCommit référentiel](how-to-create-file.md) et[Modifier le contenu d'un fichier dans un AWS CodeCommit référentiel](how-to-edit-file.md).
**Note**
En tant que bonne pratique, nous vous recommandons d'utiliser les dernières versions prises en charge de AWS CLI Git et d'autres logiciels. Si vous utilisez le AWS CLI, assurez-vous qu'une version récente est installée pour vous assurer que vous utilisez une version contenant la `create-commit` commande.
**Topics**
+ [Créez le premier commit pour un dépôt à l'aide du AWS CLI](#how-to-create-first-commit)
+ [Création d'un commit à l'aide d'un client Git](#how-to-create-commit-git)
+ [Créez un commit à l'aide du AWS CLI](#how-to-create-commit-cli)
## Créez le premier commit pour un dépôt à l'aide du AWS CLI
Vous pouvez utiliser la AWS CLI `put-file` commande and pour créer votre premier commit pour un dépôt. L'utilisation **put-file** crée un premier commit qui ajoute un fichier à votre dépôt vide et crée une branche portant le nom que vous spécifiez. Il désigne la nouvelle branche comme branche par défaut de votre dépôt.
**Note**
Pour utiliser AWS CLI des commandes avec CodeCommit, installez le AWS CLI. Pour de plus amples informations, veuillez consulter [Référence des commandes en ligne](cmd-ref.md).
## Pour créer le premier commit pour un dépôt à l'aide du AWS CLI
1. Sur votre ordinateur local, créez le fichier que vous souhaitez ajouter en tant que premier fichier au CodeCommit référentiel. Une pratique courante consiste à créer un fichier `README.md` Markdown qui explique l'objectif de ce dépôt aux autres utilisateurs du référentiel. Si vous incluez un `README.md` fichier, son contenu s'affiche automatiquement en bas de la page de **code** de votre référentiel dans la CodeCommit console.
1. Depuis le terminal ou la ligne de commande, exécutez la commande **put-file**, en spécifiant :
+ Nom du référentiel dans lequel vous souhaitez ajouter le premier fichier.
+ Nom de la branche que vous souhaitez créer comme branche par défaut.
+ L'emplacement local du fichier. La syntaxe utilisée pour cet emplacement varie en fonction de votre système d'exploitation local.
+ Le nom du fichier que vous souhaitez ajouter, y compris le chemin où le fichier mis à jour est stocké dans le référentiel.
+ Nom d'utilisateur et e-mail que vous souhaitez associer à ce fichier.
+ Un message de validation qui explique pourquoi vous avez ajouté ce fichier.
Le nom d'utilisateur, l'adresse e-mail et le message de validation sont facultatifs, mais peuvent aider les autres utilisateurs à savoir qui a effectué la modification et pourquoi. Si vous ne fournissez pas de nom d'utilisateur, utilisez CodeCommit par défaut votre nom d'utilisateur IAM ou une dérivation de votre identifiant de connexion à la console comme nom d'auteur.
Par exemple, pour ajouter un fichier nommé *README.md* avec un exemple de contenu de fichier codé en base 6 à un référentiel nommé *MyDemoRepo* d'après une branche nommée *development* :
```
aws codecommit put-file --repository-name MyDemoRepo --branch-name development --file-path README.md --file-content "EXAMPLE0123456789example0123456789EXAMPLE1" --name "Mary Major" --email "mary_major@example.com" --commit-message "I added a quick readme for our new team repository."
```
Si elle aboutit, cette commande renvoie une sortie similaire à ce qui suit :
```
{
"commitId": "724caa36EXAMPLE",
"blobId": "a8a94062EXAMPLE",
"treeId": "08b2fc73EXAMPLE"
}
```
## Création d'un commit à l'aide d'un client Git
Vous pouvez créer des validations à l'aide d'un client Git installé sur votre ordinateur local, puis transférer ces validations vers votre CodeCommit dépôt.
1. Remplissez les prérequis, y compris [Configuration ](setting-up.md).
**Important**
Si vous n'avez pas terminé la configuration, vous ne pouvez pas vous connecter au référentiel ou valider dans celui-ci à l'aide de Git.
1. Veillez à créer une validation dans la branche correcte. Pour afficher la liste des branches disponibles et déterminer quelle branche vous utilisez actuellement, exécutez **git branch**. Toutes les branches sont affichées. Un astérisque (`*`) apparaît à côté de votre branche actuelle. Pour basculer vers une autre branche, exécutez **git checkout *branch-name***. S'il s'agit de votre premier commit, exécutez la **git config ** commande pour configurer votre client Git afin de créer une branche initiale portant le nom que vous souhaitez utiliser pour cette branche. Par exemple, si vous souhaitez que votre branche par défaut porte le nom suivant *development* :
```
git config --local init.defaultBranch development
```
**Astuce**
Cette commande n'est disponible que dans Git v.2.28 et versions ultérieures.
Vous pouvez également exécuter cette commande pour définir le nom de votre branche par défaut **development** pour tous les référentiels nouvellement créés :
```
git config --global init.defaultBranch development
```
1. Apportez une modification à la branche (par exemple, ajoutez, modifiez ou supprimez un fichier).
Par exemple, dans le dépôt local, créez un fichier nommé `bird.txt` avec le texte suivant :
```
bird.txt
--------
Birds (class Aves or clade Avialae) are feathered, winged, two-legged, warm-blooded, egg-laying vertebrates.
```
1. Exécutez **git status** qui doit indiquer que `bird.txt` n'a pas encore été inclus dans une validation en attente :
```
...
Untracked files:
(use "git add ..." to include in what will be committed)
bird.txt
```
1. Exécutez **git add bird.txt** pour inclure le nouveau fichier dans la validation en attente.
1. Si vous exécutez à nouveau **git status**, vous devez voir une sortie similaire à ce qui suit. Elle indique que `bird.txt` fait désormais partie de la validation en attente ou a fait l'objet d'une copie intermédiaire pour validation :
```
...
Changes to be committed:
(use "git reset HEAD ..." to unstage)
new file: bird.txt
```
1. Pour finaliser la validation, exécutez **git commit** avec l'option `-m` (par exemple, ** git commit -m "*Adding bird.txt to the repository.*"**). L'option `-m` crée le message de validation.
1. Si vous exécutez à nouveau **git status**, vous devez voir une sortie similaire à ce qui suit. Cela indique que le commit est prêt à être transféré du dépôt local vers le CodeCommit référentiel :
```
...
nothing to commit, working directory clean
```
1. Avant de transférer le commit finalisé du dépôt local vers le CodeCommit dépôt, vous pouvez voir ce que vous envoyez en exécutant**git diff --stat *remote-name*/*branch-name***, où *remote-name* est le surnom que le dépôt local utilise pour le CodeCommit dépôt et *branch-name* le nom de la branche à comparer.
**Astuce**
Pour obtenir le pseudonyme, exécutez **git remote**. Pour obtenir une liste de noms de branche, exécutez **git branch**. Un astérisque (`*`) apparaît à côté de la branche actuelle. Vous pouvez également exécuter **git status** pour obtenir le nom de la branche actuelle.
**Note**
Si vous avez cloné le dépôt, du point de vue du dépôt local, ce n'*remote-name*est pas le nom du CodeCommit dépôt. Lorsque vous clonez un dépôt, *remote-name* il est automatiquement défini sur`origin`.
Par exemple, **git diff --stat origin/main** affiche une sortie similaire à ce qui suit :
```
bird.txt | 1 +
1 file changed, 1 insertion(+)
```
La sortie suppose que vous avez déjà connecté le dépôt local au CodeCommit référentiel. (Pour obtenir des instructions, consultez [Connexion à un référentiel](how-to-connect.md).)
1. Lorsque vous êtes prêt à transférer le commit du dépôt local vers le CodeCommit dépôt, exécutez**git push *remote-name* *branch-name***, où *remote-name* est le surnom que le dépôt local utilise pour le CodeCommit dépôt et *branch-name* le nom de la branche à transférer vers le CodeCommit référentiel.
Par exemple, exécuter **git push origin main** affiche une sortie similaire à ce qui suit :
Pour HTTPS :
```
Counting objects: 7, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (4/4), done.
Writing objects: 100% (5/5), 516 bytes | 0 bytes/s, done.
Total 5 (delta 2), reused 0 (delta 0)
remote:
To https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo
b9e7aa6..3dbf4dd main -> main
```
Pour SSH :
```
Counting objects: 7, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (4/4), done.
Writing objects: 100% (5/5), 516 bytes | 0 bytes/s, done.
Total 5 (delta 2), reused 0 (delta 0)
remote:
To ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo
b9e7aa6..3dbf4dd main -> main
```
**Astuce**
Si vous ajoutez l'option `-u` à **git push** (par exemple, **git push -u origin main**), vous devez ensuite uniquement exécuter **git push** à l'avenir, car les informations de suivi en amont ont été configurées. Pour obtenir des informations de suivi en amont, exécutez **git remote show *remote-name*** (par exemple, **git remote show origin**).
Pour plus d'options, consultez votre documentation Git.
## Créez un commit à l'aide du AWS CLI
Vous pouvez utiliser la AWS CLI `create-commit` commande and pour créer un commit pour un dépôt situé à l'extrémité d'une branche spécifiée. Vous pouvez également créer une validation de fusion non référencée pour représenter les résultats de la fusion de deux spécificateurs de validation. Pour plus d'informations, consultez [Créer une validation non référencée](how-to-resolve-conflict-pull-request.md#create-unreferenced-merge-commit).
**Note**
Pour utiliser AWS CLI des commandes avec CodeCommit, installez le AWS CLI. Pour de plus amples informations, veuillez consulter [Référence des commandes en ligne](cmd-ref.md).
**Pour créer une validation**
1. Sur votre ordinateur local, apportez les modifications que vous souhaitez valider dans le référentiel CodeCommit.
1. Depuis le terminal ou la ligne de commande, exécutez la commande **create-commit**, en spécifiant :
+ Le référentiel dans lequel vous souhaitez valider les modifications.
+ La branchez où vous souhaitez valider les modifications.
+ L'ID de validation complet de la validation la plus récente effectuée dans cette branche, également connu comme la pointe ou la validation de tête ou l'ID de validation parent.
+ Conserver ou non des dossiers vides si les modifications que vous avez effectuées suppriment le contenu de ces dossiers. Par défaut, la valeur est false (fausse).
+ Les informations sur les fichiers que vous souhaitez ajouter, modifier ou supprimer.
+ Le nom d'utilisateur et l'adresse e-mail que vous souhaitez associer à ces modifications.
+ Un message de validation qui explique pourquoi vous avez apporté ces modifications.
Le nom d'utilisateur, l'adresse e-mail et le message de validation sont facultatifs mais aident les autres utilisateurs à savoir qui a effectué les modifications et pourquoi. Si vous ne fournissez pas de nom d'utilisateur, utilisez CodeCommit par défaut votre nom d'utilisateur IAM ou une dérivation de votre identifiant de connexion à la console comme nom d'auteur.
Par exemple, pour créer un commit pour un dépôt qui ajoute un `README.md` fichier à un dépôt nommé *MyDemoRepo* dans la *main* branche. Le contenu du fichier est en Base64 et se lit comme suit : « Bienvenue dans le référentiel de notre équipe \$1 » :
```
aws codecommit create-commit --repository-name MyDemoRepo --branch-name main --parent-commit-id 4c925148EXAMPLE --put-files "filePath=README.md,fileContent=V2VsY29tZSB0byBvdXIgdGVhbSByZXBvc2l0b3J5IQo="
```
**Astuce**
Pour obtenir l'ID de validation parent, exécutez la commande [get-branch](how-to-view-branch-details.md#how-to-view-branch-details-cli-details).
Si elle aboutit, cette commande renvoie une sortie similaire à ce qui suit :
```
{
"commitId": "4df8b524-EXAMPLE",
"treeId": "55b57003-EXAMPLE",
"filesAdded": [
{
"blobId": "5e1c309dEXAMPLE",
"absolutePath": "meeting.md",
"fileMode": "NORMAL"
}
],
"filesDeleted": [],
"filesUpdated": []
}
```
Pour créer un commit qui apporte des modifications aux fichiers nommés *file1.py* et*file2.txt*, renomme un fichier de *picture.png* à *image1.png* et le déplace d'un répertoire nommé *pictures* vers un répertoire nommé*images*, et supprime un fichier nommé *ExampleSolution.py* dans un référentiel nommé *MyDemoRepo* sur une branche nommée *MyFeatureBranch* dont le dernier commit a l'ID : *4c925148EXAMPLE*
```
aws codecommit create-commit --repository-name MyDemoRepo --branch-name MyFeatureBranch --parent-commit-id 4c925148EXAMPLE --author-name "Saanvi Sarkar"
--email "saanvi_sarkar@example.com" --commit-message "I'm creating this commit to update a variable name in a number of files."
--keep-empty-folders false --put-files '{"filePath": "file1.py", "fileMode": "EXECUTABLE", "fileContent": "bucket_name = sys.argv[1] region = sys.argv[2]"}'
'{"filePath": "file2.txt", "fileMode": "NORMAL", "fileContent": "//Adding a comment to explain the variable changes in file1.py"}' '{"filePath": "images/image1.png",
"fileMode": "NORMAL", "sourceFile": {"filePath": "pictures/picture.png", "isMove": true}}' --delete-files filePath="ExampleSolution.py"
```
**Note**
La syntaxe du **--put-files** segment varie en fonction de votre système d'exploitation. L'exemple ci-dessus est optimisé pour les utilisateurs de Linux, macOS ou Unix et les utilisateurs de Windows utilisant un émulateur Bash. Les utilisateurs Windows en ligne de commande ou dans Powershell doivent utiliser une syntaxe approprié pour ces systèmes.
Si elle aboutit, cette commande renvoie une sortie similaire à ce qui suit :
```
{
"commitId": "317f8570EXAMPLE",
"treeId": "347a3408EXAMPLE",
"filesAdded": [
{
"absolutePath": "images/image1.png",
"blobId": "d68ba6ccEXAMPLE",
"fileMode": "NORMAL"
}
],
"filesUpdated": [
{
"absolutePath": "file1.py",
"blobId": "0a4d55a8EXAMPLE",
"fileMode": "EXECUTABLE"
},
{
"absolutePath": "file2.txt",
"blobId": "915766bbEXAMPLE",
"fileMode": "NORMAL"
}
],
"filesDeleted": [
{
"absolutePath": "ExampleSolution.py",
"blobId": "4f9cebe6aEXAMPLE",
"fileMode": "EXECUTABLE"
},
{
"absolutePath": "pictures/picture.png",
"blobId": "fb12a539EXAMPLE",
"fileMode": "NORMAL"
}
]
}
```
# Afficher les détails de la validation dans AWS CodeCommit
Vous pouvez utiliser la AWS CodeCommit console pour parcourir l'historique des validations dans un dépôt. Ceci peut vous aider à identifier les modifications effectuées dans un référentiel, y compris :
+ Quand et par qui les modifications ont été effectuées.
+ Quand des validations spécifiques ont été fusionnées dans une branche.
L'affichage de l'historique de validations pour une branche peut également vous aider à comprendre les différences entre des branches. Si vous utilisez le balisage, vous pouvez également consulter rapidement la validation qui a été étiquetée avec une balise spécifique et les parents de cette validation balisée. Sur la ligne de commande, vous pouvez utiliser Git pour afficher les détails des validations dans un dépôt local ou un CodeCommit dépôt.
## Parcourir les commits dans un référentiel
Vous pouvez utiliser la AWS CodeCommit console pour parcourir l'historique des validations d'un dépôt. Vous pouvez aussi afficher un graphique des validations dans le référentiel et ses branches au fil du temps. Cela peut vous aider à comprendre l'historique du référentiel, notamment à quel moment des modifications ont été effectuées.
**Note**
L'utilisation de la commande **git rebase** pour rebaser un référentiel modifie l'historique d'un référentiel, ce qui peut entraîner l'affichage dans le désordre des validations. Pour plus d'informations, consultez [Git Branching-Rebasing](https://git-scm.com/book/en/v2/Git-Branching-Rebasing) ou votre documentation Git.
**Topics**
+ [Parcourir l'historique des validations d'un dépôt](#how-to-view-commit-details-console-history)
+ [Afficher un graphique de l'historique des validations d'un dépôt](#how-to-view-commit-details-console-visualizer)
### Parcourir l'historique des validations d'un dépôt
Vous pouvez parcourir l'historique des validations à la recherche d'une branche ou d'une balise spécifique du référentiel, incluant des informations sur l'outil de validation et le message de validation. Vous pouvez aussi afficher le code pour une validation.
**Pour parcourir l'historique de 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 **Repositories (Référentiels)**, sélectionnez le référentiel pour lequel vous souhaitez consulter l'historique de validation.
1. Dans le volet de navigation, choisissez **Validations**. Dans la vue de l'historique des validations, un historique des validations du référentiel dans la branche par défaut est affiché, dans l'ordre chronologique inverse de la date de validation. Les dates et heures sont exprimées en heure UTC (temps universel coordonné). Vous pouvez afficher l'historique des validations d'une autre branche en choisissant le bouton de sélection de vue, puis en choisissant une branche dans la liste. Si vous utilisez des balises dans votre référentiel, vous pouvez afficher une validation dotée d'une balise spécifique et ses parents en choisissant cette balise dans le bouton de sélection de vue.
![\[Vue des validations sur la console\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-commit-list.png)
1. Pour voir la différence entre une validation et son parent, et pour voir tous les commentaires sur les modifications, choisissez l'ID de validation abrégé. Pour plus d’informations, consultez [Comparer un commit à son parent](how-to-compare-commits.md#how-to-compare-commits-parent) et [Commentaire relatif à une validation](how-to-commit-comment.md). Pour afficher la différence entre une validation et tout autre spécificateur de validation, y compris une branche, une balise ou un ID de validation, consultez [Comparaison de deux spécificateurs de validation quelconques](how-to-compare-commits.md#how-to-compare-commits-compare).
1. Effectuez une ou plusieurs des actions suivantes :
+ Pour afficher la date et l'heure d'une modification, survolez la date de validation.
+ Pour afficher l'ID de validation complet, copiez et collez-le dans un éditeur de texte ou un autre emplacement. Pour le copier, choisissez **Copy ID (Copier l'ID)**.
+ Pour afficher le code tel qu'il était au moment de la validation, choisissez **Browse (Parcourir)**. Le contenu du référentiel tel qu'il était au moment de la validation s'affiche dans la vue **Code**. Le bouton de sélection de vue affiche l'ID de validation abrégé au lieu d'une branche ou d'une balise.
### Afficher un graphique de l'historique des validations d'un dépôt
Vous pouvez afficher un graphique des validations effectuées sur un référentiel. La vue **Commit Visualizer** est une représentation graphique acyclique dirigée (DAG, Directed Acyclic Graph) de toutes les validations effectuées vers une branche du référentiel. Cette représentation graphique peut vous aider à comprendre à quel moment des validations particulières et des fonctionnalités associées ont été ajoutées ou fusionnées. Elle peut également vous aider à identifier à quel moment une modification a été effectuée par rapport à d'autres modifications.
**Note**
Les validations fusionnées à l'aide de la méthode fast-forward (avance rapide) n'apparaissent pas en tant que lignes distinctes dans le graphique des validations.
**Pour afficher un graphique de 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 **Repositories (Référentiels)**, sélectionnez le référentiel pour lequel vous souhaitez afficher le graphique de validations.
1. Dans le volet de navigation, choisissez **Commits (Validations)**, puis l'onglet **Commit visualizer (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)
Dans le graphique des validations, l'ID de validation abrégé et l'objet de chaque message de validation apparaissent à côté de ce point dans le graphique.
**Note**
Le graphique peut afficher jusqu'à 35 branches sur une page. S'il existe plus de 35 branches, le graphique est trop complexe pour s'afficher. Vous pouvez simplifier la vue de deux façons :
En utilisant le bouton de sélection de vue pour afficher le graphique pour une branche spécifique.
En collant l'ID de validation complet dans la zone de recherche pour afficher le graphique à partir de cette validation.
1. Pour afficher un nouveau graphique à partir d'une validation, sélectionnez le point dans le graphique qui correspond à cette validation. Le bouton de sélection de vue change pour afficher l'ID de validation abrégé.
![\[Un nouveau graphique affiché à partir d'une validation spécifique\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-cv-commit.png)
## Afficher les détails du commit (AWS CLI)
Git vous permet de consulter des informations détaillées sur les validations. Vous pouvez également utiliser le AWS CLI pour afficher les détails des validations dans un dépôt local ou dans un CodeCommit référentiel en exécutant les commandes suivantes :
+ Pour afficher des informations sur une validation, exécutez **[aws codecommit get-commit](#how-to-view-commit-details-cli-commit)**.
+ Pour afficher des informations sur plusieurs validations, exécutez **[aws codecommit batch-get-commits](#how-to-view-commit-details-cli-batch-get-commits)**.
+ Pour afficher des informations sur une validation de fusion, exécutez **[aws codecommit get-merge-commit](#how-to-view-commit-details-cli-merge-commit)**.
+ Pour afficher les informations relatives aux modifications apportées à un spécificateur de validation (branche, balise, HEAD ou toute autre référence complète, telle que commit IDs), exécutez**[aws codecommit get-differences](#how-to-view-commit-details-cli-differences)**.
+ Pour afficher le contenu codé en base 64 d'un objet blob Git dans un référentiel, exécutez **[aws codecommit get-blob](#how-to-view-commit-details-cli-blob)**.
### Pour afficher des informations sur une validation
1. Exécutez la commande **aws codecommit get-commit** en indiquant :
+ Le nom du CodeCommit dépôt (avec l'`--repository-name`option).
+ ID de validation complet.
Par exemple, pour afficher les informations relatives à un commit avec l'ID `317f8570EXAMPLE` dans un CodeCommit référentiel nommé `MyDemoRepo` :
```
aws codecommit get-commit --repository-name MyDemoRepo --commit-id 317f8570EXAMPLE
```
1. Si la commande s'exécute correctement, la sortie inclut ce qui suit :
+ Des informations sur l'auteur de la validation (comme configuré dans Git), y compris la date au format d'horodatage et le décalage par rapport à l'heure UTC (Coordinated Universal Time).
+ Des informations sur le valideur (comme configuré dans Git), y compris la date au format d'horodatage et le décalage par rapport à l'heure UTC.
+ L'ID de l'arborescence Git dans laquelle la validation existe.
+ L'ID de validation de la validation parent.
+ Le message de validation.
Voici des exemples de sorties basés sur l'exemple de commande précédent :
```
{
"commit": {
"additionalData": "",
"committer": {
"date": "1484167798 -0800",
"name": "Mary Major",
"email": "mary_major@example.com"
},
"author": {
"date": "1484167798 -0800",
"name": "Mary Major",
"email": "mary_major@example.com"
},
"treeId": "347a3408EXAMPLE",
"parents": [
"4c925148EXAMPLE"
],
"message": "Fix incorrect variable name"
}
}
```
### Pour afficher des informations sur une fusion de validation
1. Exécutez la commande **get-merge-commit** en indiquant :
+ Un spécificateur de validation pour la source de la fusion (avec l' option **--source-commit-specifier**).
+ Un spécificateur de validation de la destination de la fusion (avec l'option **--destination-commit-specifier**).
+ L'option de fusion que vous souhaitez utiliser (avec l'option **--merge-option**).
+ Le nom du référentiel (avec l'option **--repository-name**).
Par exemple, pour afficher les informations relatives à un commit de fusion pour la branche source nommée *bugfix-bug1234* avec une branche de destination nommée *main* selon la *THREE\$1WAY\$1MERGE* stratégie dans un référentiel nommé *MyDemoRepo* :
```
aws codecommit get-merge-commit --source-commit-specifier bugfix-bug1234 --destination-commit-specifier main --merge-option THREE_WAY_MERGE --repository-name MyDemoRepo
```
1. Si elle aboutit, cette commande renvoie des informations similaires à ce qui suit :
```
{
"sourceCommitId": "c5709475EXAMPLE",
"destinationCommitId": "317f8570EXAMPLE",
"baseCommitId": "fb12a539EXAMPLE",
"mergeCommitId": "ffc4d608eEXAMPLE"
}
```
### Pour afficher les informations sur plusieurs validations
1. Exécutez la commande **batch-get-commits** en indiquant :
+ Le nom du CodeCommit dépôt (avec l'`--repository-name`option).
+ Une liste des validations complètes IDs pour chaque validation dont vous souhaitez consulter les informations.
Par exemple, pour afficher des informations sur les validations avec IDs `317f8570EXAMPLE` et `4c925148EXAMPLE` dans un CodeCommit référentiel nommé `MyDemoRepo` :
```
aws codecommit batch-get-commits --repository-name MyDemoRepo --commit-ids 317f8570EXAMPLE 4c925148EXAMPLE
```
1. Si la commande s'exécute correctement, la sortie inclut ce qui suit :
+ Les informations sur les auteurs de la validation (comme configuré dans Git), y compris la date au format d'horodatage et le décalage par rapport à l'heure UTC (Coordinated Universal Time).
+ Informations sur les valideurs (comme configuré dans Git), y compris la date au format d'horodatage et le décalage par rapport à l'heure UTC.
+ Celui IDs de l'arborescence Git dans laquelle le commit existe.
+ Le commit IDs du commit parent.
+ Messages de validation.
Voici des exemples de sorties basés sur l'exemple de commande précédent :
```
{
"commits": [
{
"additionalData": "",
"committer": {
"date": "1508280564 -0800",
"name": "Mary Major",
"email": "mary_major@example.com"
},
"author": {
"date": "1508280564 -0800",
"name": "Mary Major",
"email": "mary_major@example.com"
},
"commitId": "317f8570EXAMPLE",
"treeId": "1f330709EXAMPLE",
"parents": [
"6e147360EXAMPLE"
],
"message": "Change variable name and add new response element"
},
{
"additionalData": "",
"committer": {
"date": "1508280542 -0800",
"name": "Li Juan",
"email": "li_juan@example.com"
},
"author": {
"date": "1508280542 -0800",
"name": "Li Juan",
"email": "li_juan@example.com"
},
"commitId": "4c925148EXAMPLE",
"treeId": "1f330709EXAMPLE",
"parents": [
"317f8570EXAMPLE"
],
"message": "Added new class"
}
}
```
### Pour afficher des informations sur les modifications pour un spécificateur de validation
1. Exécutez la commande **aws codecommit get-differences** en indiquant :
+ Le nom du CodeCommit dépôt (avec l'`--repository-name`option).
+ Les spécificateurs de validation sur lesquels vous souhaitez obtenir des informations. Seul `--after-commit-specifier` est obligatoire. Si vous ne spécifiez pas `--before-commit-specifier`, tous les fichiers actuels par rapport au spécificateur `--after-commit-specifier` sont affichés.
Par exemple, pour afficher des informations sur les différences entre les validations avec IDs `317f8570EXAMPLE` et `4c925148EXAMPLE` dans un CodeCommit référentiel nommé `MyDemoRepo` :
```
aws codecommit get-differences --repository-name MyDemoRepo --before-commit-specifier 317f8570EXAMPLE --after-commit-specifier 4c925148EXAMPLE
```
1. Si la commande s'exécute correctement, la sortie inclut ce qui suit :
+ Une liste de différences, notamment le type de modification (A pour ajouté, D pour supprimé ou M pour modifié).
+ Le mode du type de modification de fichier.
+ L'ID de l'objet blob Git qui contient la modification.
Voici des exemples de sorties basés sur l'exemple de commande précédent :
```
{
"differences": [
{
"afterBlob": {
"path": "blob.txt",
"blobId": "2eb4af3bEXAMPLE",
"mode": "100644"
},
"changeType": "M",
"beforeBlob": {
"path": "blob.txt",
"blobId": "bf7fcf28fEXAMPLE",
"mode": "100644"
}
}
]
}
```
### Pour afficher les informations détaillées sur un objet blob Git
1. Exécutez la commande **aws codecommit get-blob** en indiquant :
+ Le nom du CodeCommit dépôt (avec l'`--repository-name`option).
+ L'ID de l'objet blob Git (avec l'option `--blob-id `).
Par exemple, pour afficher des informations sur un blob Git avec l'ID de `2eb4af3bEXAMPLE` dans un CodeCommit dépôt nommé `MyDemoRepo` :
```
aws codecommit get-blob --repository-name MyDemoRepo --blob-id 2eb4af3bEXAMPLE
```
1. Si la commande s'exécute correctement, la sortie inclut ce qui suit :
+ Le contenu codé en base 64 de l'objet blob, généralement un fichier.
Par exemple, la sortie de la commande précédente peut être semblable à ce qui suit :
```
{
"content": "QSBCaW5hcnkgTGFyToEXAMPLE="
}
```
## Afficher les détails du commit (Git)
Avant de suivre ces étapes, vous devez déjà avoir connecté le dépôt local au CodeCommit référentiel et validé les modifications. Pour obtenir des instructions, veuillez consulter [Connexion à un référentiel](how-to-connect.md).
Pour afficher les modifications apportées à la dernière validation dans un référentiel, exécutez la **git show** commande.
```
git show
```
La sortie produite lors de l'exécution de la commande est semblable à ce qui suit :
```
commit 4f8c6f9d
Author: Mary Major
Date: Mon May 23 15:56:48 2016 -0700
Added bumblebee.txt
diff --git a/bumblebee.txt b/bumblebee.txt
new file mode 100644
index 0000000..443b974
--- /dev/null
+++ b/bumblebee.txt
@@ -0,0 +1 @@
+A bumblebee, also written bumble bee, is a member of the bee genus Bombus, in the family Apidae.
\ No newline at end of file
```
**Note**
Dans cet exemple et dans les suivants, le commit IDs a été abrégé. Le commit complet IDs n'est pas affiché.
Pour afficher les modifications qui ont été effectuées, utilisez la commande **git show** avec l'ID de validation :
```
git show 94ba1e60
commit 94ba1e60
Author: John Doe
Date: Mon May 23 15:39:14 2016 -0700
Added horse.txt
diff --git a/horse.txt b/horse.txt
new file mode 100644
index 0000000..080f68f
--- /dev/null
+++ b/horse.txt
@@ -0,0 +1 @@
+The horse (Equus ferus caballus) is one of two extant subspecies of Equus ferus.
```
Pour voir les différences entre deux validations, exécutez la **git diff** commande et incluez les deux validations IDs.
```
git diff ce22850d 4f8c6f9d
```
Dans cet exemple, la différence entre les deux validations est que deux fichiers ont été ajoutés. La sortie produite lors de l'exécution de la commande est semblable à ce qui suit :
```
diff --git a/bees.txt b/bees.txt
new file mode 100644
index 0000000..cf57550
--- /dev/null
+++ b/bees.txt
@@ -0,0 +1 @@
+Bees are flying insects closely related to wasps and ants, and are known for their role in pollination and for producing honey and beeswax.
diff --git a/bumblebee.txt b/bumblebee.txt
new file mode 100644
index 0000000..443b974
--- /dev/null
+++ b/bumblebee.txt
@@ -0,0 +1 @@
+A bumblebee, also written bumble bee, is a member of the bee genus Bombus, in the family Apidae.
\ No newline at end of file
```
Pour utiliser Git afin d'afficher les détails des validations dans un dépôt local, exécutez la **git log** commande suivante :
```
git log
```
Si elle aboutit, cette commande produit une sortie similaire à ce qui suit :
```
commit 94ba1e60
Author: John Doe
Date: Mon May 23 15:39:14 2016 -0700
Added horse.txt
commit 4c925148
Author: Jane Doe
Date: Mon May 22 14:54:55 2014 -0700
Added cat.txt and dog.txt
```
Pour afficher uniquement le commit IDs et les messages, exécutez la **git log --pretty=oneline** commande suivante :
```
git log --pretty=oneline
```
Si elle aboutit, cette commande produit une sortie similaire à ce qui suit :
```
94ba1e60 Added horse.txt
4c925148 Added cat.txt and dog.txt
```
Pour plus d'options, consultez votre documentation Git.
# Comparez les validations dans AWS CodeCommit
Vous pouvez utiliser la CodeCommit console pour visualiser les différences entre les spécifications de validation d'un CodeCommit référentiel. Vous pouvez rapidement visualiser la différence entre une validation et son parent. Vous pouvez également comparer deux références, y compris le commit IDs.
**Topics**
+ [Comparer un commit à son parent](#how-to-compare-commits-parent)
+ [Comparaison de deux spécificateurs de validation quelconques](#how-to-compare-commits-compare)
## Comparer un commit à son parent
Vous pouvez rapidement visualiser la différence entre une validation et son parent pour passer en revue le message de validation, le valideur et ce qui a changé.
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 **Référentiels**, choisissez le référentiel dans lequel vous souhaitez visualiser la différence entre une validation et son parent.
1. Dans le volet de navigation, choisissez **Validations**.
1. Choisissez l'ID de validation abrégé d'une validation quelconque de la liste. La vue change pour afficher les détails de cette validation, y compris les différences entre celle-ci et sa validation parent.
![\[Choisissez l'ID de validation abrégé pour voir les différences entre cette validation et sa validation parent.\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-commit-changes1.png)
Vous pouvez afficher les modifications côte à côte (vue **fractionnée**) ou en ligne (vue **unifiée**). Vous pouvez également masquer ou afficher les modifications d'espaces. Vous pouvez également ajouter des commentaires. Pour de plus amples informations, veuillez consulter [Commentaire relatif à une validation](how-to-commit-comment.md).
**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, les modifications par espace blanc étant masquées\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-commit-changes2c.png)
![\[Modifications affichées dans la vue fractionnée, avec un commentaire sur une ligne\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-commenting-commenttab.png)
**Note**
En fonction du style de fin de ligne, de votre éditeur de code et d'autres facteurs, vous pouvez voir des lignes complètes ajoutées ou supprimées à la place de modifications spécifiques dans une ligne. Le niveau de détail correspond à ce qui est retourné dans les commandes **git show** et **git diff**.
1. Pour comparer une validation à son parent à partir de l'onglet **Visualiseur de validations**, choisissez l'ID de validation abrégé. Les détails de validation s'affichent, y compris les modifications entre la validation et sa validation parent.
## Comparaison de deux spécificateurs de validation quelconques
Vous pouvez voir les différences entre deux spécifications de validation dans la CodeCommit console. Les spécifications de validation sont des références, telles que des branches, des balises et des validations. IDs
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 **Référentiels**, choisissez le référentiel dans lequel vous souhaitez comparer des validations, des branches ou des validations balisées.
1. Dans le volet de navigation, choisissez **Validations**, puis **Compare commits (Comparer des validations)**.
![\[Comparaison de deux spécificateurs de validation quelconques\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-compare-1.png)
1. Utilisez les zones pour comparer deux spécificateurs de validation.
+ Pour comparer la pointe d'une branche, choisissez le nom de la branche dans la liste. Cela permet de sélectionner la validation la plus récente issue de cette branche pour la comparaison.
+ Pour comparer une validation avec une balise spécifique qui lui est associée, choisissez le nom de la balise dans la liste, le cas échéant. Cela permet de sélectionner la validation balisée pour la comparaison.
+ Pour comparer une validation spécifique, saisissez ou collez l'ID de validation dans la zone. Pour obtenir l'ID de validation complet, choisissez **Commits** dans la barre de navigation et copiez l'ID de validation figurant dans la liste. Sur la page **Comparer les validations**, collez l'ID de validation complet dans la zone de texte, puis choisissez **Use commit ID (Utiliser ID de validation)**.
![\[Comparez les branches, les tags ou les validations IDs\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-compare-2.png)
1. Une fois que vous avez sélectionné les spécificateurs, choisissez **Compare**.
![\[L'affichage de la comparaison entre deux branches\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-compare-branches.png)
Vous pouvez afficher les différences côte à côte (vue **fractionnée**) ou en ligne (vue **unifiée**). Vous pouvez également masquer ou afficher les modifications d'espaces.
1. Pour effacer vos choix de comparaison, choisissez **Annuler**.
# Commenter un commit dans AWS CodeCommit
Vous pouvez utiliser la CodeCommit console pour commenter les validations d'un dépôt, consulter les commentaires des autres utilisateurs sur les validations et y répondre. Cette fonction vous permet de discuter des modifications effectuées dans un référentiel et de répondre à des questions telles que :
+ Pourquoi les modifications ont-elles été effectuées ?
+ Des modifications supplémentaires sont-elles requises ?
+ Les modifications doivent-elles être fusionnées dans une autre branche ?
Les commentaires peuvent porter sur une validation globale, sur un fichier dans une validation, ou encore sur une ligne ou une modification spécifique dans un fichier. Vous pouvez également créer un lien vers une ligne de code en la sélectionnant, puis en copiant l'URL obtenue dans votre navigateur.
**Note**
Pour de meilleurs résultats, utilisez les commentaires lorsque vous êtes connecté en tant qu'utilisateur IAM. Celle-ci n'est pas optimisée pour les utilisateurs qui se connectent à l'aide des informations d'identification du compte racine, d'un accès fédéré ou d'informations d'identification temporaires.
**Topics**
+ [Afficher les commentaires sur un commit dans un dépôt](#how-to-commit-comment-view-console)
+ [Ajouter des commentaires sur un commit dans un dépôt et y répondre](#how-to-commit-comment-add-console)
+ [Afficher, ajouter, mettre à jour et répondre aux commentaires ()AWS CLI](#how-to-commit-comment-cli)
## Afficher les commentaires sur un commit dans un dépôt
Vous pouvez utiliser la CodeCommit console pour afficher les commentaires sur un commit.
**Pour afficher les commentaires relatifs à une validation**
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 référentiel pour lequel vous souhaitez consulter les commentaires de validation.
1. Dans le volet de navigation, choisissez **Validations**. Choisissez l'ID de la validation dans laquelle vous souhaitez afficher les commentaires.
La page associée à cette validation s'affiche, ainsi que les éventuels commentaires.
## Ajouter des commentaires sur un commit dans un dépôt et y répondre
Vous pouvez utiliser la CodeCommit console pour ajouter des commentaires à la comparaison d'un commit et d'un parent, ou à la comparaison entre deux validations spécifiées. Vous pouvez également répondre aux commentaires avec des emojis, avec vos propres commentaires, ou les deux.
### Ajouter des commentaires sur un commit et y répondre (console)
Vous pouvez ajouter des commentaires à un commit et y répondre avec du texte et des emojis. Vos commentaires et emojis sont marqués comme appartenant à l'utilisateur ou au rôle IAM que vous avez utilisé pour vous connecter à la console.
**Pour ajouter des commentaires et répondre aux commentaires existants sur une validation**
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 référentiel dans lequel vous souhaitez commenter les validations.
1. Dans le volet de navigation, choisissez **Validations**. Choisissez l'ID de la validation dans laquelle vous souhaitez ajouter des commentaires ou y répondre.
La page associée à cette validation s'affiche, ainsi que les éventuels commentaires.
1. Pour ajouter un commentaire, effectuez l'une des actions suivantes :
+ Pour ajouter un commentaire général, dans **Commentaires sur les modifications**, saisissez un commentaire, puis cliquez sur **Enregistrer**. Vous pouvez utiliser [Markdown](https://en.wikipedia.org/wiki/Markdown) ou saisir le commentaire en texte brut.
![\[Commentaire général relatif aux modifications dans une validation.\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-commenting-changecomment.png)
+ Pour ajouter un commentaire à un fichier dans la validation, recherchez le nom du fichier. Choisissez **Commenter le fichier**, saisissez votre commentaire, puis sélectionnez **Enregistrer**.
![\[Ajout d'un commentaire à un fichier dans une validation.\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-commenting-addfilecomment.png)
+ Pour ajouter un commentaire à une ligne modifiée dans la validation, accédez à la ligne dans laquelle la modification apparaît. Choisissez la bulle de commentaire ![\[The comment bubble icon that that indicates that you can leave a comment on that line of code.\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-commentbubble.png), saisissez votre commentaire, puis sélectionnez **Enregistrer**.
![\[Ajout d'un commentaire à une ligne dans une validation.\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-commenting-addlinecomment.png)
**Note**
Vous pouvez modifier votre commentaire après l'avoir enregistré. Vous pouvez également supprimer son contenu. Le commentaire restera avec un message indiquant que le contenu a été supprimé. Pensez à utiliser le mode **Aperçu de markdown** afin de vérifier le commentaire avant de l'enregistrer.
1. Pour répondre à des commentaires liés à une validation, sélectionnez **Répondre**. Pour répondre à un commentaire avec un emoji, choisissez l'emoji de votre choix dans la liste. Vous ne pouvez choisir qu'un seul emoji par commentaire. Si vous souhaitez modifier votre réaction aux emoji, choisissez-en une autre dans la liste ou choisissez **Aucune** pour supprimer votre réaction.
![\[Ajouter des réponses et des réactions emoji à un commentaire.\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-commenting-commenttab.png)
### Ajouter des commentaires et y répondre lors de la comparaison de deux spécificateurs de validation
Vous pouvez ajouter des commentaires à une comparaison entre des branches, des balises ou des validations.
**Pour ajouter des commentaires lors de la comparaison de spécificateurs de validation ou y répondre**
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**, choisissez le référentiel dans lequel vous souhaitez comparer des validations, des branches ou des validations balisées.
1. Dans le volet de navigation, choisissez **Validations**, puis l'onglet **Comparer les validations**.
![\[Comparaison de deux spécificateurs de validation quelconques\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-compare-1.png)
1. Utilisez les champs **Destination** et **Source** pour comparer deux spécificateurs de validation. Utilisez les listes déroulantes ou collez le commit IDs. Choisissez **Comparer**.
![\[Exemple de résultat lors de la comparaison d'un ID de validation à une branche\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-compare-4.png)
1. Effectuez une ou plusieurs des actions suivantes :
+ Pour ajouter des commentaires à des fichiers ou des lignes, choisissez la bulle de commentaire ![\[The comment bubble icon that that indicates that you can leave a comment on that line of code.\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-commentbubble.png).
+ Pour ajouter des commentaires généraux concernant la comparaison des modifications, accédez à **Commentaires sur les modifications**.
## Afficher, ajouter, mettre à jour et répondre aux commentaires ()AWS CLI
Vous pouvez afficher, ajouter, mettre à jour et supprimer le contenu d'un commentaire ou répondre à un commentaire en exécutant les commandes suivantes :
+ Pour afficher les commentaires sur la comparaison entre deux validations, exécutez **[get-comments-for-compared-commit](#how-to-commit-comment-cli-get-comments)**.
+ Pour afficher des détails sur un commentaire, exécutez [**get-comment**](#how-to-commit-comment-cli-get-comment-info).
+ Pour supprimer le contenu d'un commentaire que vous avez créé, exécutez [**delete-comment-content**](#how-to-commit-comment-cli-commit-delete).
+ Pour créer un commentaire sur la comparaison entre deux validations, exécutez [**post-comment-for-compared-commit**](#how-to-commit-comment-cli-comment).
+ Pour mettre à jour un commentaire, exécutez [**update-comment**](#how-to-commit-comment-cli-commit-update).
+ Pour répondre à un commentaire, exécutez [**post-comment-reply**](#how-to-commit-comment-cli-commit-reply).
+ Pour répondre à un commentaire avec un emoji, lancez [**put-comment-reaction**](#how-to-commit-comment-cli-commit-reply-emoji).
+ Pour voir les réactions des emoji à un commentaire, lancez [**get-comment-reactions**](#how-to-commit-comment-cli-commit-emoji-view).
### Pour afficher les commentaires relatifs à une validation
1. Exécutez la commande **get-comments-for-compared-commit** en indiquant :
+ Le nom du CodeCommit dépôt (avec l'`--repository-name`option).
+ L'ID de validation complet de l'après-validation pour établir la direction de la comparaison (avec l'option `--after-commit-id option`).
+ L'ID de validation complet de l'avant-validation pour établir la direction de la comparaison (avec l'option `--before-commit-id`).
+ (Facultatif) Un jeton d'énumération pour renvoyer le prochain lot de résultats (avec l'option `--next-token`).
+ (Facultatif) Un entier non négatif pour limiter le nombre de résultats renvoyés (avec l'option `--max-results`).
Par exemple, pour consulter les commentaires sur la comparaison entre deux validations dans un référentiel nommé *MyDemoRepo* :
```
aws codecommit get-comments-for-compared-commit --repository-name MyDemoRepo --before-commit-id 6e147360EXAMPLE --after-commit-id 317f8570EXAMPLE
```
1. Si elle aboutit, cette commande produit une sortie similaire à ce qui suit :
```
{
"commentsForComparedCommitData": [
{
"afterBlobId": "1f330709EXAMPLE",
"afterCommitId": "317f8570EXAMPLE",
"beforeBlobId": "80906a4cEXAMPLE",
"beforeCommitId": "6e147360EXAMPLE",
"comments": [
{
"authorArn": "arn:aws:iam::111111111111:user/Li_Juan",
"clientRequestToken": "123Example",
"commentId": "ff30b348EXAMPLEb9aa670f",
"content": "Whoops - I meant to add this comment to the line, not the file, but I don't see how to delete it.",
"creationDate": 1508369768.142,
"deleted": false,
"CommentId": "123abc-EXAMPLE",
"lastModifiedDate": 1508369842.278,
"callerReactions": [],
"reactionCounts":
{
"SMILE" : 6,
"THUMBSUP" : 1
}
},
{
"authorArn": "arn:aws:iam::111111111111:user/Li_Juan",
"clientRequestToken": "123Example",
"commentId": "553b509bEXAMPLE56198325",
"content": "Can you add a test case for this?",
"creationDate": 1508369612.240,
"deleted": false,
"commentId": "456def-EXAMPLE",
"lastModifiedDate": 1508369612.240,
"callerReactions": [],
"reactionCounts":
{
"THUMBSUP" : 2
}
}
],
"location": {
"filePath": "cl_sample.js",
"filePosition": 1232,
"relativeFileVersion": "after"
},
"repositoryName": "MyDemoRepo"
}
],
"nextToken": "exampleToken"
}
```
### Pour afficher les détails d'un commentaire sur une validation
1. Exécutez la commande **get-comment**, en spécifiant l'ID de commentaire généré par le système. Par exemple :
```
aws codecommit get-comment --comment-id ff30b348EXAMPLEb9aa670f
```
1. Si elle aboutit, cette commande renvoie une sortie similaire à ce qui suit :
```
{
"comment": {
"authorArn": "arn:aws:iam::111111111111:user/Li_Juan",
"clientRequestToken": "123Example",
"commentId": "ff30b348EXAMPLEb9aa670f",
"content": "Whoops - I meant to add this comment to the line, but I don't see how to delete it.",
"creationDate": 1508369768.142,
"deleted": false,
"commentId": "",
"lastModifiedDate": 1508369842.278,
"callerReactions": [],
"reactionCounts":
{
"SMILE" : 6,
"THUMBSUP" : 1
}
}
}
```
### Pour supprimer le contenu d'un commentaire sur une validation
1. Exécutez la commande **delete-comment-content**, en spécifiant l'ID de commentaire généré par le système. Par exemple :
```
aws codecommit delete-comment-content --comment-id ff30b348EXAMPLEb9aa670f
```
**Note**
Vous ne pouvez supprimer le contenu d'un commentaire que si la AWSCode CommitFullAccess politique est appliquée ou si l'`DeleteCommentContent`autorisation est définie sur **Autoriser**.
1. Si elle aboutit, cette commande produit une sortie similaire à ce qui suit :
```
{
"comment": {
"creationDate": 1508369768.142,
"deleted": true,
"lastModifiedDate": 1508369842.278,
"clientRequestToken": "123Example",
"commentId": "ff30b348EXAMPLEb9aa670f",
"authorArn": "arn:aws:iam::111111111111:user/Li_Juan",
"callerReactions": [],
"reactionCounts":
{
"CLAP" : 1
}
}
}
```
### Pour créer un commentaire sur une validation
1. Exécutez la commande **post-comment-for-compared-commit** en indiquant :
+ Le nom du CodeCommit dépôt (avec l'`--repository-name`option).
+ L'ID de validation complet de l'après-validation pour établir la direction de la comparaison (avec l'option `--after-commit-id `).
+ L'ID de validation complet de l'avant-validation pour établir la direction de la comparaison (avec l'option `--before-commit-id`).
+ Un jeton d'idempotence unique généré par le client (avec l'option **--client-request-token**).
+ Le contenu de votre commentaire (avec l'option **--content**).
+ Une liste d'informations concernant l'emplacement de ce commentaire, y compris :
+ Le nom du fichier en cours de comparaison, y compris son extension et le sous-répertoire, le cas échéant (avec l'attribut **filePath**).
+ Le numéro de ligne de la modification au sein d'un fichier de comparaison (avec l'attribut **filePosition**).
+ Une mention indiquant si le commentaire sur la modification se situe « avant » ou « après » dans la comparaison entre les branches source et de destination (avec l'attribut **relativeFileVersion**).
Par exemple, pour ajouter le commentaire *"Can you add a test case for this?"* sur la modification apportée au *cl\$1sample.js* fichier dans la comparaison entre deux validations dans un référentiel nommé *MyDemoRepo* :
```
aws codecommit post-comment-for-compared-commit --repository-name MyDemoRepo --before-commit-id 317f8570EXAMPLE --after-commit-id 5d036259EXAMPLE --client-request-token 123Example --content "Can you add a test case for this?" --location filePath=cl_sample.js,filePosition=1232,relativeFileVersion=AFTER
```
1. Si elle aboutit, cette commande produit une sortie similaire à ce qui suit :
```
{
"afterBlobId": "1f330709EXAMPLE",
"afterCommitId": "317f8570EXAMPLE",
"beforeBlobId": "80906a4cEXAMPLE",
"beforeCommitId": "6e147360EXAMPLE",
"comment": {
"authorArn": "arn:aws:iam::111111111111:user/Li_Juan",
"clientRequestToken": "",
"commentId": "553b509bEXAMPLE56198325",
"content": "Can you add a test case for this?",
"creationDate": 1508369612.203,
"deleted": false,
"commentId": "abc123-EXAMPLE",
"lastModifiedDate": 1508369612.203,
"callerReactions": [],
"reactionCounts": []
},
"location": {
"filePath": "cl_sample.js",
"filePosition": 1232,
"relativeFileVersion": "AFTER"
},
"repositoryName": "MyDemoRepo"
}
```
### Pour mettre à jour un commentaire sur une validation
1. Exécutez la commande **update-comment** en spécifiant l'ID de commentaire généré par le système et le contenu par lequel vous souhaitez remplacer le contenu existant.
Par exemple, pour ajouter le contenu *"Fixed as requested. I'll update the pull request."* à un commentaire dont l'identifiant est *442b498bEXAMPLE5756813* :
```
aws codecommit update-comment --comment-id 442b498bEXAMPLE5756813 --content "Fixed as requested. I'll update the pull request."
```
1. Si elle aboutit, cette commande produit une sortie similaire à ce qui suit :
```
{
"comment": {
"authorArn": "arn:aws:iam::111111111111:user/Li_Juan",
"clientRequestToken": "",
"commentId": "442b498bEXAMPLE5756813",
"content": "Fixed as requested. I'll update the pull request.",
"creationDate": 1508369929.783,
"deleted": false,
"lastModifiedDate": 1508369929.287,
"callerReactions": [],
"reactionCounts":
{
"THUMBSUP" : 2
}
}
}
```
### Pour répondre à un commentaire sur une validation
1. Pour publier une réponse à un commentaire dans une demande d'extraction, exécutez la commande **post-comment-reply**, en spécifiant les éléments suivants :
+ L'ID, généré par le système, du commentaire auquel vous souhaitez répondre (avec l'option **--in-reply-to**).
+ Un jeton d'idempotence unique généré par le client (avec l'option **--client-request-token**).
+ Le contenu de votre réponse (avec l'option**--content**).
Par exemple, pour ajouter la réponse *"Good catch. I'll remove them."* au commentaire avec l'ID généré par le système : *abcd1234EXAMPLEb5678efgh*
```
aws codecommit post-comment-reply --in-reply-to abcd1234EXAMPLEb5678efgh --content "Good catch. I'll remove them." --client-request-token 123Example
```
1. Si elle aboutit, cette commande produit une sortie similaire à ce qui suit :
```
{
"comment": {
"authorArn": "arn:aws:iam::111111111111:user/Li_Juan",
"clientRequestToken": "123Example",
"commentId": "442b498bEXAMPLE5756813",
"content": "Good catch. I'll remove them.",
"creationDate": 1508369829.136,
"deleted": false,
"CommentId": "abcd1234EXAMPLEb5678efgh",
"lastModifiedDate": 150836912.221,
"callerReactions": [],
"reactionCounts": []
}
}
```
### Pour répondre à un commentaire sur une validation avec un emoji
1. Pour répondre à un commentaire dans une pull request avec un emoji, ou pour modifier la valeur de votre réaction emoji, exécutez la **put-comment-reaction** commande en spécifiant :
+ L'identifiant généré par le système du commentaire auquel vous souhaitez répondre avec un emoji.
+ La valeur de la réaction que vous souhaitez ajouter ou mettre à jour. Les valeurs acceptables incluent les emojis, les shortcodes et les valeurs Unicode pris en charge.
Les valeurs suivantes sont prises en charge pour les emojis dans CodeCommit :
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/how-to-commit-comment.html)
Par exemple, pour ajouter l'emoji *:thumbsup:* au commentaire avec l'identifiant généré par le système : *abcd1234EXAMPLEb5678efgh*
```
aws codecommit put-comment-reaction --comment-id abcd1234EXAMPLEb5678efgh --reaction-value :thumbsup:
```
1. Cette commande ne produit aucune sortie si elle réussit.
### Pour afficher des réactions par emoji à un commentaire
1. Pour afficher les réactions des emojis à un commentaire, y compris les utilisateurs qui ont réagi avec ces émojis, exécutez la **get-comment-reactions** commande en spécifiant l'identifiant du commentaire généré par le système.
Par exemple, pour afficher les réactions des emoji au commentaire dont l'identifiant généré par le système est le suivant : *abcd1234EXAMPLEb5678efgh*
```
aws codecommit get-comment-reactions --comment-id abcd1234EXAMPLEb5678efgh
```
1. Si elle aboutit, cette commande produit une sortie similaire à ce qui suit :
```
{
"reactionsForComment": {
[
{
"reaction": {
"emoji:"👍",
"shortCode": "thumbsup",
"unicode": "U+1F44D"
},
"users": [
"arn:aws:iam::123456789012:user/Li_Juan",
"arn:aws:iam::123456789012:user/Mary_Major",
"arn:aws:iam::123456789012:user/Jorge_Souza"
]
},
{
"reaction": {
"emoji": "👎",
"shortCode": "thumbsdown",
"unicode": "U+1F44E"
},
"users": [
"arn:aws:iam::123456789012:user/Nikhil_Jayashankar"
]
},
{
"reaction": {
"emoji": "😕",
"shortCode": "confused",
"unicode": "U+1F615"
},
"users": [
"arn:aws:iam::123456789012:user/Saanvi_Sarkar"
]
}
]
}
}
```
# Créez une balise Git dans AWS CodeCommit
Vous pouvez utiliser une balise Git pour ajouter une étiquette à une validation afin de permettre à d'autres utilisateurs du référentiel de comprendre son importance. Pour créer une balise Git dans un CodeCommit dépôt, vous pouvez utiliser Git depuis un dépôt local connecté au CodeCommit dépôt. Après avoir créé une balise Git dans le dépôt local, vous pouvez l'utiliser **git push --tags** pour la transférer vers le CodeCommit référentiel.
Pour de plus amples informations, veuillez consulter [Afficher les détails du tag](how-to-view-tag-details.md).
## Utiliser Git pour créer un tag
Suivez ces étapes pour utiliser Git depuis un dépôt local afin de créer une balise Git dans un CodeCommit référentiel.
Dans ces étapes, nous partons du principe que vous avez déjà connecté le dépôt local au CodeCommit référentiel. Pour obtenir des instructions, veuillez consulter [Connexion à un référentiel](how-to-connect.md).
1. Exécutez la **git tag *new-tag-name* *commit-id*** commande, où *new-tag-name* se trouvent le nom de la nouvelle balise *commit-id* Git et l'ID du commit à associer à la balise Git.
Par exemple, la commande suivante crée une balise Git nommée `beta` et l'associe à l'ID de validation `dc082f9a...af873b88` :
```
git tag beta dc082f9a...af873b88
```
1. Pour transférer la nouvelle balise Git du dépôt local vers le CodeCommit dépôt, exécutez la **git push *remote-name* *new-tag-name*** commande, où *remote-name* sont le nom du CodeCommit dépôt et *new-tag-name* le nom de la nouvelle balise Git.
Par exemple, pour envoyer une nouvelle balise Git nommée `beta` à un CodeCommit dépôt nommé `origin` :
```
git push origin beta
```
**Note**
Pour transférer toutes les nouvelles balises Git de votre dépôt local vers le CodeCommit référentiel, exécutez**git push --tags**.
Pour vous assurer que votre dépôt local est mis à jour avec toutes les balises Git du CodeCommit référentiel, exécutez **git fetch** puis. **git fetch --tags**
Pour plus d'options, consultez votre documentation Git.
# Afficher les détails du tag Git dans AWS CodeCommit
Dans Git, une balise est une étiquette que vous pouvez appliquer à une référence, telle qu'une validation, pour y inclure des informations susceptibles d'intéresser les autres utilisateurs du référentiel. Vous pouvez, par exemple, ajouter la balise **beta** à la validation qui a servi de version bêta à un projet. Pour de plus amples informations, veuillez consulter [Utiliser Git pour créer un tag](how-to-create-tag.md#how-to-create-tag-git). Les balises Git sont différentes des balises de dépôt. Pour plus d'informations sur l'utilisation des balises de référentiel, consultez [Ajout d’une balise à un référentiel](how-to-tag-repository-add.md).
Vous pouvez utiliser la AWS CodeCommit console pour consulter les informations relatives aux balises Git de votre dépôt, notamment la date et le message de validation référencé par chaque balise Git. À partir de la console, vous pouvez comparer la validation référencée par la balise avec la section HEAD de la branche par défaut du référentiel. Comme pour toute autre validation, vous pouvez également afficher le code au niveau de cette balise Git.
Vous pouvez également utiliser Git depuis votre terminal ou votre ligne de commande pour afficher les détails relatifs aux balises Git dans un dépôt local.
**Topics**
+ [Afficher les détails du tag (console)](#how-to-view-tag-details-console)
+ [Afficher les détails des balises Git (Git)](#how-to-view-tag-details-git)
## Afficher les détails du tag (console)
Utilisez la AWS CodeCommit console pour afficher rapidement la liste des balises Git pour votre dépôt et les détails des validations référencées par les balises Git.
1. Ouvrez la CodeCommit console sur [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home).
1. Dans **Repositories** (Référentiels), sélectionnez le nom du référentiel dans lequel vous souhaitez afficher les balises.
1. Dans le panneau de navigation, choisissez **Git tags (Balises Git)**.
![\[Vue des balises dans un référentiel.\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-tags-view.png)
1. Effectuez l’une des actions suivantes :
+ Pour afficher le code tel qu'il est au niveau de la validation, choisissez le nom de la balise Git.
+ Pour afficher les détails de la validation, y compris le message de validation complet, le valideur et l'auteur, choisissez l'ID de validation abrégé.
## Afficher les détails des balises Git (Git)
Pour utiliser Git afin d'afficher les détails relatifs aux balises Git dans un dépôt local, exécutez l'une des commandes suivantes :
+ [git tag](#how-to-view-tag-details-git-tag) pour afficher une liste de noms de balise Git.
+ [git show](#how-to-view-tag-details-git-show) pour afficher des informations sur une balise Git spécifique.
+ [git ls-remote](#how-to-view-tag-details-git-remote) pour afficher des informations sur les balises Git dans un CodeCommit dépôt.
**Note**
Pour vous assurer que votre dépôt local est mis à jour avec toutes les balises Git du CodeCommit référentiel, exécutez **git fetch** puis. **git fetch --tags**
Dans les étapes suivantes, nous partons du principe que vous avez déjà connecté le dépôt local à un CodeCommit référentiel. Pour obtenir des instructions, veuillez consulter [Connexion à un référentiel](how-to-connect.md).
### Pour afficher la liste des balises Git dans un dépôt local
1. Exécutez la commande **git tag** :
```
git tag
```
1. Si elle aboutit, cette commande produit une sortie similaire à ce qui suit :
```
beta
release
```
**Note**
Si aucune balise n'a été définie, **git tag** ne renvoie rien.
Pour plus d'options, consultez votre documentation Git.
### Pour afficher les informations relatives à une balise Git dans un dépôt local
1. Exécutez la commande **git show *tag-name***. Par exemple, pour afficher des informations sur une balise Git nommée `beta`, exécutez :
```
git show beta
```
1. Si elle aboutit, cette commande produit une sortie similaire à ce qui suit :
```
commit 317f8570...ad9e3c09
Author: John Doe
Date: Tue Sep 23 13:49:51 2014 -0700
Added horse.txt
diff --git a/horse.txt b/horse.txt
new file mode 100644
index 0000000..df42ff1
--- /dev/null
+++ b/horse.txt
@@ -0,0 +1 @@
+The horse (Equus ferus caballus) is one of two extant subspecies of Equus ferus
\ No newline at end of file
```
**Note**
Pour quitter la sortie des informations de balise Git, tapez **:q**.
Pour plus d'options, consultez votre documentation Git.
### Pour afficher des informations sur les balises Git dans un CodeCommit référentiel
1. Exécutez la commande **git ls-remote --tags**.
```
git ls-remote --tags
```
1. En cas de succès, cette commande produit en sortie une liste des balises Git du CodeCommit dépôt :
```
129ce87a...70fbffba refs/tags/beta
785de9bd...59b402d8 refs/tags/release
```
Si aucune balise Git n'a été définie, **git ls-remote --tags** renvoie une ligne vide.
Pour plus d'options, consultez votre documentation Git.
# Supprimer une balise Git dans AWS CodeCommit
Pour supprimer une balise Git dans un CodeCommit dépôt, utilisez Git depuis un dépôt local connecté au CodeCommit dépôt.
## Utiliser Git pour supprimer une balise Git
Suivez ces étapes pour utiliser Git depuis un dépôt local afin de supprimer une balise Git dans un CodeCommit référentiel.
Ces étapes sont écrites en supposant que vous avez déjà connecté le dépôt local au CodeCommit référentiel. Pour obtenir des instructions, veuillez consulter [Connexion à un référentiel](how-to-connect.md).
1. Pour supprimer la balise Git du dépôt local, exécutez la **git tag -d *tag-name*** commande contenant le *tag-name* nom de la balise Git que vous souhaitez supprimer.
**Astuce**
Pour obtenir une liste des noms de balise Git, exécutez **git tag**.
Par exemple, pour supprimer une balise Git dans le dépôt local nommé `beta` :
```
git tag -d beta
```
1. Pour supprimer la balise Git du CodeCommit dépôt, exécutez la **git push *remote-name* --delete *tag-name*** commande où *remote-name* est le surnom que le dépôt local utilise pour le CodeCommit dépôt et *tag-name* le nom de la balise Git que vous souhaitez supprimer du CodeCommit référentiel.
**Astuce**
Pour obtenir une liste des noms de CodeCommit référentiels et leurs noms URLs, exécutez la **git remote -v** commande.
Par exemple, pour supprimer une balise Git nommée `beta` dans le CodeCommit référentiel nommé `origin` :
```
git push origin --delete beta
```