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.
# 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"
]
}
]
}
}
```