Komentari komit di AWS CodeCommit - AWS CodeCommit

AWS CodeCommit tidak lagi tersedia untuk pelanggan baru. Pelanggan yang sudah ada AWS CodeCommit dapat terus menggunakan layanan seperti biasa. Pelajari lebih lanjut”

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Komentari komit di AWS CodeCommit

Anda dapat menggunakan CodeCommit konsol untuk mengomentari komit di repositori, dan melihat serta membalas komentar pengguna lain tentang komit. Ini dapat membantu Anda mendiskusikan perubahan yang dibuat dalam repositori, termasuk:

  • Mengapa perubahan dibuat.

  • Apakah lebih banyak perubahan diperlukan.

  • Apakah perubahan harus digabung ke cabang lain.

Anda dapat mengomentari commit keseluruhan, file dalam commit, atau baris tertentu atau perubahan dalam file. Anda juga dapat menautkan ke baris kode dengan memilih baris dan kemudian menyalin hasil URL di browser Anda.

catatan

Untuk hasil terbaik, gunakan komentar saat Anda masuk sebagai IAM pengguna. Fungsi komentar tidak dioptimalkan untuk pengguna yang masuk dengan kredensial akun akar, akses federasi, atau kredensial sementara.

Tampilkan komentar pada commit dalam repositori

Anda dapat menggunakan CodeCommit konsol untuk melihat komentar pada komit.

Untuk menampilkan komentar pada commit
  1. Buka CodeCommit konsol di https://console.aws.amazon.com/codesuite/codecommit/home.

  2. Di Repositori, pilih repositori yang ingin Anda tinjau komentarnya pada commit.

  3. Di panel navigasi, pilih Commit. Pilih ID commit dari commit tersebut di mana Anda ingin melihat komentar apapun.

    Halaman untuk commit yang ditampilkan, bersama dengan komentar apapun.

Tambahkandan balas komentar pada commit dalam repositori

Anda dapat menggunakan CodeCommit konsol untuk menambahkan komentar ke perbandingan komit dan induk, atau perbandingan antara dua komit yang ditentukan. Anda juga dapat membalas komentar dengan emoji, dengan komentar Anda sendiri, atau keduanya.

Menambah dan membalas komentar pada commit (konsol)

Anda dapat menambah dan membalas komentar untuk commit dengan teks dan dengan emoji. Komentar dan emoji Anda ditandai sebagai milik IAM pengguna atau peran yang Anda gunakan untuk masuk ke konsol.

Untuk menambah dan membalas komentar pada commit
  1. Buka CodeCommit konsol di https://console.aws.amazon.com/codesuite/codecommit/home.

  2. Di Repositori, pilih repositori yang ingin Anda komentari pada commit.

  3. Di panel navigasi, pilih Commit. Pilih ID commit dari commit tersebut di mana Anda ingin menambahkan atau membalas komentar.

    Halaman untuk commit tersebut ditampilkan, bersama dengan komentar apapun.

  4. Untuk menambahkan komentar, lakukan salah satu hal berikut:

    • Untuk menambahkan komentar umum, di Komentar tentang perubahan, masukkan komentar Anda, dan kemudian pilih Simpan. Anda dapat menggunakan Markdown, atau Anda dapat memasukkan komentar Anda di plaintext.

      Sebuah komentar umum pada perubahan di sebuah commit.
    • Untuk menambahkan komentar ke file dalam commit, cari nama file. Pilih Komentar pada file, masukkan komentar Anda, dan kemudian pilih Simpan.

      Menambahkan komentar pada file dalam commit.
    • Untuk menambahkan komentar ke baris yang berubah dalam commit, pergi ke baris di mana perubahan tersebut muncul. Pilih gelembung komentar The comment bubble icon that that indicates that you can leave a comment on that line of code. , masukkan komentar Anda, dan kemudian pilih Simpan.

      Menambahkan komentar pada baris dalam commit.
    catatan

    Anda dapat mengedit komentar Anda setelah menyimpannya. Anda juga dapat menghapus isinya. Komentar akan tetap dengan pesan yang mengatakan bahwa isi telah dihapus. Pertimbangkan untuk menggunakan Pratinjau markdown untuk komentar Anda sebelum Anda menyimpannya.

  5. Untuk membalas komentar pada commit, pilih Balas. Untuk membalas komentar dengan emoji, pilih emoji yang diinginkan dari daftar. Anda hanya dapat memilih satu emoji per komentar. Jika Anda ingin mengubah reaksi emoji, pilih yang berbeda dari daftar, atau pilih Tidak ada untuk menghilangkan reaksi Anda.

    Menambahkan balasan dan reaksi emoji pada komentar.

