Menyelesaikan, mengabaikan, atau mengembalikan permintaan pull

Layanan Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Visual Studio 2019 | Visual Studio 2022

Setelah semua peninjau yang diperlukan menyetujui permintaan pull (PR) Anda dan PR memenuhi semua persyaratan kebijakan cabang, Anda dapat menggabungkan perubahan Anda ke cabang target dan menyelesaikan PR. Atau jika Anda memutuskan untuk tidak melanjutkan perubahan dalam PR, Anda dapat meninggalkan PR.

Untuk mengatasi perubahan peninjau dan menanggapi serta menyelesaikan komentar tinjauan, lihat Menanggapi Komentar.

Prasyarat

Kategori	Persyaratan
Akses proyek	Anggota proyek .
Izin	- Lihat kode dalam proyek pribadi: Setidaknya akses Dasar . - Mengkloning atau berkontribusi pada kode dalam proyek privat: Anggota grup keamanan Kontributor atau izin-izin yang sesuai di dalam proyek. - Atur izin cabang atau repositori: Kelola izin untuk cabang atau repositori. - Ubah cabang default: Edit kebijakan dan izin untuk repositori. - Impor repositori: Anggota Administrator Proyek grup keamanan atau tingkat proyek Git Buat repositori dengan izin diatur ke Izinkan. Untuk informasi selengkapnya, lihat Mengatur izin repositori Git.
Layanan	Repos diaktifkan.
Alat	Fakultatif. Gunakan perintah az repos: Azure DevOps CLI.

Catatan

Dalam proyek publik, pengguna dengan akses Stakeholder memiliki akses penuh ke Azure Repos, termasuk melihat, menyalin, dan berkontribusi pada kode.

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

Di Azure DevOps Services, Anda dapat mengelola PR dan sumber daya lain dari antarmuka baris perintah (CLI) Azure dengan azure-devops ekstensi. Untuk mempelajari cara bekerja dengan Azure DevOps Services CLI, lihat Mulai menggunakan Azure DevOps CLI. Perintah Azure Repos CLI untuk PR menggunakan az repos pr.

Periksa perubahan penggabungan

Saat Anda menyelesaikan PR, Git menambahkan komit gabungan baru ke akhir cabang utama. Penerapan penggabungan ini menghubungkan riwayat sebelumnya dari cabang utama dan cabang sumber PR. Untuk melihat pratinjau commit penggabungan dan memeriksa konflik penggabungan, pilih menu Lainnya di kanan atas pada halaman Gambaran Umum PR, lalu pilih Lihat perubahan penggabungan.

Jika Anda mengubah cabang target setelah membuat PR, pilih Mulai ulang penggabungan untuk membuat penerapan gabungan pratinjau baru dan memperbarui tampilan diff perubahan penggabungan.

Meninjau kebijakan cabang

Teams dapat mengatur kebijakan cabang yang mengharuskan PR di cabang yang dilindungi untuk memenuhi kriteria tertentu sebelum PR dapat dimerger. Anda dapat melihat kebijakan cabang yang berlaku untuk PR Anda, apakah kebijakan tersebut diperlukan untuk penggabungan, dan apakah PR Anda berhasil atau gagal.

Browser

Tab Gambaran Umum merangkum kebijakan cabang yang lulus atau gagal untuk PR. Gambaran umum hanya mencantumkan kebijakan yang gagal, tetapi Anda dapat melihat semua pemeriksaan kebijakan dengan memilih Lihat <n> pemeriksaan.

Pada halaman Gambaran Umum PR, persyaratan kebijakan cabang memiliki ikon. Pilih Opsi lainnya di samping persyaratan lalu pilih Tampilkan kebijakan untuk masuk ke halaman Kebijakan Cabang cabang di Pengaturan Proyek.

Visual Studio

Anda dapat membuka PR di Visual Studio lalu meninjau kebijakan cabang seperti yang dijelaskan di tab Browser.

Untuk membuka Permintaan Tarik dari Visual Studio, di menu Git, pilih layanan Git Anda, <, dan pilih permintaan tarik untuk membukanya.

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 Tools>Options>Preview Features>New Git user experience dari bilah menu. Anda dapat menjalankan fitur Git dari salah satu antarmuka secara bergantian.

Untuk mengakses PR dari Visual Studio Team Explorer:

