Meninjau permintaan pull

Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

Saat Anda membuat permintaan pull (PR) dan menentukan peninjau yang diperlukan/opsional, Azure Repos akan memberi tahu peninjau bahwa PR Anda siap untuk ditinjau. Semua peninjau yang diperlukan harus menyetujui perubahan PR Anda sebelum perubahan dapat digabungkan ke cabang target. Untuk PR yang mengubah cabang penting seperti main cabang, tim Anda mungkin telah membuat kebijakan cabang yang menentukan peninjau atau memerlukan jumlah minimum peninjau. Jika kebijakan cabang menambahkan peninjau opsional ke PR, Anda dapat menyimpannya, mewajibkannya, atau menghapusnya. Jika kebijakan cabang menambahkan peninjau yang diperlukan ke PR, Anda tidak dapat membuatnya opsional atau menghapusnya. Untuk informasi tentang menetapkan peninjau melalui kebijakan cabang, lihat Menyertakan peninjau kode secara otomatis.

Jika Anda meninjau PR, cobalah untuk memberikan umpan balik konstruktif yang tepat dan mudah dipahami. Untuk informasi selengkapnya tentang umpan balik ulasan, lihat Umpan balik permintaan pull. Artikel ini menjelaskan cara meninjau permintaan pull di Azure DevOps.

Anda hanya dapat meninjau PR Azure DevOps di portal web dengan menggunakan browser Anda.

Di artikel ini, Anda akan mempelajari cara:

• Meninjau perubahan
• Menggunakan komentar
• Mengedit file
• Melacak file yang ditinjau
• Memilih perubahan PR
• Menyelesaikan PR

Prasyarat

• Repositori harus diaktifkan di pengaturan proyek Azure DevOps Anda. Jika hub Repos dan halaman terkait tidak ditampilkan, lihat Mengaktifkan atau menonaktifkan layanan Azure DevOps untuk mengaktifkan kembali Repositori.

• Untuk meninjau PR, Anda harus menjadi anggota proyek Azure DevOps tempat PR berada, dengan tingkat akses Dasar atau yang lebih tinggi.

  • Jika Anda tidak memiliki proyek, buat proyek atau daftar secara gratis.

  • Jika Anda bukan anggota proyek, tambahkan.

  Catatan

  Untuk proyek publik, pengguna yang diberikan akses Pemangku Kepentingan memiliki akses penuh ke Azure Repos.

• Untuk mempelajari selengkapnya tentang izin dan akses, lihat Repositori Git default dan izin cabang dan Tentang tingkat akses.

Anda dapat mengelola PR di Azure DevOps Services dengan menggunakan antarmuka baris perintah (CLI) Azure DevOps. Azure DevOps CLI tersedia saat Anda menginstal Azure CLI dan ekstensi Azure DevOps. Untuk daftar perintah CLI untuk mengelola PR, lihat az repos pr perintah.

Meninjau perubahan

Permintaan pull memungkinkan peninjau yang ditunjuk memeriksa, mendiskusikan, dan memilih perubahan yang diusulkan sebelum perubahan tersebut diterapkan ke cabang target repositori. Perlu diingat bahwa jika pengembangan dilakukan dengan file yang sama di cabang yang berbeda mungkin ada perubahan yang bertentangan. Dalam hal ini diperlukan untuk menganalisis dan menyelesaikan konflik tersebut dengan hati-hati. Untuk melakukannya, mungkin perlu mengedit file secara manual untuk menerapkan perubahan dengan benar dari sumber, target, atau kedua cabang. Mengambil semua perubahan dari sumber atau target (yang dapat dilakukan dengan satu klik tombol) mungkin tidak optimal dan dapat mengakibatkan hilangnya beberapa perubahan yang diperlukan. Ini dapat dilakukan menggunakan alat ADO, atau akan lebih nyaman untuk menggunakan alat pengembangan (seperti Visual Studio).

Untuk mempelajari selengkapnya, lihat Mengatasi konflik penggabungan.

Langkah-langkah berikut menjelaskan bagaimana peninjau PR di Azure Repos dapat menavigasi melalui PR untuk memahami perubahan yang diusulkan:

