對 中的遞交的評論 AWS CodeCommit - AWS CodeCommit

AWS CodeCommit 不再提供給新客戶。的現有客戶 AWS CodeCommit 可以繼續正常使用服務。進一步了解"

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

對 中的遞交的評論 AWS CodeCommit

您可以使用 CodeCommit 主控台對儲存庫中的遞交進行評論,並檢視和回覆其他使用者對遞交的評論。這可協助您討論對儲存庫中進行的變更,包括:

  • 為什麼進行變更。

  • 是否需要更多變更。

  • 是否應將變更合併到另一個分支。

您可以對整體遞交、對遞交中的檔案或檔案內的特定行或變更進行評論。您也可以透過選取行,然後在瀏覽器URL中複製產生的 來連結至一行程式碼。

注意

為了獲得最佳結果,請在以IAM使用者身分登入時使用評論。未針對使用根帳戶登入資料、聯合存取或臨時登入資料登入的使用者最佳化評論功能。

檢視儲存庫中遞交的評論

您可以使用 CodeCommit 主控台來檢視遞交的評論。

檢視對遞交的評論
  1. https://console.aws.amazon.com/codesuite/Codecommit/home 開啟 CodeCommit 主控台。

  2. Repositories (儲存庫) 中,選擇您要檢閱對遞交評論的儲存庫。

  3. 在導覽窗格中,選擇 Commits (遞交)。選擇您想要檢視任何評論的遞交之遞交 ID。

    隨即會顯示該遞交的頁面,以及任何評論。

新增並回覆對儲存庫中遞交的評論

您可以使用 CodeCommit 主控台將註解新增至遞交與父項的比較,或新增至兩個指定遞交之間的比較。您也可以使用表情符號、您自己的註解或兩者來回覆註解。

新增並回覆遞交 (主控台) 的評論

您可以使用文字和表情符號,將評論新增和回覆至遞交。您的評論和表情符號會標記為屬於您用來登入主控台IAM的使用者或角色。

新增和回覆對遞交的評論
  1. https://console.aws.amazon.com/codesuite/Codecommit/home 開啟 CodeCommit 主控台。

  2. Repositories (儲存庫) 中,選擇您要對遞交評論所在的儲存庫。

  3. 在導覽窗格中,選擇 Commits (遞交)。選擇您想要新增或回覆評論所在的遞交之遞交 ID。

    隨即會顯示該遞交的頁面,以及任何評論。

  4. 若要新增評論,請執行以下其中一項:

    • 若要新增一般評論,請在 ​Comments on changes (對變更加上評論) 中,輸入評論,然後選擇 Save (儲存)。您可以使用 Markdown,或也可以純文字輸入您的評論。

      對遞交中變更的一般評論。
    • 若要對遞交中的檔案新增評論,請找到檔案的名稱。選擇 Comment on file (對檔案加上評論),輸入您的評論,然後選擇 Save (儲存)

      對遞交中的檔案新增評論。
    • 若要對遞交中變更的一行新增評論,請前往變更出現的行。選擇評論氣泡 The comment bubble icon that that indicates that you can leave a comment on that line of code. ,輸入您的評論,然後選擇 Save (儲存)

      對遞交中的一行新增評論。
    注意

    在儲存評論之後,您可以編輯評論,也可以刪除其內容。該評論將保留一則訊息,指出內容已遭刪除。考慮為您的評論使用 Preview markdown (預覽 Markdown) 模式,之後再進行儲存。

  5. 若要回覆對遞交的評論,請選擇 Reply (回覆)。若要使用表情符號回覆評論,請從清單中選擇您想要的表情符號。每個評論只能選擇一個表情符號。如果您想要變更表情符號反應,請選擇與清單中不同的表情符號反應,或選擇以移除您的反應。

    將回應和表情符號反應新增至註解。

在比較兩個遞交規格符時新增和回覆評論

您可以對分支、標籤或遞交之間的比較新增評論。

比較遞交指標時新增和回覆評論
  1. https://console.aws.amazon.com/codesuite/Codecommit/home 開啟 CodeCommit 主控台。

  2. Repositories (儲存庫) 中,選擇您要比較遞交、分支或附加標籤之遞交所在的儲存庫。

  3. 在導覽窗格中,選擇 Commits (遞交),然後選擇 Compare commits (比較遞交) 索引標籤。

    比較任兩個遞交指標
  4. 使用 Destination (目的地)Source (來源) 欄位來比較兩個遞交指標。使用下拉式清單或貼入遞交 IDs。選擇 Compare (比較)

    將遞交 ID 與分支比較的範例結果
  5. 執行下列其中一項或多項:

    • 若要將新增評論到檔案或行,請選擇評論氣泡 The comment bubble icon that that indicates that you can leave a comment on that line of code.

    • 若要對比較的變更新增一般評論,請移至 Comments on changes (對變更的評論)

檢視、新增、更新和回覆評論 (AWS CLI)

您可以透過執行下列命令來檢視、新增、回覆、更新和刪除評論的內容:

檢視對遞交的評論

  1. 執行 get-comments-for-compared-commit 命令,並指定:

    • CodeCommit 儲存庫的名稱 (含 --repository-name選項)。

    • 之後遞交的完整遞交 ID,以建立比較的方向性 (使用 --after-commit-id option)。

    • 之前遞交的完整遞交 ID,以建立比較的方向性 (使用 --before-commit-id 選項)。

    • (選用) 用來傳回下一個批次結果的列舉符記 (使用 --next-token 選項)。

    • (選用) 一個非負整數,用來限制傳回的結果 (使用 --max-results 選項)。

    例如,檢視名為 的儲存庫中兩個遞交之間的比較的註解 MyDemoRepo:

    aws codecommit get-comments-for-compared-commit --repository-name MyDemoRepo --before-commit-id 6e147360EXAMPLE --after-commit-id 317f8570EXAMPLE
  2. 如果此命令成功執行,您會看到類似如下的輸出產生:

    { "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" }