1. Sambungkan ke proyek Anda dari Visual Studio.

2. Pilih Tampilkan>Team Explorer untuk membuka Team Explorer. Anda juga dapat menekan Ctrl+\, Ctrl+M.

3. Dari Beranda, pilih Tarik Permintaan untuk melihat daftar PR yang dibuka oleh Anda atau ditetapkan untuk Anda.

4. Untuk membuka PR di portal web dan melihat kebijakan yang berlaku, klik kanan PR dan pilih Buka di browser.

Azure DevOps CLI

Untuk melihat semua kebijakan cabang yang berlaku untuk PR, gunakan az repos pr policy list dengan parameter yang diperlukan id .

az repos pr policy list --id
                        [--detect {false, true}]
                        [--org]
                        [--query-examples]
                        [--skip]
                        [--subscription]
                        [--top]

Parameter

Parameter	Deskripsi
--id	ID permintaan tarik. 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 didapatkan melalui git config. Contoh: https://dev.azure.com/MyOrganizationName/.
--query-examples	String JMESPath yang direkomendasikan. Anda dapat menyalin salah satu kueri dan menempelkannya setelah --query parameter dalam tanda kutip ganda untuk melihat hasilnya. Anda dapat menambahkan satu atau beberapa kata kunci posisional sehingga saran didasarkan pada kata kunci ini.
--skip	Jumlah kebijakan yang akan dilewati.
--subscription	Nama atau ID langganan. Anda dapat mengonfigurasi langganan default dengan menggunakan az account set -s <NAME_OR_ID>.
--top	Jumlah maksimum kebijakan yang akan dicantumkan.

Contoh

Misalnya, untuk melihat kebijakan yang berlaku pada PR #28, jalankan perintah berikut:

az repos pr policy list --id 28 --output table

Evaluation ID                         Policy                                         Blocking    Status    Expired    Build ID
------------------------------------  ---------------------------------------------  ----------  --------  ---------  ----------
84e7ca6d-0b42-4819-9f62-f41df5e319f3  Minimum number of reviewers (1)                True        Approved
1ba061d8-9e9f-401b-ab61-e2ed1c200aba  Required reviewers (1)                         True
37620a4b-adc4-483d-9ca2-3f4e6ffe2990  Comment requirements                           False       Approved
34b7cae8-812a-4c14-9229-f71a0e662e8b  Required reviewers (1) ([Fabrikam Fiber]\Web)  False
a6e4380e-9f38-4aa5-863c-0fc496027362  Work item linking                              False       Rejected

Menyelesaikan pull request

Setelah Anda menyelesaikan konflik penggabungan yang ada, dan Permintaan Penggabungan (PR) tersebut mematuhi semua kebijakan cabang serta memiliki semua persetujuan yang diperlukan, Anda dapat menyelesaikan PR tersebut.

Browser

1. Pilih Selesai di kanan atas untuk menyelesaikan PR. Atau pilih panah dropdown di samping tombol Selesai , dan pilih salah satu opsi.

   

   • Selesai: Selesaikan PR sekarang, dan gabungkan perubahan ke cabang yang dituju.
   • Atur penyelesaian otomatis: Konfigurasikan PR untuk menyelesaikan dan menggabungkan setelah semua kebijakan cabang yang diperlukan terpenuhi.
   • Tandai sebagai draf: Kembalikan PR ke status draf dan hapus semua pemungutan suara.
   • Batalkan: Tutup PR tanpa menggabungkan perubahan.

2. Di panel Selesaikan permintaan pull, di bawah Jenis penggabungan, pilih salah satu opsi penggabungan.

   

   • Gabungkan (tanpa penerusan cepat): Gabungkan dengan riwayat non-linier yang mempertahankan semua komit.
   • Penerapan squash: Gabungkan dengan riwayat linier yang menggabungkan semua penerapan sumber menjadi satu penerapan pada target, atau squash menggabungkan PR. Ketahuilah bahwa penerapan baru akan dibuat untuk cabang target tanpa menyimpan riwayat penerapan dari cabang sumber.
   • Rebase dan fast-forward: Tempatkan ulang commit sumber ke target dan lakukan fast-forward.
   • Penggabungan semi-linier: Sumber rebase diterapkan ke target dan buat gabungan dua induk.

   Catatan

   Kebijakan yang ada diberlakukan. Misalnya, jika cabang Anda saat ini memiliki kebijakan "penggabungan squash saja", Anda harus mengubah kebijakan tersebut jika Anda ingin menggunakan jenis penggabungan lain.

