Meninjau permintaan pull - AWS CodeCommit

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

Meninjau permintaan pull

Anda dapat menggunakan AWS CodeCommit konsol untuk meninjau perubahan yang disertakan dalam permintaan tarik. Anda dapat menambahkan komentar untuk permintaan, file, dan baris kode individu. Anda juga dapat membalas komentar yang dibuat oleh pengguna lain. Jika repositori Anda adalah dikonfigurasi dengan notifikasi, Anda menerima email ketika pengguna membalas komentar Anda atau ketika pengguna mengomentari permintaan pull.

Anda dapat menggunakan AWS CLI untuk mengomentari permintaan tarik dan membalas komentar. Untuk meninjau perubahan, Anda harus menggunakan CodeCommit konsol, git diff perintah, atau alat diff.

Meninjau permintaan pull (konsol)

Anda dapat menggunakan CodeCommit konsol untuk meninjau permintaan tarik di CodeCommit repositori.

  1. Buka CodeCommit konsol di https://console.aws.amazon.com/codesuite/codecommit/home.

  2. Di Repositori, pilih nama repositori.

  3. Di panel navigasi, pilih Permintaan pull.

  4. Secara default, daftar semua permintaan pull terbuka ditampilkan. Pilih permintaan pull terbuka yang ingin Anda tinjau.

    Buka permintaan tarik yang ditampilkan di CodeCommit konsol.
    catatan

    Anda dapat mengomentari permintaan pull tertutup atau digabung, tetapi Anda tidak dapat menggabungkan atau membukanya kembali.

  5. Dalam permintaan pull, pilih Perubahan.

  6. Lakukan salah satu hal berikut ini:

    • Untuk menambahkan komentar umum untuk seluruh permintaan pull, di Komentar perubahan, di Komentar baru, masukkan komentar, dan kemudian pilih Simpan. Anda dapat menggunakan Markdown, atau Anda dapat memasukkan komentar Anda di plaintext.

      Sebuah komentar umum pada perubahan dalam permintaan pull.
    • Untuk menambahkan komentar ke file dalam commit, dalam Perubahan, cari nama file. Pilih ikon komentar The comment bubble icon that that indicates that you can leave a comment on that line of code. yang muncul di samping nama file, masukkan komentar, dan kemudian pilih Simpan.

      Menambahkan komentar pada file dalam permintaan pull.
    • Untuk menambahkan komentar ke baris yang diubah dalam permintaan pull, di Perubahan, pergi ke baris yang ingin Anda komentari. Pilih ikon komentar The comment bubble icon that that indicates that you can leave a comment on that line of code. yang muncul untuk baris tersebut, masukkan komentar, dan kemudian pilih Simpan.

      Menambahkan komentar pada baris dalam permintaan pull.
  7. Untuk membalas komentar pada komit, di Perubahan atau Aktivitas, pilih Balas. Anda dapat membalas dengan teks dan dengan emoji.

    Menambahkan balasan dan reaksi emoji pada komentar.

    Anda dapat melihat nama-nama mereka yang menanggapi dengan jawaban reaksi emoji tertentu dengan memilihnya. Untuk melihat semua reaksi emoji dan informasi tentang siapa yang menanggapi emoji, pilih Lihat semua reaksi. Jika Anda menanggapi dengan emoji pada komentar, respons Anda akan ditampilkan di ikon tombol reaksi emoji.

    catatan

    Jumlah reaksi yang ditampilkan di konsol akurat sejak halaman dimuat. Untuk informasi terkini tentang jumlah reaksi emoji, segarkan halaman, atau pilih Lihat semua reaksi.

    Melihat informasi tentang pengguna yang menanggapi komentar dengan reaksi emoji.
  8. (Opsional) Untuk membalas rekomendasi yang dibuat oleh Amazon CodeGuru Reviewer, termasuk memberikan umpan balik tentang kualitas rekomendasi, pilih Balas. Gunakan tombol reaksi untuk memberikan informasi umum tentang apakah Anda menyetujui atau tidak menyetujui rekomendasi tersebut. Gunakan kolom komentar untuk memberikan rincian lebih lanjut tentang reaksi Anda.

    catatan

    Amazon CodeGuru Reviewer adalah layanan peninjauan kode otomatis yang menggunakan analisis program dan pembelajaran mesin untuk mendeteksi masalah umum dan merekomendasikan perbaikan dalam kode Java atau Python Anda.

    • Anda hanya melihat komentar Amazon CodeGuru Reviewer jika Anda telah mengaitkan repositori dengan Amazon CodeGuru Reviewer, jika analisisnya selesai, dan jika kode dalam permintaan tarik adalah kode Java atau Python. Untuk informasi selengkapnya, lihat Kaitkan atau pisahkan AWS CodeCommit repositori dengan Amazon Reviewer CodeGuru .

    • Komentar Amazon CodeGuru Reviewer hanya muncul di tab Perubahan jika komentar dibuat pada revisi terbaru dari permintaan tarik. Mereka selalu muncul di tab Aktivitas.

    • Meskipun Anda dapat merespons dengan reaksi emoji apa pun yang tersedia terhadap rekomendasi Amazon CodeGuru Reviewer, hanya reaksi emoji jempol ke atas dan jempol ke bawah yang digunakan untuk mengevaluasi kegunaan rekomendasi tersebut.

    Rekomendasi yang dibuat oleh Amazon CodeGuru Reviewer dengan pekerjaan peninjauan sedang berlangsung.
  9. Untuk menyetujui perubahan yang dibuat dalam permintaan pull, pilih Setujui.

    catatan

    Anda tidak dapat menyetujui permintaan pull yang Anda buat.

    Anda dapat melihat persetujuan, aturan persetujuan untuk permintaan pull, dan persetujuan aturan yang dibuat oleh templat aturan persetujuan di Persetujuan. Jika Anda memutuskan Anda tidak ingin menyetujui permintaan pull setelah semua, Anda dapat memilih Cabut persetujuan.

    catatan

    Anda hanya dapat menyetujui atau mencabut persetujuan atas permintaan pull terbuka. Anda tidak dapat menyetujui atau mencabut persetujuan permintaan pull yang statusnya digabung atau ditutup.

    Persetujuan dan persetujuan aturan dalam permintaan pull.