1. Dari browser web Anda, buka proyek tim untuk organisasi Azure DevOps Anda. Pilih Permintaan Repo > Pull untuk mencantumkan PR. PR yang baru dibuka default ke tab Gambaran Umum .

2. Tab Gambaran Umum PR memperlihatkan judul, deskripsi, peninjau, item, riwayat, status, dan komentar yang ditautkan. Baca deskripsi PR untuk melihat perubahan yang diusulkan. Lihat komentar untuk memahami masalah yang diangkat oleh peninjau lain.

   Catatan

   Setiap file diperkirakan untuk sejumlah modifikasi dan ditandai dengan tanda "+" atau label "ganti nama, edit" di samping namanya. Ketika file memiliki lebih dari 50 persen perubahan, file dianggap diganti namanya. Ini adalah ambang default untuk repositori git yang tidak dapat diubah.

   

3. Pilih tab File untuk meninjau semua perubahan konten di cabang sumber PR. Tampilan awal memperlihatkan tampilan ringkasan semua perubahan file. Pilih tombol Tampilan di samping file untuk melihat perubahan file tersebut saja. Jika file dimodifikasi, tombol Tampilan akan membuka tampilan berbeda. Jika file ditambahkan atau dihapus, tombol Tampilan akan membuka panel konten.

   

   Catatan

   Untuk alasan performa, tampilan ringkasan tidak akan menampilkan perubahan untuk file yang lebih besar dari 0,5 MB.

4. Dalam tampilan berbeda untuk file, Anda dapat memilih tata letak diff Berdampingan atau Sebaris .

   

   Tip

   Untuk file tunggal yang lebih besar dari 5 MB, tampilan diff menunjukkan konten file yang dipotong. Untuk tampilan berbeda dari konten lengkap, unduh dan tinjau file tersebut menggunakan alat diff lokal.

   Gunakan pohon file sebelah kiri untuk melihat file lain, atau pilih akar pohon file untuk melihat tampilan ringkasan semua perubahan file.

5. Untuk meninjau set perubahan yang diperkenalkan oleh dorongan tertentu ke cabang sumber, pilih satu atau beberapa set perubahan dari daftar dropdown perubahan. Saat Anda memilih satu atau beberapa set perubahan, tampilan diff diperbarui untuk hanya menampilkan perubahan dari set perubahan yang dipilih. Fitur ini berguna ketika perubahan telah didorong ke PR sejak tinjauan terakhir Anda dan Anda hanya ingin melihat perubahan baru. Daftar dropdown perubahan menamai setiap set perubahan dengan pesan penerapan dari penerapan akhir di setiap operasi pendorongan.

   

   Tip

   Tahan tombol Shift saat memilih beberapa set perubahan dari daftar dropdown perubahan.

6. Pilih tab Pembaruan untuk melihat semua set perubahan yang didorong untuk memastikan Anda belum melewatkan perubahan cabang sumber apa pun. Set perubahan diberi nomor dan set perubahan terbaru muncul di bagian atas daftar. Setiap set perubahan menunjukkan penerapan yang didorong dalam operasi pendorongan tersebut. Set perubahan yang didorong paksa tidak akan menimpa riwayat set perubahan dan akan muncul di daftar set perubahan yang sama dengan set perubahan lainnya.

   

7. Pilih tab Terapkan untuk melihat riwayat penerapan cabang sumber setelah dialihkan dari cabang target. Riwayat penerapan di tab Penerapan akan ditimpa jika penulis PR memaksakan riwayat penerapan yang berbeda, sehingga penerapan yang diperlihatkan di tab Penerapan mungkin berbeda dari penerapan yang ditampilkan di tab Pembaruan .

   

Meninjau file

Pilih tab File PR untuk melihat perubahan aktual yang dilakukan pada cabang sumber di samping cabang target permintaan pull.

Catatan

Perubahan yang berbeda antara Permintaan pull Azure DevOps dan perbandingan Cabang Azure DevOps disebabkan oleh metode perbandingan yang berbeda.