3. Pilih salah satu opsi pasca-penyelesaian berikut. Beberapa opsi tidak tersedia untuk beberapa jenis penggabungan.

   • Selesaikan item kerja terkait setelah penggabungan: Selesaikan item kerja tertaut apa pun.
   • Hapus <nama> cabang setelah penggabungan: Hapus cabang sumber PR setelah penggabungan.
   • Kustomisasi pesan commit gabungan: Tambahkan pesan commit gabungan kustom. Jika Anda memilih opsi ini, perbarui pesan komit gabung.
   • Ambil alih kebijakan cabang dan aktifkan penggabungan. Paksa penggabungan meskipun PR tidak memenuhi semua kebijakan cabang. Opsi ini hanya tersedia jika Anda memiliki izin Dikecualikan dari penerapan kebijakan.

4. Pilih Selesaikan penggabungan.

Saat Anda menyelesaikan penggabungan, setiap item kerja tertaut secara otomatis diperbarui untuk menunjukkan penyelesaian PR.

Visual Studio

Untuk menyelesaikan PR, buka PR di browser, dan pada halaman Gambaran Umum , pilih Selesaikan atau atur opsi lainnya.

Untuk membuka Permintaan Tarik dari Visual Studio, di menu Git, pilih layanan Git Anda, <, dan pilih permintaan tarik untuk membukanya.

Untuk mengakses PR dari Penjelajah Tim Visual Studio 2019:

1. Sambungkan ke proyek Anda dari Visual Studio.

2. Pilih Tampilkan>Team Explorer untuk membuka Team Explorer. Anda juga dapat menekan Ctrl+\, Ctrl+M.

3. Dari Beranda, pilih Tarik Permintaan untuk melihat daftar PR yang dibuka oleh Anda atau ditetapkan untuk Anda.

4. Untuk membuka PR di portal web, klik kanan PR dan pilih Buka di browser.

Azure DevOps CLI

Untuk menyelesaikan PR dan menggabungkan perubahan, gunakan az repos pr update untuk memperbarui PR --status ke completed.

Misalnya, untuk menyelesaikan PR #21, gunakan:

az repos pr update --id 21 --status completed

Mengatur opsi penyelesaian

Anda dapat mengatur opsi penyelesaian PR saat membuat PR dengan az repos pr create, atau memperbarui opsi pembuatan di PR yang ada dengan az repos pr update.

Opsi penyelesaian PR meliputi:

• bypass-policy {false, true}: Apakah akan melewati kebijakan yang diperlukan dan menyelesaikan permintaan pull setelah dapat digabungkan.
• bypass-policy-reason: Alasan untuk mengabaikan kebijakan yang diperlukan.
• delete-source-branch {false, true}: Apakah akan menghapus cabang sumber setelah permintaan pull selesai dan digabungkan.
• merge-commit-message: Sesuaikan pesan komit penggabungan.
• squash {false, true}: Apakah akan menggabungkan commit sumber ke dalam satu commit target untuk penggabungan.
• transition-work-items {false, true}: Apakah akan menyelesaikan item kerja yang tertaut saat penggabungan PR.

Untuk mengatur opsi penyelesaian dan menyelesaikan PR yang ada, gunakan az repos pr update dengan parameter yang diperlukan id .

az repos pr update --id
                   [--auto-complete {false, true}]
                   [--bypass-policy {false, true}]
                   [--bypass-policy-reason]
                   [--delete-source-branch {false, true}]
                   [--description]
                   [--detect {false, true}]
                   [--draft {false, true}]
                   [--merge-commit-message]
                   [--org]
                   [--squash {false, true}]
                   [--status {abandoned, active, completed}]
                   [--subscription]
                   [--title]
                   [--transition-work-items {false, true}]

Parameter