Tambahkan dan balas ke komentar ketika membandingkan dua penentu commit

Anda dapat menambahkan komentar untuk perbandingan antara cabang, tag, atau commit.

Untuk menambah atau membalas komentar ketika membandingkan penentu commit
  1. Buka CodeCommit konsol di https://console.aws.amazon.com/codesuite/codecommit/home.

  2. Di Repositori, pilih repositori tempat Anda ingin membandingkan komit, cabang, atau commit yang ditandai.

  3. Di panel navigasi, pilih Commit, dan kemudian pilih tab Bandingkan commit.

    Bandingkan dua penentu commit
  4. Gunakan Tujuan dan Sumber untuk membandingkan dua penentu commit. Gunakan daftar drop-down atau tempel di komitIDs. Pilih Bandingkan.

    Hasil contoh ketika membandingkan ID commit ke cabang
  5. Lakukan salah satu atau beberapa hal berikut:

    • Untuk menambahkan komentar ke file atau baris, pilih gelembung komentar The comment bubble icon that that indicates that you can leave a comment on that line of code. .

    • Untuk menambahkan komentar umum pada perubahan yang dibandingkan, buka Komentar tentang perubahan.

Tampilkan, tambah, perbarui, dan balas komentar (AWS CLI)

Anda dapat menampilkan, menambah, membalas, memperbarui, dan menghapus isi komentar dengan menjalankan perintah berikut:

Untuk menampilkan komentar pada commit

  1. Jalankan perintah get-comments-for-compared-commit, dengan menentukan:

    • Nama CodeCommit repositori (dengan --repository-name opsi).

    • ID commit penuh dari komit setelahnya, untuk menetapkan keterarahan dari perbandingan tersebut (dengan --after-commit-id option).

    • ID commit penuh dari komit sebelumnya, untuk menetapkan keterarahan dari perbandingan tersebut (dengan opsi --before-commit-id).

    • (Opsional) Sebuah enumerasi token untuk mengembalikan batch berikutnya dari hasil (dengan opsi --next-token).

    • (Opsional) Sebuah bilangan bulat non-negatif untuk membatasi jumlah hasil yang dikembalikan (dengan opsi --max-results).

    Misalnya, untuk melihat komentar yang dibuat pada perbandingan antara dua komit dalam repositori bernama MyDemoRepo:

    aws codecommit get-comments-for-compared-commit --repository-name MyDemoRepo --before-commit-id 6e147360EXAMPLE --after-commit-id 317f8570EXAMPLE
  2. Jika berhasil, perintah ini menghasilkan output yang serupa dengan yang berikut:

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

Untuk menampilkan detail komentar pada commit

  1. Jalankan perintah get-comment, dengan menentukan ID komentar yang dihasilkan sistem. Sebagai contoh:

    aws codecommit get-comment --comment-id ff30b348EXAMPLEb9aa670f
  2. Jika berhasil, perintah ini mengembalikan output yang serupa dengan yang berikut:

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

Untuk menghapus isi komentar pada commit

  1. Jalankan perintah delete-comment-content, dengan menentukan ID komentar yang dihasilkan sistem. Sebagai contoh:

    aws codecommit delete-comment-content --comment-id ff30b348EXAMPLEb9aa670f
    catatan

    Anda hanya dapat menghapus konten komentar jika AWSCodeCommitFullAccess kebijakan diterapkan, atau jika Anda memiliki DeleteCommentContent izin yang disetel ke Izinkan.

  2. Jika berhasil, perintah ini menghasilkan output yang serupa dengan yang berikut:

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

Untuk membuat komentar pada commit

  1. Jalankan perintah post-comment-for-compared-commit, dengan menentukan:

    • Nama CodeCommit repositori (dengan --repository-name opsi).

    • ID commit penuh dari komit setelahnya, untuk menetapkan keterarahan dari perbandingan tersebut (dengan opsi --after-commit-id ).

    • ID commit penuh dari komit sebelumnya, untuk menetapkan keterarahan dari perbandingan tersebut (dengan opsi --before-commit-id).

    • Sebuah token idempotensi yang unik dan dihasilkan klien (dengan opsi --client-request-token).

    • Isi dari komentar Anda (dengan opsi --content).

    • Daftar informasi lokasi tentang tempat untuk menempatkan komentar, termasuk:

      • Nama file yang dibandingkan, termasuk ekstensi dan subdirektori-nya, jika ada (dengan atribut filePath).

      • Nomor baris perubahan dalam file dibandingkan (dengan atribut filePosition).

      • Apakah komentar pada perubahan adalah sebelum atau sesudah dalam perbandingan antara sumber dan cabang tujuan (dengan atribut relativeFileVersion).

    Misalnya, untuk menambahkan komentar "Can you add a test case for this?" pada perubahan ke cl_sample.js file dalam perbandingan antara dua komit dalam repositori bernama 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. Jika berhasil, perintah ini menghasilkan output yang serupa dengan yang berikut:

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

