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 repositori Anda. 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.
- Lihat atau tinjau PR: Setidaknya akses Dasar. Untuk proyek publik, pengguna yang memiliki akses sebagai Pemangku Kepentingan memiliki akses penuh ke Azure Repos.
Izin
- Berkontribusi pada PR: Anggota kelompok keamanan Pembaca atau izin yang sesuai. - Buat dan selesaikan PR: Anggota kelompok keamanan Kontributor atau dengan izin yang sesuai.
- Berkontribusi pada PR: Anggota kelompok keamanan Pembaca atau dengan izin yang sesuai. - Membuat dan menyelesaikan PR: Anggota grup keamanan Kontributor atau memiliki izin yang sesuai.
Untuk membuat permintaan penarikan (pull request):
Di menu Git , pilih Kelola Cabang.
Klik kanan cabang dan pilih Buat Permintaan Pull.
Edit cabang sumber dan target sesuai kebutuhan, masukkan judul dan deskripsi opsional, dan pilih Buat.
Visual Studio 2019 versi 16.8 dan versi yang lebih baru memberikan pengalaman kontrol versi Git sambil mempertahankan antarmuka pengguna Team Explorer Git. Untuk menggunakan Team Explorer, hapus centang Alat>Opsi>Fitur Pratinjau>pengalaman pengguna Git baru di bilah menu. Anda dapat menjalankan fitur Git dari salah satu antarmuka secara bergantian.
Untuk membuat PR dari Visual Studio Team Explorer:
Atur agar permintaan penarikan diselesaikan secara otomatis dan digabungkan ke cabang target setelah semua kebijakan terpenuhi. Nilai yang diterima: false, true.
--bypass-policy
Lewati kebijakan yang diperlukan dan selesaikan pull request setelah bisa digabungkan. Nilai yang diterima: false, true.
--bypass-policy-reason
Alasan untuk mengabaikan kebijakan yang diperlukan.
--delete-source-branch
Hapus cabang sumber setelah permintaan pull selesai dan digabungkan ke cabang target. Nilai yang diterima: false, true.
--description -d
Deskripsi untuk permintaan pull baru, yang dapat menyertakan Markdown. Setiap nilai adalah baris baru. Misalnya: --description "First Line" "Second Line".
--detect
Mendeteksi organisasi secara otomatis. Nilai yang diterima: false, true.
--draft
Buat permintaan pull dalam mode draf saat pekerjaan sedang berlangsung. Nilai yang diterima: false, true.
--merge-commit-message
Pesan yang muncul saat Anda menggabungkan commit.
--open
Buka permintaan pull di browser web Anda.
--org --organization
URL organisasi Azure DevOps. Anda dapat mengonfigurasi organisasi default menggunakan az devops configure -d organization=ORG_URL. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui git config. Contoh: https://dev.azure.com/MyOrganizationName/.
--project -p
Nama atau ID proyek. Anda dapat mengonfigurasi proyek default menggunakan az devops configure -d project=NAME_OR_ID. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui 'git config'.
--repository -r
Nama atau ID repositori untuk membuat permintaan pull request. Parameter yang diperlukan.
--reviewers
Pengguna atau grup lain untuk disertakan sebagai peninjau pada permintaan pull baru. Dipisahkan dengan spasi.
--source-branch -s
Nama cabang sumber. Contoh: "dev".
--squash
Squash commit di cabang sumber saat menggabungkan ke cabang target. Nilai yang diterima: false, true.
--subscription
Nama atau ID langganan Azure. Anda dapat mengonfigurasi langganan default dengan menggunakan az account set -s NAME_OR_ID.
--target-branch -t
Nama cabang yang dituju. Jika tidak ditentukan, secara otomatis menggunakan cabang utama dari repositori target.
--title
Judul untuk permintaan penarikan baru.
--transition-work-items
Transisi semua item kerja yang ditautkan ke PR ke status logis berikutnya ketika status PR berubah. Misalnya ubah, Item kerja aktif menjadi Diselesaikan. Nilai yang diterima: false, true.
--work-items
ID dari item kerja untuk ditautkan ke pull request baru. Dipisahkan dengan spasi.
Contoh
Perintah berikut membuat PR dari cabang new ke cabang main default repositori Fabrikam, membuka PR di browser, dan menunjukkan output perintah dalam tabel. Contohnya menggunakan konfigurasi default: az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".
az repos pr create --repository Fabrikam --source-branch new --open --output table
ID Created Creator Title Status IsDraft Repository
---- ---------- ------------------- ---------------------------- -------- --------- ------------
30 2021-10-31 jamalh@fabrikam.com Updated note-new-git-tool.md Active False Fabrikam
Anda dapat menambahkan banyak detail PR lainnya di atau setelah pembuatan PR. Untuk menambahkan detail, peninjau, item kerja, dan opsi penyelesaian ke PR, lihatlah untuk menambahkan detail atau mengedit PR.
Perintah Azure DevOps CLI tidak didukung untuk Azure DevOps Server.
Tambahkan 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 Cherry-pick dari menu Opsi Lainnya PR. Tindakan ini membuat cabang baru dengan perubahan yang disalin. Anda kemudian dapat membuat PR baru dari cabang baru. Untuk petunjuk terperinci, lihat Salin perubahan dengan cherry pick.
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.
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 yang berada di kanan atas halaman 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 seluruh suara yang sudah ada.
Untuk menjadikan PR sebagai draf, buka PR dan pilih Tandai sebagai draf.
Untuk membuka permintaan tarik dari Visual Studio, di menu Git, pilih <layanan Git Anda>>Lihat Permintaan Tarik, dan pilih permintaan tarik untuk membukanya.
Untuk membuka permintaan pull dari Visual Studio Team Explorer, dari tampilan Permintaan Pull, klik kanan pada PR dan pilih Buka di browser.
Untuk membuat PR sebagai draf, atur parameter --draft ke true saat Anda membuat PR. (Memerlukan Azure DevOps Server 2020 atau versi yang lebih baru.)
Misalnya:
az repos pr create --repository Fabrikam --source-branch new --draft true
Untuk mengubah PR yang ada ke draft, gunakan az repos pr update --id <PR Id> --draft true.
Untuk menghapus status draf dari PR, ubah --draft menjadi false.
Perintah Azure DevOps CLI tidak didukung untuk Azure DevOps Server.
Menambahkan atau mengedit judul dan deskripsi permintaan pull
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.
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.
Saat Anda membuat PR di Visual Studio, masukkan judul dan deskripsi terperinci tentang perubahan Anda sehingga orang lain dapat melihat masalah apa yang dipecahkan oleh perubahan. Pertahankan bidang ini tetap terbarui sehingga peninjau dapat memahami perubahan dalam PR.
Untuk mengedit judul, deskripsi, atau detail lainnya di PR yang ada, buka PR di browser Anda.
Saat Anda membuat PR dengan az repos pr create, tambahkan --title dan keterangan --description yang terperinci mengenai perubahan Anda sehingga orang lain dapat melihat masalah apa yang dipecahkan oleh perubahan tersebut. Parameter --description menerima entri Markdown, dan setiap nilai dalam argumen adalah baris baru deskripsi PR.
Misalnya:
az repos pr create --repository Fabrikam --source-branch new --title "Update the readme" --description "This PR updates the readme." "These are *new* changes."
Pertahankan bidang ini tetap terbarui sehingga peninjau dapat memahami perubahan dalam PR. Untuk memperbarui detail PR, gunakan az repos pr update dengan parameter PR --id yang dibutuhkan.
Misalnya, untuk memperbarui judul dan deskripsi untuk PR #21, gunakan:
az repos pr update --id 21 --description "These updates are *no longer new*." --title "Old updates"
Perintah Azure DevOps CLI tidak didukung untuk Azure DevOps Server.
Anda dapat menambahkan peninjau di bagian Peninjau PR baru atau yang sudah ada. Anda juga dapat mengubah peninjau opsional menjadi diperlukan, 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 peninjau yang diperlukan tertentu dalam PR. Anda tidak dapat menghapus peninjau yang diperlukan oleh kebijakan cabang, tetapi Anda dapat mengubah peninjau opsional untuk mengharuskan atau menghapusnya.
Untuk melihat kebijakan cabang yang secara otomatis menambahkan peninjau, klik kanan Opsi lainnya di sebelah peninjau di bagian Peninjau di halaman Gambaran Umum PR.
Jika pengguna atau grup yang ingin Anda tinjau PR Anda bukan anggota proyek Anda, menambahkannya ke proyek sebelum Anda dapat menambahkannya sebagai peninjau.
Untuk menambahkan peninjau ke PR baru, lakukan langkah-langkah berikut:
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, lakukan langkah-langkah berikut:
Di bagian Peninjau di halaman Gambaran Umum, pilih Tambahkan, lalu pilih Peninjau yang diperlukan atau Peninjau opsional.
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 yang diperlukan dan opsional, atau untuk menghapus peninjau, pilih Opsi lainnya (⋮) di sebelah kanan nama peninjau. Untuk melihat keanggotaan grup atau tim yang ditetapkan sebagai peninjau, pilih ikon grup.
Untuk menambahkan peninjau, buka PR di browser Anda, lalu buat pembaruan Anda di halaman Gambaran Umum PR.
Anda dapat menambahkan peninjau opsional ke PR saat pembuatan dengan az repos pr create --reviewer "<Reviewer Name>" "<Another Reviewer>".
Misalnya:
az repos pr create --repository Fabrikam --source-branch new --reviewer "[Fabrikam]\Fabrikam Team" "[Fabrikam Fiber]\Web"
Untuk menambahkan peninjau yang diperlukan, atau mengubah peninjau antara opsional dan wajib, buka dan perbarui PR di browser.
Pengguna atau grup yang akan disertakan sebagai peninjau pada permintaan penarikan. Dipisahkan dengan spasi.
Diperlukan.
--detect
Mendeteksi organisasi secara otomatis. Nilai yang diterima: false, true.
--org--organization
URL organisasi Azure DevOps. Anda dapat mengonfigurasi organisasi default dengan menggunakan az devops configure -d organization=<ORG_URL>.
diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui konfigurasi git. Contoh: https://dev.azure.com/MyOrganizationName/.
--subscription
Nama atau ID langganan Azure. Anda dapat mengonfigurasi langganan default dengan menggunakan az account set -s <NAME_OR_ID>.
Perintah Azure DevOps CLI tidak didukung untuk Azure DevOps Server.
Untuk menautkan item kerja ke PR baru, lakukan langkah-langkah berikut:
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 dikategorikan sebagai Selesai dan Dihapus dikecualikan.
Item kerja ini juga difilter menurut tanggal dan pengguna, hanya memperlihatkan item yang dibuat atau diperbarui dalam 30 hari terakhir. Mereka harus dibuat oleh, diberikan kepada, atau diotorisasi sebagai pengguna saat ini.
Untuk menautkan item kerja ke PR yang sudah ada, lakukan langkah-langkah berikut:
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 tersebut. Tautan yang dibuat di cabang atau dari commit tetap ada di item kerja.
Untuk menautkan item kerja, buka PR di browser Anda, lalu buat pembaruan Anda di halaman Gambaran Umum PR.
Anda dapat menautkan item kerja Azure Boards ke PR saat pembuatan PR dengan az repos pr create --work-items <Id1> <Id2>, di mana <Id> adalah ID item kerja.
Misalnya, perintah berikut menautkan item kerja #63 dan #64 ke PR baru di cabang new:
az repos pr create --repository Fabrikam --source-branch new --work-items 63 64
Untuk menautkan item kerja ke PR yang sudah ada, gunakan az repos pr work-item add --id <PR Id> --work-items <Id1> <Id2>.
Untuk mencantumkan item kerja yang ditautkan ke PR, gunakan az repos pr work-item list --id <PR Id>.
Untuk memutuskan tautan item kerja dari PR, gunakan az repos pr work-item remove --id <PR Id> --work-items <Id1>.
Membatalkan tautan hanya menghapus tautan antara item kerja dan PR. Tautan yang dibuat di cabang atau dari komit akan tetap ada di item kerja.
ID item kerja yang akan ditautkan. Dipisahkan dengan spasi.
Diperlukan.
--detect
Mendeteksi organisasi secara otomatis. Nilai yang diterima: false, true.
--org--organization
URL organisasi Azure DevOps. Anda dapat mengonfigurasi organisasi default dengan menggunakan az devops configure -d organization=<ORG_URL>.
diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui konfigurasi git. Contoh: https://dev.azure.com/MyOrganizationName/.
--subscription
Nama atau ID langganan Azure. Anda dapat mengonfigurasi langganan default dengan menggunakan az account set -s <NAME_OR_ID>.
Perintah Azure DevOps CLI tidak didukung untuk Azure DevOps Server.
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 . Setelah Anda membuat PR, Anda dapat mengelola 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 dari PR yang 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 pilih Ubah.
Mengirim notifikasi permintaan tarik 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 Umum PR, lalu pilih Bagikan permintaan tarik.
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.
Catatan
Saat menggunakan fitur email bawaan, Anda hanya dapat mengirim email ke alamat masing-masing anggota proyek. Menambahkan grup tim atau grup keamanan ke baris Ke: tidak didukung. Jika Anda menambahkan alamat email yang tidak dikenali, Anda menerima pesan yang menunjukkan bahwa satu atau beberapa penerima tidak memiliki izin untuk membaca permintaan pull yang dikirimkan.
Menanggapi komentar dan menyelesaikan permintaan pull di Azure Repos. Pelajari tentang opsi penyelesaian, penyelesaian otomatis, dan mengabaikan atau mengembalikan permintaan pull.