Parameter	Deskripsi
--id	ID permintaan tarik. Diperlukan.
--auto-complete	Atur pull request untuk diselesaikan secara otomatis ketika semua kebijakan telah disetujui dan cabang sumber dapat digabungkan ke cabang target. Nilai yang diterima: false, true.
--bypass-policy	Lewati kebijakan yang diperlukan dan selesaikan permintaan pull ketika sudah siap untuk 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 baru untuk pull request. 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	Konversikan PR ke mode draf atau terbitkan. Nilai yang diterima: false, true.
--merge-commit-message	Pesan yang ditampilkan saat komit digabungkan.
--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 didapatkan melalui git config. Contoh: https://dev.azure.com/MyOrganizationName/.
--squash	Squash komit-komit di cabang sumber saat menggabungkannya ke cabang target. Nilai yang diterima: false, true.
--status	Atur status baru untuk permintaan tarik. Nilai yang diterima: abandoned, , activecompleted.
--subscription	Nama atau ID langganan. Anda dapat mengonfigurasi langganan default dengan menggunakan az account set -s <NAME_OR_ID>.
--title	Judul baru untuk permintaan tarik.
--transition-work-items	Transisi item kerja apa pun yang ditautkan ke permintaan pull ke status logis berikutnya, misalnya Diselesaikan. Nilai yang diterima: false, true.

Contoh

Contoh berikut menyelesaikan Pull Request (PR) #21, menghapus cabang sumbernya, menyelesaikan item kerja yang ditautkan, dan menambahkan pesan penggabungan:

az repos pr update --id 21 --status completed --delete-source-branch true --transition-work-items true --merge-commit-message "This update is complete."

Rebase saat penyelesaian PR

Ada beberapa situasi saat melakukan rebasing selama penyelesaian Pull Request (PR) tidak dimungkinkan:

• Jika kebijakan pada cabang target melarang penggunaan strategi rebase, Anda memerlukan izin Ambil alih kebijakan cabang untuk melakukan rebase.
• Jika cabang sumber PR memiliki kebijakan, Anda tidak dapat melakukan rebase. Rebasing akan mengubah cabang sumber tanpa melalui proses persetujuan kebijakan.
• Jika Anda menggunakan Merge Conflict Extension untuk mengatasi konflik penggabungan, Anda tidak dapat melakukan rebase. Resolusi konflik yang diterapkan pada merge tiga arah jarang berhasil atau valid saat melakukan rebase semua komit PR satu per satu.

Dalam semua kasus ini, Anda masih dapat merebase cabang Anda secara lokal dan kemudian mendorong upstream, atau squash-merge perubahan Anda ketika Anda menyelesaikan PR.

Beberapa masalah basis penggabungan

Dalam beberapa kasus, PR memiliki lebih dari satu dasar penggabungan yang sebenarnya, dan situasi ini dapat menyebabkan masalah keamanan. Jika file dalam PR memiliki versi yang berbeda di antara basis penggabungan, peringatan beberapa basis penggabungan akan muncul. Untuk informasi selengkapnya dan pemulihan, lihat Beberapa basis penggabungan.

Mengatasi konflik terkait penggabungan

Perubahan file di cabang Anda dapat bertentangan dengan perubahan di cabang lain. Saat tidak jelas cara menggabungkan perubahan, Git menunjukkan file yang bertentangan di halaman Gambaran Umum PR. Anda harus mengatasi konflik penggabungan antara cabang PR dan cabang target sebelum Anda dapat menggabungkan PR atau mengatur PR untuk melengkapi secara otomatis. Untuk instruksi tentang mengatasi konflik penggabungan, lihat Mengatasi konflik penggabungan.

Membuat permintaan tarik untuk melengkapi otomatis

Browser

Pilih Setel lengkapi otomatis dari daftar dropdown 'Lengkap' untuk menyelesaikan dan menggabungkan perubahan PR segera setelah semua kebijakan cabang terpenuhi. Setelah PR selesai, Anda menerima pemberitahuan email. Jika konflik atau kesalahan mencegah penyelesaian PR, email akan memberi tahu Anda tentang masalah tersebut.

Catatan

Opsi Pengaturan penyelesaian otomatis tersedia di Azure Repos dan TFS 2017 dan yang lebih tinggi ketika Anda memiliki kebijakan cabang. Jika Anda tidak melihat Atur penyelesaian otomatis, Anda tidak memiliki kebijakan cabang apa pun. Untuk informasi selengkapnya, lihat Kebijakan cabang.

Pada dasarnya, PR yang diatur untuk melengkapi otomatis hanya menunggu kebijakan yang diperlukan. Di panel Aktifkan penyelesaian otomatis, Anda juga dapat memilih untuk menunggu kebijakan opsional.