Untuk memperbarui komentar pada commit

  1. Jalankan perintah update-comment, dengan menentukan ID komentar yang dihasilkan sistem dan konten untuk menggantikan konten yang ada.

    Misalnya, untuk menambahkan konten "Fixed as requested. I'll update the pull request." untuk komentar dengan ID 442b498bEXAMPLE5756813:

    aws codecommit update-comment --comment-id 442b498bEXAMPLE5756813 --content "Fixed as requested. I'll update the pull request."
  2. Jika berhasil, perintah ini menghasilkan output yang serupa dengan yang berikut:

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

Untuk membalas komentar pada commit

  1. Untuk mengirim balasan ke komentar dalam permintaan tarik, jalankan perintah post-comment-reply, dengan menentukan:

    • ID yang dihasilkan sistem dari komentar yang ingin Anda balas (dengan opsi --in-reply-to).

    • Sebuah token idempotensi yang unik dan dihasilkan klien (dengan opsi --client-request-token).

    • Isi dari komentar Anda (dengan opsi --content).

    Misalnya, untuk menambahkan balasan "Good catch. I'll remove them." ke komentar dengan ID yang dihasilkan sistem dari abcd1234EXAMPLEb5678efgh:

    aws codecommit post-comment-reply --in-reply-to abcd1234EXAMPLEb5678efgh --content "Good catch. I'll remove them." --client-request-token 123Example
  2. Jika berhasil, perintah ini menghasilkan output yang serupa dengan yang berikut:

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

Untuk membalas komentar pada commit dengan emoji

  1. Untuk membalas komentar dalam permintaan tarik dengan emoji, atau untuk mengubah nilai reaksi emoji Anda, jalankan perintah put-comment-reaction, dengan menentukan:

    • ID yang dihasilkan sistem dari komentar yang ingin Anda balas dengan emoji.

    • Nilai dari reaksi yang ingin Anda tambahkan atau perbarui. Nilai yang dapat diterima termasuk emoji, shortcode, dan nilai-nilai Unicode yang didukung.

    Nilai berikut didukung untuk emoji di: CodeCommit

    Emoji Shortcode Unicode

    πŸ‘

    :jempol ke atas:

    U+1F44D

    πŸ‘Ž

    :jempol ke bawah:

    U+1F44E

    πŸ˜„

    :senyum:

    U+1F604

    ❀

    :hati:

    U+2764

    😠

    :marah:

    U+1F620

    πŸ˜•

    :bingung:

    U+1F615

    😱

    :menjerit:

    U+1F631

    😭

    :terisak:

    U+1F62D

    πŸ‘

    :tepuk tangan:

    U+1F44F

    🎊

    :confetti_ball:

    U+1F38A

    🚒

    :kapal:

    U+1F6A2

    πŸ‘€

    :mata:

    U+1F440

    tidak ada

    U+0000

    Misalnya, untuk menambahkan emoji :thumbsup: ke komentar dengan ID yang dihasilkan sistem dari abcd1234EXAMPLEb5678efgh:

    aws codecommit put-comment-reaction --comment-id abcd1234EXAMPLEb5678efgh --reaction-value :thumbsup:
  2. Jika berhasil, perintah ini tidak menghasilkan output.

Untuk menampilkan reaksi emoji terhada pkomentar

  1. Untuk menampilkan reaksi emoji terhadap komentar, termasuk pengguna yang bereaksi dengan emoji tersebut, jalankan perintah get-comment-reactions, dengan menentukan ID yang dihasilkan sistem komentar.

    Misalnya, untuk melihat reaksi emoji terhadap komentar dengan ID yang dihasilkan sistem dari abcd1234EXAMPLEb5678efgh:

    aws codecommit get-comment-reactions --comment-id abcd1234EXAMPLEb5678efgh
  2. Jika berhasil, perintah ini menghasilkan output yang serupa dengan yang berikut:

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