Menampilkan, memfilter, dan membuka permintaan pull
Artikel
Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Anda membuat permintaan pull (PR) untuk meninjau dan menggabungkan perubahan kode dalam repositori Git di Azure Repos. Anggota tim dan pemangku kepentingan dapat meninjau perubahan dan memberikan umpan balik sebelum menggabungkan kode ke cabang target. Peninjau juga dapat mengomentari perubahan dan memilih untuk menyetujui atau menolak kode.
Teams dapat mewajibkan PR untuk setiap perubahan pada cabang yang dilindungi, dan menetapkan kebijakan cabang yang mengharuskan PR memenuhi kriteria tertentu.
Ada beberapa cara untuk mencantumkan, memfilter, menampilkan, dan membuka PR untuk proyek.
Untuk melihat PR, Anda harus menjadi anggota proyek Azure DevOps tempat PR tersebut berada, dengan akses Dasar setidaknya . Jika Anda bukan anggota proyek, akan ditambahkan.
Nota
Untuk proyek publik, pengguna yang diberikan Stakeholder akses memiliki akses penuh ke Azure Repos.
Di Azure DevOps Services, Anda dapat mengelola PR dan sumber daya lain dari antarmuka baris perintah (CLI) Azure dengan ekstensi azure-devops. 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.
Mencantumkan pull request
Anda dapat mencantumkan PR dengan menggunakan situs web proyek Azure DevOps, Visual Studio, atau baris perintah Azure DevOps.
Untuk mencantumkan PR di repositori tertentu dalam proyek, masuk ke proyek tersebut di portal web dan pilih permintaan Repos>Pull.
Verifikasi bahwa Anda memilih repositori yang benar.
Tampilan bawaan menampilkan PR Anda di bawah tab Saya. Pilih Aktif untuk menampilkan semua PR aktif untuk repositori saat ini. Pilih Selesai atau Ditinggalkan untuk memunculkan daftar PR tertutup.
Pilih PR apa pun dalam daftar untuk masuk ke halaman Gambaran Umum PR tersebut.
Anda dapat mencantumkan semua PR anda di berbagai proyek di organisasi Anda dengan memilih permintaan Pull dalam tampilan My Work.
Untuk mencantumkan permintaan tarik dari Visual Studio, di menu Git , pilih layanan Git AndaLihat Permintaan Tarik.
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>Pengalaman pengguna Git yang baru dari bilah menu. Anda dapat menjalankan fitur Git dari salah satu antarmuka secara bergantian.
Untuk mengakses PR dari Visual Studio Team Explorer:
Pilih Tampilkan Team Exploreruntuk membuka Team Explorer. Anda juga dapat menekan Ctrl+\, Ctrl+M.
Dari Beranda, pilih Permintaan Penarikan untuk melihat daftar PR yang dibuka oleh Anda atau ditetapkan untuk Anda.
Untuk melihat daftar PR di portal web Azure DevOps, pilih tindakan lalu pilih Buka di browser.
Untuk menampilkan PR aktif di proyek Anda beserta rinciannya, gunakan az repos pr list.
az repos pr list [--creator]
[--detect {false, true}]
[--include-links]
[--org]
[--project]
[--query-examples]
[--repository]
[--reviewer]
[--skip]
[--source-branch]
[--status {abandoned, active, all, completed}]
[--subscription]
[--target-branch]
[--top]
Parameter
Parameter
Deskripsi
--creator
Batasi hasil untuk menarik permintaan yang dibuat oleh pengguna ini.
--detect
Mendeteksi organisasi secara otomatis. Nilai yang diterima: false, true.
--include-links
Sertakan _links untuk setiap permintaan penarikan.
--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 didapat melalui konfigurasi git. Contoh: https://dev.azure.com/MyOrganizationName/.
--project-p
Nama atau ID proyek. Anda dapat mengonfigurasi proyek default dengan menggunakan az devops configure -d project=<NAME_OR_ID>.
diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui git config.
--query-examples
String JMESPath yang direkomendasikan. Anda dapat menyalin salah satu kueri dan menempelkannya setelah parameter --query dalam tanda kutip ganda untuk melihat hasilnya. Anda dapat menambahkan satu atau beberapa kata kunci posisional sehingga saran didasarkan pada kata kunci ini.
--repository-r
Nama atau ID repositori.
--reviewer
Batasi hasil untuk menarik permintaan di mana pengguna ini adalah peninjau.
--skip
Jumlah permintaan pull yang akan dilewati.
--source-branch-s
Batasi hasil untuk permintaan pull yang berasal dari cabang sumber ini.
--status
Batasi hasil pencarian untuk pull request dengan status ini. Nilai yang diterima: abandoned, active, all, completed.
--subscription
Nama atau ID langganan Azure. Anda dapat mengonfigurasi langganan default dengan menggunakan az account set -s <NAME_OR_ID>.
--target-branch-t
Batasi hasil untuk menarik permintaan yang menargetkan cabang ini.
--top
Jumlah maksimum permintaan penarikan yang dapat dilist.
Contoh
Perintah berikut mencantumkan semua PR di repositori, terlepas dari statusnya, dan memperlihatkan output dalam tabel. Contohnya menggunakan konfigurasi default az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".
az repos pr list --status all --output table
ID Created Creator Title Status IsDraft Repository
---- ---------- ------------------- ---------------------------------------------- --------- --------- ------------
11 2021-10-04 jamalh@fabrikam.com Revert 'Updated parameterized-functions.md' Completed False Fabrikam
10 2021-10-04 jamalh@fabrikam.com Updated parameterized-functions.md Completed False Fabrikam
9 2021-10-04 ke@fabrikam.com New pull request Completed False Fabrikam
8 2021-10-04 jamalh@fabrikam.com Updated parameterized-functions.md Abandoned False Fabrikam
7 2021-09-30 jamalh@fabrikam.com Added note-new-git-tool.md to / Completed False Fabrikam
6 2021-09-29 jamalh@fabrikam.com Revert 'Added parameterized-functions.md to /' Abandoned False Fabrikam
5 2021-09-29 jamalh@fabrikam.com Updated README.md Completed False Fabrikam
4 2021-09-29 jamalh@fabrikam.com Added parameterized-functions.md to / Completed False Fabrikam
3 2021-09-28 jamalh@fabrikam.com WIP New file Abandoned False Fabrikam
2 2021-09-28 jamalh@fabrikam.com Update README.md Abandoned False Fabrikam
1 2021-09-28 jamalh@fabrikam.com Edit README.md Completed False Fabrikam
Perintah Azure DevOps CLI tidak didukung untuk Azure DevOps Server.
Menentukan tampilan permintaan pull kustom
Memfilter daftar PR membantu Anda menemukan dan mengatur PR untuk memprioritaskan file terpenting dalam alur kerja Anda.
Untuk memfilter daftar PR, pada halaman permintaan Pull , pilih ikon Filter di kanan atas. Lalu pilih cabang Target atau header kolom lainnya, dan pilih cabang atau nilai lain yang ingin Anda filter.
Untuk mengkustomisasi tampilan daftar PR lebih lanjut, pilih Kustomisasi tampilan di kanan atas pada halaman permintaan Pull.
Pada halaman Kustomisasi tampilan, Anda bisa menyusun ulang bagian tampilan saat ini, mengeditnya, atau menghapusnya. Untuk membuat bagian baru, pilih Tambahkan bagian.
Pada halaman Kustomisasi bagian, masukkan dan pilih nilai untuk memfilter bagian menurut parameter seperti status draf atau tanggal yang diperbarui. Anda dapat memilih apakah akan Menampilkan permintaan pull yang telah saya setujui atau tolak pada tab terpisah, atau Mengecualikan permintaan pull (duplikat) yang disertakan di bagian sebelumnya. Saat Anda selesai menyesuaikan tampilan, pilih Simpan.
Tampilan yang dikustomisasi ini membuat bagian terpisah yang dapat diciutkan di halaman permintaan pull. Kueri kustom ini juga berfungsi di seluruh repositori pada Permintaan pull saya tab beranda organisasi.
Untuk mengubah parameter tampilan yang dikustomisasi, pilih tombol Kustomisasi di samping tampilan. Atau pilih Kustomisasi tampilan, dan pada layar Kustomisasi tampilan, pilih tampilan yang ingin Anda ubah. Beberapa tampilan, seperti Ditetapkan kepada saya, tidak dapat disesuaikan, tetapi dapat diatur ulang atau dihapus.
Pada tab File di PR, Anda dapat menggunakan beberapa filter untuk memilih file dan komentar untuk peninjauan yang lebih cepat. Pilih Filter, lalu pilih di antara opsi.
Kata kunci: Masukkan kata kunci.
Ditinjau/Tidak Ditinjau: Semua (default), Tertunda, Ditinjau.
File yang dikomentari: Semua file (default), file dengan komentar.
Komentar: Tampilkan (default), Apa yang Baru, Sembunyikan.
Status komentar: Aktif (default), Tertunda, Diselesaikan, Dirancang, Tidak akan diperbaiki, Tertutup.
Dikomentari oleh: Semua komentar (default), atau orang tertentu.
Anda juga dapat mengetik string ke dalam bidang Pencarian untuk menampilkan hasil yang cocok dari opsi sebelumnya.
Untuk memfilter permintaan pull dari Visual Studio:
Di menu Git , pilih layanan Git AndaLihat Permintaan Pull.
Filter berdasarkan Penulis, Label, atau atribut lainnya.
Dari tampilan Team Explorer Permintaan Tarik:
Pilih Active, atau Ditugaskan kepada saya atau tim saya, untuk memfilter daftar PR berdasarkan status atau penugasan.
Atau, ketik tipe di sini untuk memfilter daftar bidang untuk memfilter daftar PR menurut tanggal, penulis, cabang, atau atribut lainnya.
Anda dapat menggunakan beberapa parameter az repos pr list untuk memfilter daftar PR, seperti --creator, --project, --repository, --reviewer, --source-branch, --status, --target-branch, dan --top.
Nilai --creator dan --reviewer dapat berupa nama tampilan atau alamat email. Parameter --top menentukan jumlah maksimum PR yang akan dicantumkan.
Misalnya, untuk mencantumkan detail tentang PR terakhir yang Anda buat, terlepas dari statusnya, gunakan:
az repos pr list --creator "My Name" --status all --top 1
Perintah Azure DevOps CLI tidak didukung untuk Azure DevOps Server.
Buka permintaan tarik
Saat Anda membuka PR dari browser, dari Visual Studio, atau dari Azure CLI, halaman Gambaran Umum PR terbuka di browser.
Untuk membuka PR di browser, pilih PR dari daftar di halaman Permintaan Tarik. PR terbuka ke tab Gambaran Umum. Tab Gambaran Umum menunjukkan judul PR, deskripsi, peninjau, item terkait, riwayat, dan status. Anda dapat melihat ringkasan kebijakan cabang yang lolos atau gagal, serta komentar yang telah dibuat oleh peninjau.
Pada tab Files PR , Anda dapat meninjau perubahan aktual dalam file PR. Pada tab Update dan Commit, Anda dapat melihat perubahan yang telah dibuat penulis untuk memperbarui cabang PR.
Untuk membuka permintaan pull dari Visual Studio, di menu Git, pilih <layanan Git Anda>>Lihat Permintaan Pull, lalu pilih permintaan pull untuk membukanya.
Atau, dari tampilan Team Explorer Permintaan Pull, klik kanan PR dan pilih Buka di browser untuk membuka PR di portal web.
Lihat cabang
Di Visual Studio 2019, Anda dapat memeriksa cabang sumber PR langsung dari tampilan Permintaan Penarikan. Klik kanan pada PR, lalu pilih Checkout Source Branch.
Nota
Visual Studio 2019 versi 16.8 dan versi yang lebih baru menyediakan menu Git baru untuk mengelola alur kerja Git dengan peralihan konteks yang lebih sedikit daripada Team Explorer. Prosedur yang disediakan dalam artikel ini di bawah tab Visual Studio menyediakan informasi untuk menggunakan pengalaman Git serta Team Explorer. Untuk informasi selengkapnya, lihat perbandingan berdampingan Git dan Team Explorer.
Untuk melihat rincian dari satu PR, gunakan az repos pr show dengan parameter --id yang diperlukan. Untuk membuka PR di browser Anda, gunakan --open.
az repos pr show --id
[--detect {false, true}]
[--open]
[--org]
[--query-examples]
[--subscription]
Parameter
Parameter
Deskripsi
--id
ID permintaan penarikan.
Diperlukan.
--detect
Mendeteksi organisasi secara otomatis. Nilai yang diterima: false, true.
--open
Buka permintaan pull di browser web Anda.
--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 dari pengaturan git. Contoh: https://dev.azure.com/MyOrganizationName/.
--query-examples
String JMESPath yang direkomendasikan. Anda dapat menyalin salah satu kueri dan menempelkannya setelah parameter --query dalam tanda kutip ganda untuk melihat hasilnya. Anda dapat menambahkan satu atau beberapa kata kunci posisional sehingga saran didasarkan pada kata kunci ini.
--subscription
Nama atau ID langganan Azure. Anda dapat mengonfigurasi langganan default dengan menggunakan az account set -s <NAME_OR_ID>.
Contoh
Contoh berikut menunjukkan detail untuk PR #21, memperlihatkan output perintah sebagai tabel, dan membuka PR di browser:
az repos pr show --id 21 --open --output table
ID Created Creator Title Status IsDraft Repository
---- ---------- ------------------- ---------------------------- -------- --------- ------------
21 2021-10-31 jamalh@fabrikam.com Updated note-new-git-tool.md Active False Fabrikam
Kunjungi cabang
Gunakan az repos pr checkout dengan parameter --id yang diperlukan untuk memeriksa cabang PR secara lokal, selama tidak ada perubahan lokal.
az repos pr checkout --id
[--remote-name]
[--subscription]
Parameter
Parameter
Deskripsi
--id
ID permintaan pull.
--remote-name
Nama git remote tempat PR diajukan. Nilai default: origin.
--subscription
Nama atau ID langganan Azure. Anda dapat mengonfigurasi langganan default dengan menggunakan az account set -s <NAME_OR_ID>.
Contoh
Misalnya, untuk mengecek cabang PR #21 secara lokal, gunakan:
az repos pr checkout --id 21
Perintah Azure DevOps CLI tidak didukung untuk Azure DevOps Server.
Untuk meninjau perubahan, buat komentar atau saran, atau setujui atau pilih PR, lihat Tinjau permintaan pull.
Melihat dan memperbarui permintaan pull dari perangkat seluler
Anda dapat menggunakan perangkat seluler untuk melihat semua layar Azure Repos PR dan mengambil tindakan.