Dimulai dengan TFS 2018 Update 2, halaman Gambaran Umum PR menampilkan daftar kriteria kebijakan yang belum selesai yang sedang ditunggu oleh PR. Jika Anda mengatur kebijakan yang akan diperlukan di panel Aktifkan penyelesaian otomatis, Anda dapat mengaturnya kembali ke opsional di halaman Gambaran Umum .

Pilih Batalkan pelengkapan otomatis untuk menonaktifkan pelengkapan otomatis.

PR yang diatur ke lengkapi otomatis menampilkan lencana Otomatis Lengkapi pada halaman Pull Request.

Visual Studio

Buka permintaan pull di portal web. Pada halaman Gambaran Umum , pilih Atur penyelesaian otomatis.

Untuk membuka Permintaan Tarik dari Visual Studio, di menu Git, pilih layanan Git Anda, <, dan pilih permintaan tarik untuk membukanya.

Untuk mengakses PR dari Penjelajah Tim Visual Studio 2019:

1. Sambungkan ke proyek Anda dari Visual Studio.

2. Pilih Tampilkan>Team Explorer untuk membuka Team Explorer. Anda juga dapat menekan Ctrl+\, Ctrl+M.

3. Dari Beranda, pilih Tarik Permintaan untuk melihat daftar PR yang dibuka oleh Anda atau ditetapkan untuk Anda.

4. Untuk membuka PR di portal web dan melihat kebijakan yang berlaku, klik kanan PR dan pilih Buka di browser.

Azure DevOps CLI

Atur penyelesaian otomatis untuk menyelesaikan PR secara otomatis saat memenuhi semua persetujuan dan kebijakan branch yang diperlukan. Anda dapat mengatur pelengkapan otomatis saat pembuatan PR, atau memperbarui PR yang sudah ada.

• Untuk mengatur pelengkapan otomatis pada pembuatan PR, gunakan az repos pr create --auto-complete true.
• Untuk memperbarui PR yang ada agar dapat melengkapi otomatis, gunakan az repos pr update --id <PR Id> --auto-complete true.

Mengabaikan atau mengaktifkan kembali pull request

Browser

Untuk mengabaikan perubahan dan PR Anda tanpa penggabungan, pilih Abaikan dari daftar dropdown pada tombol Selesai . Anda masih dapat melihat PR yang ditinggalkan, dan itu tetap tertaut ke item kerja.

Untuk mengaktifkan ulang PR yang ditinggalkan kapan saja, buka PR dari tab Ditinggalkan pada Tampilan PR, dan pilih Aktifkan Ulang di kanan atas.

Visual Studio

Buka permintaan pull di portal web. Pada halaman Gambaran Umum, pilih Abaikan.

Untuk membuka PR di portal web, gunakan prosedur dari Menyelesaikan pull request.

Azure DevOps CLI

Untuk membatalkan PR tanpa menggabungkan perubahan, gunakan az repos pr update --id <PR Id> –-status abandoned. Anda dapat mengaktifkan kembali PR dengan mengatur status ke active.

Mengembalikan permintaan pull yang telah selesai

Untuk membatalkan perubahan dari PR, ikuti langkah-langkah ini. Untuk informasi selengkapnya, lihat Membatalkan perubahan.

1. Buka PR yang telah selesai dan pilih Kembalikan. Tindakan ini membuat cabang baru dengan perubahan yang membatalkan PR di cabang target yang sudah ada di repositori Anda.

2. Di jendela Kembalikan permintaan tarik:

   1. Di bawah Cabang target, pilih cabang tempat Anda ingin membatalkan perubahan PR.
   2. Di bawah Nama cabang topik diperlukan, ubah nama cabang PR yang di-revert jika Anda mau.
   3. Pilih Kembalikan.

3. Di layar Permintaan pull baru, pilih Buat.

4. Gabungkan PR baru untuk menyelesaikan pembatalan.

Catatan

Cabang yang dibuat untuk pemulihan ini memiliki satu commit yang membatalkan semua perubahan file dari PR asli. Cabang tidak berisi penerapan yang dikembalikan untuk setiap penerapan dalam PR asli.

Langkah berikutnya

Terapkan perubahan dengan cherry-pick

Artikel terkait

• Pemberitahuan pembaruan pull request
• Tentang permintaan pull dan izin