Menyelesaikan, mengabaikan, atau mengembalikan permintaan pull

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

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 dan mengatasi komentar tinjauan, lihat Komentar alamat.

Prasyarat

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

• Untuk menyelesaikan PR, Anda harus menjadi anggota grup keamanan Kontributor , atau memiliki izin yang sesuai, dalam proyek tempat PR berada.

• Untuk berkontribusi pada PR, Anda harus menjadi anggota grup keamanan Pembaca atau memiliki izin yang sesuai.

• Untuk melihat atau meninjau PR, Anda harus memiliki akses Dasar atau lebih tinggi ke proyek Azure DevOps.

• Jika Anda bukan anggota proyek yang ingin Anda kontribusikan, tambahkan.

  Catatan

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

• 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 penerapan penggabungan baru ke akhir cabang utama. Penerapan penggabungan ini menghubungkan riwayat sebelumnya dari cabang utama dan cabang sumber PR. Untuk melihat penerapan gabungan pratinjau dan memeriksa konflik penggabungan, pilih menu Opsi lainnya di kanan atas pada halaman Gambaran Umum PR, lalu pilih Tampilkan 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 bergabung. Anda dapat melihat kebijakan cabang yang berlaku untuk PR Anda, apakah kebijakan tersebut diperlukan untuk penggabungan, dan apakah PR melewati atau gagal.

Browser

Tab Gambaran Umum PR meringkas kebijakan cabang yang melewati 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 PR dari Visual Studio, di menu Git, pilih< layanan>>Git Anda Lihat Permintaan Pull, dan pilih permintaan pull 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 Opsi Alat>Pratinjau>Fitur>pengalaman pengguna Git Baru 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 pull. 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/.
--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 permintaan pull

Setelah Anda menyelesaikan konflik penggabungan apa pun, dan PR memenuhi semua kebijakan cabang dan memiliki semua persetujuan yang diperlukan, Anda dapat menyelesaikan PR.

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 target.
   • Atur lengkapi otomatis: Konfigurasikan PR untuk menyelesaikan dan menggabungkan setelah memenuhi semua kebijakan cabang yang diperlukan.
   • Tandai sebagai draf: Mengembalikan PR ke status draf dan menghapus semua suara.
   • Abaikan: Tutup PR tanpa menggabungkan perubahan.

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

   

   • Gabungkan (tidak ada penerusan cepat): Gabungkan dengan riwayat non-linier yang mempertahankan semua penerapan.
   • 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: Rebase sumber berkomitmen ke target dan maju cepat.
   • 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 penerapan penggabungan: Tambahkan pesan penerapan penggabungan kustom. Jika Anda memilih opsi ini, perbarui pesan penerapan penggabungan.
   • Ambil alih kebijakan cabang dan aktifkan penggabungan. Paksa penggabungan meskipun PR tidak memenuhi semua kebijakan cabang. Opsi ini hanya tersedia jika Anda memiliki Izin pemberlakuan kebijakan dikecualikan.

4. Pilih Selesaikan penggabungan.

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

Visual Studio

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

Untuk membuka PR dari Visual Studio, di menu Git, pilih< layanan>>Git Anda Lihat Permintaan Pull, dan pilih permintaan pull 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 melewati kebijakan yang diperlukan.
• delete-source-branch {false, true}: Apakah akan menghapus cabang sumber setelah permintaan pull selesai dan digabungkan.
• merge-commit-message: Sesuaikan pesan penerapan penggabungan.
• squash {false, true}: Apakah akan menyarangkan penerapan sumber ke dalam satu penerapan target untuk penggabungan.
• transition-work-items {false, true}: Apakah akan mengatasi item kerja tertaut saat PR bergabung.

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 pull. Diperlukan.
--auto-complete	Atur permintaan pull untuk diselesaikan secara otomatis ketika semua kebijakan telah berlalu dan cabang sumber dapat digabungkan ke cabang target. Nilai yang diterima: false, true.
--bypass-policy	Lewati kebijakan yang diperlukan dan selesaikan permintaan pull setelah dapat digabungkan. Nilai yang diterima: false, true.
--bypass-policy-reason	Alasan untuk melewati 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 permintaan pull. 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 akan ditampilkan saat penerapan 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 diambil melalui konfigurasi git. Contoh: https://dev.azure.com/MyOrganizationName/.
--squash	Squash penerapan di cabang sumber saat menggabungkan ke cabang target. Nilai yang diterima: false, true.
--status	Atur status baru permintaan pull. Nilai yang diterima: abandoned, , completedactive.
--subscription	Nama atau ID langganan. Anda dapat mengonfigurasi langganan default dengan menggunakan az account set -s <NAME_OR_ID>.
--title	Judul baru untuk permintaan pull.
--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 PR #21, menghapus cabang sumbernya, menyelesaikan item kerja yang ditautkan, dan menambahkan pesan penerapan 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 selama penyelesaian PR

Ada beberapa situasi saat rebasing selama penyelesaian 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 penggabungan tiga arah jarang berhasil atau valid saat merebas semua penerapan 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 dasar dalam penggabungan

Dalam beberapa kasus, PR memiliki lebih dari satu basis penggabungan sejati, dan situasi ini dapat menyebabkan masalah keamanan. Jika file dalam permintaan pull memiliki versi yang berbeda antar basis penggabungan, beberapa peringatan basis penggabungan akan terjadi. Untuk informasi selengkapnya dan remediasi, 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 lengkapi otomatis. Untuk instruksi tentang mengatasi konflik penggabungan, lihat Mengatasi konflik penggabungan.

Mengatur permintaan pull ke pelengkapan otomatis

Browser

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

Catatan

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

Secara default, PR yang diatur ke lengkapi otomatis hanya menunggu pada 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 luar biasa yang dinanti 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 penyelesaian otomatis untuk menonaktifkan pelengkapan otomatis.

PR yang diatur ke lengkapi otomatis menampilkan lencana Lengkapi otomatis pada halaman Permintaan pull.

Visual Studio

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

Untuk membuka PR dari Visual Studio, di menu Git, pilih< layanan>>Git Anda Lihat Permintaan Pull, dan pilih permintaan pull 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 pelengkapan otomatis untuk menyelesaikan PR secara otomatis saat melewati semua persetujuan dan kebijakan cabang yang diperlukan. Anda dapat mengatur pelengkapan otomatis pada pembuatan PR, atau memperbarui PR yang ada.

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

Mengabaikan atau mengaktifkan kembali permintaan pull

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 tetap ditautkan ke item kerja.

Untuk mengaktifkan kembali PR yang ditinggalkan kapan saja, buka PR dari tab Diabaikan di tampilan Permintaan Pull, dan pilih Aktifkan kembali 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 Selesaikan permintaan pull.

Azure DevOps CLI

Untuk meninggalkan 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 ada di repositori Anda.

2. Di panel Kembalikan permintaan pull:

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

3. Pada layar Permintaan pull baru, pilih Buat.

4. Gabungkan PR baru untuk menyelesaikan kembali.

Catatan

Cabang yang dibuat selama kembali ini memiliki satu penerapan yang mengembalikan semua perubahan file dari PR asli. Cabang tidak berisi penerapan yang dikembalikan untuk setiap penerapan dalam PR asli.

Langkah berikutnya

Salin perubahan dengan cherry-pick

Artikel terkait

• Pemberitahuan pembaruan permintaan pull
• Tentang permintaan pull dan izin