Ada dua metode perbandingan untuk perintah git diff: Two-dot (git diff A..B) dan three-dot (git diff A...B). Secara default, Permintaan Pull menunjukkan perbedaan tiga titik sementara Perbandingan Cabang menunjukkan perbedaan dua titik.

Contohnya:

      C---D---E branch
     /
A---B---F---G   master

Permintaan Pull: git diff branch...master hanya akan menghasilkan penerapan C, D, E. Perbandingan Cabang: git diff branch..master akan menghasilkan penerapan C, D, E, F, G.

Untuk detail selengkapnya, lihat tiga-dot-and-two-dot-git-diff-comparisons dan git diff

Catatan

Saat melihat perbedaan untuk satu file yang dipilih, ada batas ukuran file 5 MB. Untuk melihat dan membedakan file yang lebih besar dari 5 MB, Anda dapat mengunduh file dan melihatnya menggunakan alat diff lokal. Saat melihat perbedaan untuk kumpulan file, batas ukuran untuk setiap file adalah 0,5 MB, karena alasan performa.

Meninjau pembaruan

Tinjau versi kode sebelumnya dari daftar drop-down Semua pembaruan .

Setiap pembaruan ke cabang menambahkan versi baru ke daftar dan pada tab Pembaruan PR. Saat Anda memilih pembaruan yang berbeda, tampilan diff diperbarui untuk menunjukkan perbedaan antara file di setiap versi PR.

Anda dapat mengejar pembaruan PR setelah menjauh dari PR dengan menelusuri perubahan yang dilakukan sejak tinjauan terakhir Anda.

Telusuri daftar perubahan dari penulis pada tab Pembaruan .

Lihat dan pilih perubahan yang dibuat dalam penerapan ke cabang pada tab Penerapan .

Menggunakan komentar

Penulis dan peninjau PR dapat berkomunikasi satu sama lain dengan menambahkan dan menanggapi komentar PR. Saat Anda meninjau PR, gunakan komentar untuk menunjukkan masalah dengan perubahan yang diusulkan, menyarankan perubahan, dan menanggapi komentar sebelumnya. Bertujuan untuk umpan balik konstruktif yang tepat dan mudah dipahami. Alamat penerima langsung dengan menggunakan mereka @username. Referensi item kerja dengan menggunakan #workitemID dan PR lainnya dengan menggunakan !pullrequestID. Terkadang, penulis PR membuat komentar untuk diri mereka sendiri untuk tujuan dokumentasi.

Berikan umpan balik dalam komentar

Jika umpan balik Anda berlaku untuk baris atau rentang baris tertentu dalam file, tambahkan komentar di lokasi tersebut dalam file:

1. Di tab File PR, arahkan mouse ke atas baris yang ingin Anda komentari dan pilih tombol komentar untuk membuka kotak komentar sebaris. Anda juga dapat memilih beberapa baris lalu memilih tombol komentar yang muncul saat Mengarahkan mouse ke atas baris tersebut.

   

2. Masukkan komentar Anda di kotak komentar dan pilih Komentar.

   

Jika umpan balik Anda berlaku untuk seluruh file, tambahkan komentar tingkat file dengan memilih Tambahkan komentar dari menu opsi file:

Untuk memberikan umpan balik umum yang tidak terkait dengan file tertentu, tambahkan komentar di tab Gambaran Umum :

Peninjau PR juga dapat menggunakan komentar untuk menyarankan perubahan pada baris file tertentu, seperti yang dijelaskan di bagian berikutnya.

Menyarankan perubahan komentar

Anda dapat menggunakan komentar untuk menyarankan teks pengganti untuk satu atau beberapa baris dalam file:

1. Di tab File PR, arahkan mouse ke atas baris yang ingin Anda komentari dan pilih tombol komentar untuk membuka kotak komentar sebaris. Anda juga dapat memilih beberapa baris lalu memilih tombol komentar yang muncul saat Mengarahkan mouse ke atas baris tersebut. Jika diterima, konten yang Anda sarankan akan menggantikan baris atau baris tempat komentar Anda ditambahkan.

   