檢視對遞交評論的詳細資訊

  1. 執行 get-comment 命令,指定系統產生的評論 ID。例如:

    aws codecommit get-comment --comment-id ff30b348EXAMPLEb9aa670f
  2. 如果此命令成功執行,您會看到類似如下的輸出傳回:

    { "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 } } }

刪除對遞交評論的內容

  1. 執行 delete-comment-content 命令,指定系統產生的評論 ID。例如:

    aws codecommit delete-comment-content --comment-id ff30b348EXAMPLEb9aa670f
    注意

    只有在套用 AWSCodeCommitFullAccess 政策,或將DeleteCommentContent許可設定為允許 時,才能刪除評論的內容。

  2. 如果此命令成功執行,您會看到類似如下的輸出產生:

    { "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 } } }

建立對遞交的評論

  1. 執行 post-comment-for-compared-commit 命令,並指定:

    • CodeCommit 儲存庫的名稱 (含 --repository-name選項)。

    • 之後遞交的完整遞交 ID,以建立比較的方向性 (使用 --after-commit-id 選項)。

    • 之前遞交的完整遞交 ID,以建立比較的方向性 (使用 --before-commit-id 選項)。

    • 唯一的用戶端產生冪等符記 (使用 --client-request-token 選項)。

    • 評論的內容 (使用 --content 選項)。

    • 可放置評論位置的清單位置相關資訊,包括:

      • 要比較的檔案名稱,包括其副檔名和子目錄 (如果有) (使用 filePath 屬性)。

      • 比較檔案內變更的行號 (使用 filePosition 屬性)。

      • 對變更的評論在來源與目的地分支之間的比較中為之前或之後 (使用 relativeFileVersion 屬性)。

    例如,新增註解 "Can you add a test case for this?" 在 的變更上 cl_sample.js 檔案在名為 的儲存庫中兩個遞交之間的比較 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
  2. 如果此命令成功執行,您會看到類似如下的輸出產生:

    { "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" }

更新對遞交的評論

  1. 執行 update-comment 命令,指定系統產生的評論 ID 和您要用來取代任何現有內容的內容。

    例如,新增內容 "Fixed as requested. I'll update the pull request." 至 ID 為 的評論 442b498bEXAMPLE5756813:

    aws codecommit update-comment --comment-id 442b498bEXAMPLE5756813 --content "Fixed as requested. I'll update the pull request."
  2. 如果此命令成功執行,您會看到類似如下的輸出產生:

    { "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 } } }

回覆對遞交的評論

  1. 若要對提取請求中的評論張貼回覆,請執行 post-comment-reply 命令,指定:

    • 您要回覆的評論由系統產生的 ID (使用 --in-reply-to 選項)。

    • 唯一的用戶端產生冪等符記 (使用 --client-request-token 選項)。

    • 回覆的內容 (使用 --content 選項)。

    例如,新增回覆 "Good catch. I'll remove them." 至具有系統產生的 ID 為 的註解 abcd1234EXAMPLEb5678efgh:

    aws codecommit post-comment-reply --in-reply-to abcd1234EXAMPLEb5678efgh --content "Good catch. I'll remove them." --client-request-token 123Example
  2. 如果此命令成功執行,您會看到類似如下的輸出產生:

    { "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": [] } }

使用表情符號回覆遞交的評論

  1. 若要使用表情符號回應提取請求中的註解,或變更表情符號反應的值,請執行 put-comment-reaction命令,指定:

    • 您要使用表情符號回覆之註解的系統產生的 ID。

    • 您要新增或更新的反應值。可接受的值包括支援的表情符號、短碼和 Unicode 值。

    中的表情符號支援下列值 CodeCommit:

    表情符號 ShortCode Unicode

    👍

    :thumbsup:

    U+1F44D

    👎

    :thumbsdown:

    U+1F44E

    😄

    :smile:

    U+1F604

    :heart:

    U+2764

    😠

    :angry:

    U+1F620

    😕

    :confused:

    U+1F615

    😱

    :scream:

    U+1F631

    😭

    :sob:

    U+1F62D

    👏

    :clap:

    U+1F44F

    🎊

    :confetti_ball:

    U+1F38A

    🚢

    :ship:

    U+1F6A2

    👀

    :eyes:

    U+1F440

    U+0000

    例如,新增表情符號 :thumbsup: 至具有系統產生的 ID 為 的註解 abcd1234EXAMPLEb5678efgh:

    aws codecommit put-comment-reaction --comment-id abcd1234EXAMPLEb5678efgh --reaction-value :thumbsup:
  2. 如果成功,此命令不會產生輸出。

檢視對註解的表情符號反應

  1. 若要檢視註解的表情符號反應,包括與這些表情符號做出反應的使用者,請執行 get-comment-reactions命令,指定註解的系統產生 ID。

    例如,若要檢視系統產生 ID 為 的註解的表情符號反應 abcd1234EXAMPLEb5678efgh:

    aws codecommit get-comment-reactions --comment-id abcd1234EXAMPLEb5678efgh
  2. 如果此命令成功執行,您會看到類似如下的輸出產生:

    { "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" ] } ] } }