Tinjau permintaan pull (AWS CLI)

Untuk menggunakan AWS CLI perintah dengan CodeCommit, instal file AWS CLI. Untuk informasi selengkapnya, lihat Referensi baris perintah.

Anda dapat meninjau permintaan tarik dengan AWS CLI perintah berikut:

Anda juga dapat menggunakan emoji dengan komentar dalam permintaan pull dengan perintah berikut:

Untuk menggunakan AWS CLI untuk meninjau permintaan tarik dalam CodeCommit repositori

  1. Untuk menambahkan komentar untuk permintaan pull dalam repositori, jalankan perintah post-comment-for-pull-request, menentukan:

    • ID dari permintaan pull (dengan opsi --pull-request-id).

    • Nama repositori yang berisi permintaan pull (dengan opsi --repository-name).

    • ID commit penuh dari commit di cabang tujuan dimana permintaan pull digabung (dengan opsi --before-commit-id).

    • ID commit penuh commit di cabang sumber yang ujung cabang saat ini untuk permintaan pull ketika Anda mengirim komentar (dengan opsi --after-commit-id).

    • 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, jika ada (dengan opsi filePath).

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

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

    Misalnya, gunakan perintah ini untuk menambahkan komentar "Ini tampaknya tidak digunakan di mana saja. Bisakah kita menghapusnya?" pada perubahan ke file ahs_count.py dalam permintaan tarik dengan ID 47 di repositori bernama. MyDemoRepo

    aws codecommit post-comment-for-pull-request --pull-request-id "47" --repository-name MyDemoRepo --before-commit-id 317f8570EXAMPLE --after-commit-id 5d036259EXAMPLE --client-request-token 123Example --content "These don't appear to be used anywhere. Can we remove them?" --location filePath=ahs_count.py,filePosition=367,relativeFileVersion=AFTER

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

    { "afterBlobId": "1f330709EXAMPLE", "afterCommitId": "5d036259EXAMPLE", "beforeBlobId": "80906a4cEXAMPLE", "beforeCommitId": "317f8570EXAMPLE", "comment": { "authorArn": "arn:aws:iam::111111111111:user/Saanvi_Sarkar", "clientRequestToken": "123Example", "commentId": "abcd1234EXAMPLEb5678efgh", "content": "These don't appear to be used anywhere. Can we remove them?", "creationDate": 1508369622.123, "deleted": false, "lastModifiedDate": 1508369622.123, "callerReactions": [], "reactionCounts": [] } "location": { "filePath": "ahs_count.py", "filePosition": 367, "relativeFileVersion": "AFTER" }, "repositoryName": "MyDemoRepo", "pullRequestId": "47" }
  2. Untuk melihat komentar untuk permintaan pull, jalankan perintah get-comments-for-pull-request, menentukan:

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

    • ID yang dihasilkan sistem dari permintaan pull (dengan opsi --pull-request-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, gunakan perintah ini untuk melihat komentar untuk permintaan pull dengan ID 42.

    aws codecommit get-comments-for-pull-request --pull-request-id 42

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

    { "commentsForPullRequestData": [ { "afterBlobId": "1f330709EXAMPLE", "afterCommitId": "5d036259EXAMPLE", "beforeBlobId": "80906a4cEXAMPLE", "beforeCommitId": "317f8570EXAMPLE", "comments": [ { "authorArn": "arn:aws:iam::111111111111:user/Saanvi_Sarkar", "clientRequestToken": "", "commentId": "abcd1234EXAMPLEb5678efgh", "content": "These don't appear to be used anywhere. Can we remove them?", "creationDate": 1508369622.123, "deleted": false, "lastModifiedDate": 1508369622.123, "callerReactions": [], "reactionCounts": { "THUMBSUP" : 6, "CONFUSED" : 1 } }, { "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "clientRequestToken": "", "commentId": "442b498bEXAMPLE5756813", "content": "Good catch. I'll remove them.", "creationDate": 1508369829.104, "deleted": false, "lastModifiedDate": 150836912.273, "callerReactions": ["THUMBSUP"] "reactionCounts": { "THUMBSUP" : 14 } } ], "location": { "filePath": "ahs_count.py", "filePosition": 367, "relativeFileVersion": "AFTER" }, "repositoryName": "MyDemoRepo", "pullRequestId": "42" } ], "nextToken": "exampleToken" }
  3. Untuk menyetujui atau mencabut persetujuan untuk permintaan pull, jalankan perintah update-pull-request-approval-state, menentukan:

    • ID dari permintaan pull (menggunakan --pull-request-id).

    • ID revisi dari permintaan pull (menggunakan opsi --revision-id option). Anda bisa mendapatkan ID revisi saat ini untuk permintaan tarik dengan menggunakan get-pull-requestperintah.

    • Status persetujuan yang ingin Anda terapkan pilihan (menggunakan --approval-state). Status persetujuan yang valid mencakup APPROVE dan REVOKE.

    Misalnya, gunakan perintah ini untuk menyetujui permintaan pull dengan ID 27 dan ID revisi 9f29d167EXAMPLE.

    aws codecommit update-pull-request-approval-state --pull-request-id 27 --revision-id 9f29d167EXAMPLE --approval-state "APPROVE"

    Jika berhasil, perintah ini tidak mengembalikan apa pun.

  4. Untuk mengirim balasan ke komentar dalam permintaan pull, jalankan perintah post-comment-reply, 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 balasan Anda (dengan opsi --content).

    Misalnya, gunakan perintah ini untuk menambahkan balasan "Tangkapan bagus. Aku akan menghapusnya." untuk komentar dengan ID yang dihasilkan sistem abcd1234EXAMPLEb5678efgh.

    aws codecommit post-comment-reply --in-reply-to abcd1234EXAMPLEb5678efgh --content "Good catch. I'll remove them." --client-request-token 123Example

    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, "lastModifiedDate": 150836912.221, "callerReactions": [], "reactionCounts": [] } }