2. Pilih ikon bola lampu di bawah kotak komentar untuk membuat perubahan yang disarankan dalam kotak komentar dalam blok kode berpagar, lalu pilih Komentar. Anda tidak akan melihat ikon bola lampu jika Menambahkan komentar ke kode asli (sisi kiri) dari tampilan diff berdampingan.

   

Penulis PR dapat menerima saran Anda dengan:

1. Memilih Terapkan perubahan untuk tahap perubahan kesiapan untuk penerapan.

   

2. Memilih Terapkan semua perubahan untuk menerapkan semua perubahan bertahap. Penulis PR dapat membatalkan panggung saran dengan memilih Batalkan perubahan.

   

Mengedit atau menghapus komentar

Anda dapat mengedit atau menghapus komentar anda dengan mengarahkan kurban ke komentar dan memilih ikon edit atau hapus :

Seperti komentar

Penulis dan peninjau PR dapat menyukai komentar mereka sendiri atau orang lain dengan mengarahkan mouse ke atas komentar dan memilih ikon jempol:

Komentar dengan suka memperlihatkan ikon jempol yang diisi dan jumlah suka. Arahkan mouse ke atas ikon jempol untuk melihat daftar orang yang menyukai komentar.

Balas komentar

Penulis PR harus membalas komentar untuk memberi tahu peninjau bagaimana mereka mengatasi umpan balik dan saran:

1. Untuk membalas komentar, ketik respons Anda di bidang Tulis balasan . Alamat penerima langsung dengan menggunakan mereka @username. Referensi item kerja dengan menggunakan #workitemID dan PR lainnya dengan menggunakan !pullrequestID.

   

2. Setelah memasukkan respons Anda, pilih Balas & selesaikan jika respons Anda sudah final. Jika tidak, pilih Balas.

   

   Jika Anda memilih Balas & atasi, status komentar akan berubah menjadi Diselesaikan. Penulis PR juga dapat langsung mengubah status komentar, seperti yang dijelaskan di bagian berikutnya.

Mengubah status komentar

Komentar baru awalnya memiliki status Aktif , yang diperbarui penulis PR selama proses peninjauan untuk menunjukkan bagaimana mereka mengatasi umpan balik dan saran peninjau. Penulis PR dapat memilih status komentar dari daftar dropdown status:

• Aktif: status default untuk komentar baru.

• Tertunda: masalah dalam komentar ini sedang ditinjau dan menunggu sesuatu yang lain.

• Diselesaikan: masalah dalam komentar ini ditangani.

• Tidak akan memperbaiki: masalah dalam komentar ini dicatat tetapi tidak akan diperbaiki.

• Ditutup: diskusi dalam komentar ini ditutup.

Penulis dan peninjau PR dapat melacak kemajuan PR dengan memfilter status komentar, seperti yang dijelaskan di bagian berikutnya.

Memfilter komentar

Anda dapat memilih komentar atau pembaruan mana yang ditampilkan pada tab Gambaran Umum dengan memilih opsi filter dari daftar dropdown filter komentar. Misalnya, pilih opsi Filter baru untuk melihat komentar dan pembaruan baru sejak terakhir kali Anda membuka PR. Setiap opsi filter memperlihatkan jumlah item untuk kategorinya.

Mengedit file

Untuk kenyamanan, penulis PR dapat mengedit file langsung di Azure Repos. Misalnya, Anda mungkin telah menerima perubahan kode yang disarankan peninjau dan ingin membuat perubahan serupa di tempat lain.

1. Pilih Repos > File, pilih cabang sumber PR, pilih file, lalu pilih Edit.

   

2. Buat perubahan Anda di editor, lalu pilih Terapkan untuk membuka dialog Terapkan.

   

3. Dalam dialog Terapkan, edit pesan penerapan jika perlu, lalu pilih Terapkan untuk menerapkan dan mendorong perubahan ke PR Anda.

   

Melacak file yang ditinjau

Peninjau PR dapat melacak file yang ditinjau dengan memilih Tandai sebagai ditinjau dari menu opsi file, atau dengan memilih kotak centang di samping file atau folder:

Memilih perubahan PR

Browser

Peninjau PR dapat memilih PR dengan memilih opsi pemungutan suara dari daftar dropdown suara. Ikon peninjau di halaman PR akan menampilkan indikasi pemungutan suara mereka.

