AWS CodeCommit 不再提供給新客戶。的現有客戶 AWS CodeCommit 可以繼續正常使用服務。進一步了解"
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
對 中的遞交的評論 AWS CodeCommit
您可以使用 CodeCommit 主控台對儲存庫中的遞交進行評論,並檢視和回覆其他使用者對遞交的評論。這可協助您討論對儲存庫中進行的變更,包括:
為什麼進行變更。
是否需要更多變更。
是否應將變更合併到另一個分支。
您可以對整體遞交、對遞交中的檔案或檔案內的特定行或變更進行評論。您也可以透過選取行,然後在瀏覽器URL中複製產生的 來連結至一行程式碼。
注意
為了獲得最佳結果,請在以IAM使用者身分登入時使用評論。未針對使用根帳戶登入資料、聯合存取或臨時登入資料登入的使用者最佳化評論功能。
檢視儲存庫中遞交的評論
您可以使用 CodeCommit 主控台來檢視遞交的評論。
檢視對遞交的評論
在 https://console.aws.amazon.com/codesuite/Codecommit/home
開啟 CodeCommit 主控台。 -
在 Repositories (儲存庫) 中,選擇您要檢閱對遞交評論的儲存庫。
-
在導覽窗格中,選擇 Commits (遞交)。選擇您想要檢視任何評論的遞交之遞交 ID。
隨即會顯示該遞交的頁面,以及任何評論。
新增並回覆對儲存庫中遞交的評論
您可以使用 CodeCommit 主控台將註解新增至遞交與父項的比較,或新增至兩個指定遞交之間的比較。您也可以使用表情符號、您自己的註解或兩者來回覆註解。
新增並回覆遞交 (主控台) 的評論
您可以使用文字和表情符號,將評論新增和回覆至遞交。您的評論和表情符號會標記為屬於您用來登入主控台IAM的使用者或角色。
新增和回覆對遞交的評論
在 https://console.aws.amazon.com/codesuite/Codecommit/home
開啟 CodeCommit 主控台。 -
在 Repositories (儲存庫) 中,選擇您要對遞交評論所在的儲存庫。
-
在導覽窗格中,選擇 Commits (遞交)。選擇您想要新增或回覆評論所在的遞交之遞交 ID。
隨即會顯示該遞交的頁面,以及任何評論。
-
若要新增評論,請執行以下其中一項:
-
若要新增一般評論,請在 Comments on changes (對變更加上評論) 中,輸入評論,然後選擇 Save (儲存)。您可以使用 Markdown
,或也可以純文字輸入您的評論。 -
若要對遞交中的檔案新增評論,請找到檔案的名稱。選擇 Comment on file (對檔案加上評論),輸入您的評論,然後選擇 Save (儲存)。
-
若要對遞交中變更的一行新增評論,請前往變更出現的行。選擇評論氣泡 ,輸入您的評論,然後選擇 Save (儲存)。
注意
在儲存評論之後,您可以編輯評論,也可以刪除其內容。該評論將保留一則訊息,指出內容已遭刪除。考慮為您的評論使用 Preview markdown (預覽 Markdown) 模式,之後再進行儲存。
-
-
若要回覆對遞交的評論,請選擇 Reply (回覆)。若要使用表情符號回覆評論,請從清單中選擇您想要的表情符號。每個評論只能選擇一個表情符號。如果您想要變更表情符號反應,請選擇與清單中不同的表情符號反應,或選擇無以移除您的反應。
在比較兩個遞交規格符時新增和回覆評論
您可以對分支、標籤或遞交之間的比較新增評論。
比較遞交指標時新增和回覆評論
在 https://console.aws.amazon.com/codesuite/Codecommit/home
開啟 CodeCommit 主控台。 -
在 Repositories (儲存庫) 中,選擇您要比較遞交、分支或附加標籤之遞交所在的儲存庫。
-
在導覽窗格中,選擇 Commits (遞交),然後選擇 Compare commits (比較遞交) 索引標籤。
使用 Destination (目的地) 和 Source (來源) 欄位來比較兩個遞交指標。使用下拉式清單或貼入遞交 IDs。選擇 Compare (比較)。
-
執行下列其中一項或多項:
-
若要將新增評論到檔案或行,請選擇評論氣泡 。
-
若要對比較的變更新增一般評論,請移至 Comments on changes (對變更的評論)。
-
檢視、新增、更新和回覆評論 (AWS CLI)
您可以透過執行下列命令來檢視、新增、回覆、更新和刪除評論的內容:
-
若要檢視兩個遞交間比較的評論,請執行 get-comments-for-compared-commit。
-
若要檢視評論的詳細資訊,請執行 get-comment。
-
若要刪除您建立的評論內容,請執行 delete-comment-content。
-
若要對兩個遞交間的比較建立評論,請執行 post-comment-for-compared-commit。
-
若要更新評論,請執行 update-comment。
-
若要回覆註解,請執行 post-comment-reply。
-
若要使用表情符號回覆評論,請執行 put-comment-reaction。
-
若要檢視註解的表情符號回應,請執行 get-comment-reactions。
檢視對遞交的評論
-
執行 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-id6e147360EXAMPLE
--after-commit-id317f8570EXAMPLE
-
-
如果此命令成功執行,您會看到類似如下的輸出產生:
{ "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" }
檢視對遞交評論的詳細資訊
-
執行 get-comment 命令,指定系統產生的評論 ID。例如:
aws codecommit get-comment --comment-id ff30b348EXAMPLEb9aa670f
-
如果此命令成功執行,您會看到類似如下的輸出傳回:
{ "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 } } }
刪除對遞交評論的內容
-
執行 delete-comment-content 命令,指定系統產生的評論 ID。例如:
aws codecommit delete-comment-content --comment-id ff30b348EXAMPLEb9aa670f
注意
只有在套用 AWSCodeCommitFullAccess 政策,或將
DeleteCommentContent
許可設定為允許 時,才能刪除評論的內容。 -
如果此命令成功執行,您會看到類似如下的輸出產生:
{ "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 } } }
建立對遞交的評論
-
執行 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
-
-
如果此命令成功執行,您會看到類似如下的輸出產生:
{ "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" }
更新對遞交的評論
-
執行 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." -
如果此命令成功執行,您會看到類似如下的輸出產生:
{ "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 } } }
回覆對遞交的評論
-
若要對提取請求中的評論張貼回覆,請執行 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-token123Example
-
-
如果此命令成功執行,您會看到類似如下的輸出產生:
{ "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": [] } }
使用表情符號回覆遞交的評論
-
若要使用表情符號回應提取請求中的註解,或變更表情符號反應的值,請執行 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:
-
-
如果成功,此命令不會產生輸出。
檢視對註解的表情符號反應
-
若要檢視註解的表情符號反應,包括與這些表情符號做出反應的使用者,請執行 get-comment-reactions命令,指定註解的系統產生 ID。
例如,若要檢視系統產生 ID 為 的註解的表情符號反應
abcd1234EXAMPLEb5678efgh
:aws codecommit get-comment-reactions --comment-id
abcd1234EXAMPLEb5678efgh
-
如果此命令成功執行,您會看到類似如下的輸出產生:
{ "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" ] } ] } }