Membuat pull request
Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Buat permintaan pull (PR) untuk mengubah, meninjau, dan menggabungkan kode di repositori Git . Anda dapat membuat PR dari cabang di repositori upstream atau dari cabang di fork Anda repositori. Tim Anda dapat meninjau PR dan memberikan umpan balik tentang perubahan. Peninjau dapat menelusuri perubahan yang diusulkan, meninggalkan komentar, dan memilih untuk menyetujui atau menolak PR. Bergantung pada kebijakan cabang dan persyaratan lainnya, PR Anda mungkin perlu memenuhi berbagai kriteria sebelum Anda dapat menyelesaikan PR dan menggabungkan perubahan ke cabang target.
Untuk pedoman PR dan pertimbangan manajemen, lihat Tentang permintaan pull.
Prasyarat
-
Akses:
- Akses dasar: Untuk melihat atau meninjau PR, jadilah anggota proyek Azure DevOps dengan setidaknya akses dasar.
- Akses Pemangku Kepentingan: Untuk proyek publik, pengguna yang diberikan akses Pemangku Kepentingan memiliki akses penuh ke Azure Repos.
- Izin :
- Repos diaktifkan: Repos harus diaktifkan pada proyek Anda. Jika hub Repos dan halaman terkait tidak ditampilkan, silakan lihat Mengaktifkan atau Menonaktifkan Layanan Azure DevOps untuk mengaktifkan kembali Repos.
- Keanggotaan untuk Proyek :
- Jika Anda tidak memiliki proyek, buat satu atau daftar secara gratis.
- Jika Anda bukan anggota proyek, akan ditambahkan.
- Grup keamanan Pembaca: Untuk berkontribusi pada PR, jadilah anggota grup keamanan Pembaca atau memiliki izin yang sesuai.
- Grup keamanan Kontributor: Untuk membuat dan menyelesaikan PR, menjadi anggota grup keamanan Kontributor atau memiliki izin yang sesuai.
- Alat :
-
Azure DevOps CLI: Anda dapat membuat dan mengelola PR dari antarmuka baris perintah (CLI) Azure dengan ekstensi
azure-devops
. Untuk informasi selengkapnya, lihat Mulai menggunakan Azure DevOps CLI.- Perintah Azure Repos CLI untuk PR menggunakan
az repos pr
.
- Perintah Azure Repos CLI untuk PR menggunakan
-
Azure DevOps CLI: Anda dapat membuat dan mengelola PR dari antarmuka baris perintah (CLI) Azure dengan ekstensi
-
Akses:
- Akses Dasar: Untuk melihat atau meninjau PR, jadilah anggota proyek Azure DevOps dengan setidaknya Akses Dasar. Jika Anda bukan anggota proyek, ditambahkan.
-
Izin:
- Repos diaktifkan: Repos harus diaktifkan pada proyek Anda. Jika hub Repos dan halaman terkait tidak ditampilkan, lihat Mengaktifkan atau menonaktifkan layanan Azure DevOps untuk mengaktifkan kembali Repos.
- Grup keamanan Pembaca: Untuk berkontribusi pada PR, jadilah anggota grup keamanan Pembaca atau memiliki izin yang sesuai.
- Grup keamanan Kontributor: Untuk membuat dan menyelesaikan PR, menjadi anggota grup keamanan Kontributor atau memiliki izin yang sesuai.
Untuk informasi selengkapnya tentang izin dan akses, lihat repositori Git Default dan izin cabang dan Tentang tingkat akses.
Buat pull request
Anda dapat membuat PR baru dari situs web proyek Azure DevOps, dari Visual Studio, atau dari Azure DevOps CLI.
-
Browser
- Visual Studio
- Azure DevOps CLI
Dari situs web proyek Azure DevOps, Anda dapat membuat PR baru dari:
- halaman Permintaan pull.
- Cabang fitur yang telah didorong ke repositoriAnda.
- Sebuah PR yang sudah ada, dengan menggunakan cherry-pick.
- Pengendalian atas pengembangan dalam item kerja terhubung di Azure Boards.
Buat PR dari halaman Pull request
Anda dapat membuat PR untuk cabang mana pun dari halaman Pull Requests proyek Anda di web.
Pada halaman Repos >Pull requests, pilih Permintaan pull terbaru di bagian kanan atas.
Pilih cabang dengan perubahan dan cabang yang ingin Anda gabungkan perubahannya, seperti cabang utama.
Masukkan detail PR Anda dan buat PR.
Buat PR dari cabang yang telah di-push
Setelah Anda mendorong atau memperbarui cabang fitur, Azure Repos menampilkan perintah untuk membuat PR.
Pada halaman permintaan tarik:
Pada halaman File:
Pilih Buat permintaan pull untuk masuk ke halaman tempat Anda dapat memasukkan detail PR Anda dan membuat PR.
Membuat PR dari item kerja tertaut
Anda dapat membuat PR langsung dari item kerja Azure Boards yang ditautkan ke cabang.
Di Azure Boards, dari
Backlog atau kueridalam tampilan Kerja , buka item kerja yang ditautkan ke cabang. Di area Pengembangan
item pekerjaan, pilih Buat permintaan tarik (pull request) .
Tautan ini membawa Anda ke halaman tempat Anda dapat memasukkan detail PR Anda dan membuat PR.
Menambahkan pembaruan dengan cherry-pick
Anda dapat menyalin commit dari satu cabang ke cabang lain dengan menggunakan cherry-pick. Tidak seperti penggabungan atau rebase, cherry-pick hanya membawa perubahan dari commit yang Anda pilih, alih-alih semua perubahan dalam satu cabang.
Untuk memilih perubahan dari PR yang telah selesai, pilih Cherry-pick di halaman Gambaran Umum PR. Untuk menyalin perubahan dari PR aktif, pilih
Tukar cabang sumber dan target dari permintaan penarikan Anda
Sebelum pertama kali Anda menyimpan PR, Anda dapat beralih cabang sumber dan target dari PR dengan memilih ikon Beralih cabang sumber dan target di samping nama cabang. Setelah PR aktif, ikon ini akan hilang, namun Anda masih dapat mengubah cabang tujuan dari PR tersebut.
Menggunakan templat permintaan penarikan
Templat permintaan pull adalah file yang berisi teks Markdown yang mengisi deskripsi PR saat Anda membuat PR. Deskripsi PR yang baik memberi tahu peninjau PR apa yang diharapkan, dan dapat membantu melacak tugas seperti menambahkan pengujian unit dan memperbarui dokumentasi. Tim Anda dapat membuat templat PR default yang menambahkan teks ke semua deskripsi PR baru di repositori. Selain itu, Anda dapat memilih dari templat khusus cabang atau templat lain yang ditentukan tim Anda. Untuk informasi selengkapnya tentang membuat dan menggunakan templat PR, lihat Meningkatkan deskripsi permintaan pull menggunakan templat.
Jika repositori Anda memiliki templat default, semua PR di repositori memiliki teks deskripsi templat default saat dibuat. Untuk menambahkan templat lain, pilih Tambahkan templat lalu pilih templat dari daftar dropdown. Anda dapat mengedit teks templat dalam deskripsi Anda, menghapusnya, atau menambahkan teks lain.
Membuat draf PR
Jika PR Anda belum siap untuk ditinjau, Anda dapat membuat draf PR untuk menunjukkan pekerjaan yang sedang berlangsung. Ketika PR siap untuk ditinjau, Anda dapat menerbitkannya, dan memulai atau melanjutkan proses peninjauan penuh.
Draft PR memiliki perbedaan berikut dibandingkan dengan PR yang diterbitkan:
Kebijakan validasi build tidak berjalan secara otomatis. Anda dapat mengantrekan validasi build secara manual dengan memilih menu opsi lainnya di PR.
Pemungutan suara dinonaktifkan saat dalam mode draf.
Peninjau yang diperlukan tidak ditambahkan secara otomatis. Pemberitahuan hanya akan dikirim kepada peninjau yang secara khusus Anda tambahkan ke draf PR.
Draf PR ditampilkan dalam daftar PR dengan lencana Draf.
Nota
Membuat draf PR memerlukan pembaruan Azure DevOps Server 2019.1 atau versi yang lebih baru.
Untuk membuat draf PR, pilih panah di samping Buat dan pilih Buat sebagai draf saat membuat PR. Anda tidak perlu menggunakan awalan judul seperti WIP atau DO NOT MERGE.
Saat Anda siap untuk meninjau dan menyelesaikan PR, pilih Terbitkan di kanan atas di PR. Menerbitkan PR menugaskan peninjau yang diperlukan, mengevaluasi kebijakan, dan memulai pemungutan suara.
Untuk mengubah PR yang sudah diterbitkan menjadi draf, pilih Tandai sebagai draf. Menandai PR sebagai draf akan menghapus semua suara yang ada.
Menambahkan atau mengedit judul dan deskripsi permintaan pull
- Browser
- Visual Studio
- Azure DevOps CLI
Pada halaman permintaan pull baru , masukkan Judul dan Deskripsi terperinci dari perubahan Anda, agar orang lain dapat mengetahui masalah apa yang diatasi oleh perubahan tersebut. Pada PR baru seperti juga PR yang sudah ada, Anda dapat melihat File dan Commit di PR Anda pada tab terpisah. Anda dapat menambahkan peninjau, menautkan item kerja, dan menambahkan tag ke PR.
Setelah Anda siap untuk meminta perubahan Anda ditinjau, pilih Buat untuk membuat PR.
baru
Jangan khawatir jika Anda tidak memiliki semua item kerja, peninjau, atau detail yang siap saat Anda membuat PR. Anda dapat menambahkan atau memperbarui item ini setelah membuat PR.
Edit judul dan deskripsi PR
Selalu perbarui judul dan deskripsi PR sehingga peninjau dapat memahami perubahan dalam PR.
Anda dapat memperbarui judul PR yang ada dengan memilih judul saat ini dan memperbarui teks. Pilih ikon Simpan untuk menyimpan perubahan, atau pilih ikon Urungkan untuk membuang perubahan.
Edit deskripsi PR dengan memilih ikon Edit di bagian Deskripsi.
Menambahkan peninjau ke permintaan pull
- Browser
- Visual Studio
- Azure DevOps CLI
Anda dapat menambahkan peninjau di bagian Peninjau PR baru atau yang sudah ada. Anda juga dapat membuat peninjau opsional yang ada diperlukan, atau mengubah peninjau yang diperlukan menjadi opsional atau menghapusnya, kecuali jika diperlukan oleh kebijakan.
Kebijakan cabang dapat memerlukan jumlah minimum peninjau, atau secara otomatis menyertakan peninjau opsional atau yang diperlukan tertentu dalam RS. Anda tidak dapat menghapus peninjau yang diperlukan oleh kebijakan cabang. Anda dapat mengubah status peninjau opsional dalam kebijakan cabang menjadi wajib, atau menghapusnya.
Untuk melihat kebijakan cabang yang secara otomatis menambahkan peninjau, di bagian Peninjau dari halaman Gambaran Umum PR, klik kanan Opsi lainnya di samping peninjau.
Jika pengguna atau grup yang ingin Anda minta untuk meninjau PR Anda bukan anggota proyek, Anda perlu menambahkannya ke proyek sebelum dapat menambahkannya sebagai peninjau.
Untuk menambahkan peninjau ke PR baru:
- Pada halaman permintaan pull baru , di bawah Peninjau, pilih Cari pengguna dan grup untuk ditambahkan sebagai peninjau.
- Saat Anda memasukkan nama atau alamat email, daftar dropdown memperlihatkan daftar pengguna dan grup yang cocok. Pilih nama dari daftar untuk ditambahkan sebagai peninjau opsional.
- Untuk menambahkan peninjau yang diperlukan, pilih Tambahkan peninjau yang diperlukan, lalu pilih Cari untuk menambahkan peninjau yang diperlukan untuk mencari dan memilih nama.
Untuk menambahkan peninjau ke PR yang sudah ada, ikuti langkah-langkah berikut:
Di bagian Peninjau di halaman Gambaran Umum, pilih Tambahkan, lalu pilih Peninjau yang diperlukan atau Peninjau opsional.
gambaran umum permintaan Pull
Saat Anda memasukkan nama atau alamat email, daftar pengguna atau grup yang cocok akan muncul. Pilih nama yang akan ditambahkan sebagai peninjau.
Untuk mengubah peninjau antara wajib dan opsional, atau menghapus peninjau, pilih Opsi lainnya di sebelah kanan nama peninjau. Untuk melihat keanggotaan grup atau tim yang ditetapkan sebagai peninjau, pilih ikon grup.
Menautkan item kerja ke pull request
Untuk menautkan item kerja ke PR baru:
- Pada halaman Permintaan tarik baru, di bawah Item kerja untuk menautkan, pilih Cari item kerja berdasarkan ID atau judul.
- Mulai masukkan ID atau judul item kerja, dan pilih item kerja untuk ditautkan dari daftar dropdown yang muncul. Pencarian menurut judul mengembalikan item kerja yang difilter menurut status; semua item kerja dengan status yang memiliki kategori status Selesai dan Dihapus dikecualikan. Item kerja ini juga difilter menurut tanggal dan pengguna, dengan hanya item yang dibuat atau diperbarui dalam 30 hari terakhir yang ditampilkan, dan item tersebut harus dibuat oleh, ditetapkan ke, atau diotorisasi sebagai pengguna saat ini.
Untuk menautkan item kerja ke PR yang sudah ada:
Pada tab Gambaran Umum PR, di area item kerja , pilih +.
Masukkan ID item kerja atau cari judul item kerja. Pilih item kerja dari daftar yang muncul.
Hapus tautan item kerja dengan memilih ikon x di samping item kerja. Menghapus tautan hanya menghapus tautan antara item kerja dan PR. Tautan yang dibuat di cabang atau dari commit tetap ada di item kerja.
Untuk menautkan item kerja ke PR Anda:
Pilih tab Gambaran Umum di PR.
Pilih tombol tambah di area Item Kerja.
Masukkan ID item kerja atau cari item kerja dengan judul yang cocok dengan teks Anda. Pilih item kerja dari daftar yang muncul. Pencarian menurut judul mengembalikan item kerja yang difilter menurut status; semua item kerja dengan status yang memiliki kategori status Selesai dan Dihapus dikecualikan. Item kerja ini juga difilter menurut tanggal dan pengguna, dengan hanya item yang dibuat atau diperbarui dalam 30 hari terakhir yang ditampilkan, dan item tersebut harus dibuat oleh, ditetapkan ke, atau diotorisasi sebagai pengguna saat ini.
Hapus tautan item kerja dengan memilih tombol hapus yang muncul saat Anda mengarahkan mouse ke atas item kerja.
Menghapus tautan hanya menghapus tautan antara item kerja ke PR. Tautan yang dibuat di cabang atau dari komit akan tetap ada di item kerja.
Menambahkan tag ke permintaan penarikan
Gunakan tag untuk menampilkan detail penting dan membantu mengatur PR. Tag dapat mengomunikasikan informasi tambahan kepada reviewer, seperti bahwa PR masih sedang dalam proses, atau merupakan hotfix untuk rilis mendatang.
Untuk menambahkan tag saat membuat PR, ketik nama tag di bagian Tag
Menambahkan lampiran ke permintaan penarikan
Anda dapat melampirkan file, termasuk gambar, ke PR Anda selama atau setelah pembuatan. Pilih ikon klip kertas di bawah bidang Deskripsi, atau seret dan letakkan file langsung ke bidang Deskripsi dari PR.
Mengubah cabang tujuan permintaan penarikan aktif
Untuk sebagian besar tim, hampir semua PR menargetkan cabang default, seperti main
atau develop
. Jika Anda terkadang perlu menargetkan cabang yang berbeda, mudah untuk lupa mengubah cabang target saat Anda membuat PR. Jika itu terjadi, Anda dapat mengubah cabang target PR aktif:
- Pilih Tindakan lainnya di kanan atas di halaman PR Gambaran Umum, lalu pilih Ubah cabang target dari menu dropdown.
- Di panel ubah cabang target
, pilih Pilih cabang target , pilih cabang baru, lalu pilihUbah .
Pemberitahuan permintaan penarikan email kepada pemangku kepentingan
Anda dapat membagikan permintaan pull melalui email untuk memberi tahu peninjau dan berkomunikasi dengan anggota tim. Untuk berbagi PR:
Pilih
Opsi lainnya pada halaman Gambaran UmumPR, lalu pilih Bagikan permintaan pull .Pada layar Bagikan permintaan pull, tambahkan penerima dengan mengetikkan nama mereka di bidang Kepada: dan pilih dari nama pengguna yang muncul. Anda juga dapat menghapus penerima.
Tambahkan pesan opsional di bidang Catatan
(Opsional), lalu pilih Kirim . Penerima menerima email yang meminta perhatian mereka dan menautkan ke PR.
Nota
Jika Anda menggunakan fitur email bawaan, Anda hanya dapat mengirim email ke alamat individual anggota proyek. Menambahkan grup tim atau grup keamanan ke baris Ke: tidak didukung. Jika Anda menambahkan akun email yang tidak dikenali sistem, Anda menerima pesan bahwa satu atau beberapa penerima email Anda tidak memiliki izin untuk membaca permintaan penarikan email.
Agar fitur email berfungsi, administrator Anda untuk Azure DevOps Server harus mengonfigurasi server SMTP.