Opsi pemungutan suara adalah:

• Setujui: menyetujui perubahan yang diusulkan dalam PR. Opsi ini hanyalah pemungutan suara dan tidak menyetujui PR.

• Setujui dengan saran: menyetujui perubahan yang diusulkan dalam PR dengan saran opsional untuk perbaikan. Opsi ini hanyalah pemungutan suara dan tidak menyetujui PR.

• Tunggu penulis: meminta penulis untuk meninjau komentar peninjau. Penulis PR harus memberi tahu peninjau untuk meninjau ulang kode setelah penulis PR menangani komentar. Jika peninjau yang diperlukan menetapkan opsi pemungutan suara ini, pemungutan suara akan memblokir persetujuan PR.

• Tolak: menunjukkan bahwa perubahan tidak dapat diterima. Saat Anda memilih opsi ini, tambahkan komentar yang menjelaskan alasannya. Jika peninjau yang diperlukan menetapkan opsi pemungutan suara ini, pemungutan suara akan memblokir persetujuan PR.

• Reset umpan balik: menghapus suara Anda. Tidak adanya pemungutan suara tidak mencegah PR selesai.

Azure DevOps CLI

Untuk memilih apakah akan menyetujui PR, gunakan az repos pr set-vote perintah .

az repos pr set-vote --id
                     --vote {approve, approve-with-suggestions, reject, reset, wait-for-author}
                     [--detect {false, true}]
                     [--org]
                     [--subscription]

Parameter

Parameter	Diperlukan	Deskripsi
--id	Ya	ID permintaan pull
--vote	Ya	Nilai suara baru untuk permintaan pull (nilai yang diterima: approve, , approve-with-suggestions, rejectreset, atau wait-for-author)
--detect	No	Mendeteksi organisasi secara otomatis (nilai yang diterima: false, true)
--organization	Ya, jika org default tidak diatur dan file konfigurasi git tidak menentukan org	URL organisasi Azure DevOps, atau atur organisasi default menggunakan: az devops configure -d organization=<organization URL>
--subscription	No	Nama atau ID langganan Azure, atau atur langganan default menggunakan: az account set -s <name or ID>

Contoh

Perintah berikut akan memilih untuk menyetujui PR #21. Perintah mengembalikan tabel.

az repos pr set-vote --id 21 --vote approve --output table

Name            Email                ID                                    Vote      Required
--------------  ------------------- -------------------------------------  --------  ----------
Jamal Hartnett  jamalh@fabrikam.com  00000000-0000-0000-0000-000000000000  Approved  False

Perintah berikut menghapus suara Anda. Perintah mengembalikan tabel.

az repos pr set-vote --id 21 --vote reset --output table

Name            Email                ID                                    Vote      Required
--------------  ------------------- -------------------------------------  --------  ----------
Jamal Hartnett  jamalh@fabrikam.com  00000000-0000-0000-0000-000000000000            False

Menyelesaikan PR

Penulis PR dapat memilih opsi resolusi PR:

• Selesai: selesaikan PR sekarang jika semua peninjau yang diperlukan telah menyetujuinya dan semua kebijakan cabang yang diperlukan terpenuhi.

• Atur lengkapi otomatis: lengkapi PR secara otomatis saat semua peninjau yang diperlukan menyetujuinya dan semua kebijakan cabang yang diperlukan terpenuhi.

• Tandai sebagai draf: atur PR ke status draf untuk menunjukkan belum siap untuk ditinjau. Untuk draf PR, Anda dapat memilih Terbitkan untuk menghapus status drafnya dan menandainya siap untuk ditinjau.

• Abaikan: tutup PR. Untuk PR yang ditinggalkan, Anda dapat memilih Aktifkan kembali untuk memulihkannya.

Untuk informasi selengkapnya tentang menyelesaikan PR, lihat Menyelesaikan permintaan pull.

Langkah berikutnya

Menyelesaikan permintaan pull

Artikel terkait

• Pemberitahuan pembaruan permintaan pull
• Tentang permintaan pull dan izin