Menautkan penerapan GitHub, permintaan pull, dan masalah untuk item kerja di Azure Boards

  • Artikel

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

Setelah menyambungkan proyek Azure Boards dengan repositori GitHub, Anda dapat menautkan item kerja ke penerapan GitHub dan permintaan pull. Anda dapat menambahkan tautan menggunakan sintaks #mention yang akrab bagi pengguna GitHub atau Anda dapat menambahkan jenis tautan penerapan GitHub atau permintaan pull GitHub dari item kerja Azure Boards.

Catatan

Dengan aplikasi Azure Boards untuk GitHub, Azure Boards dan Azure DevOps Services mendukung integrasi dengan repositori GitHub.com dan GitHub Enterprise Server. Azure DevOps Servers 2019 dan versi yang lebih baru hanya mendukung integrasi dengan repositori GitHub Enterprise Server. Integrasi dengan repositori Git lainnya tidak didukung.

Prasyarat

  • Proyek Azure Boards Anda harus terhubung ke repositori GitHub tempat penerapan dan permintaan pull yang ingin Anda tautkan/dari ada. Untuk informasi selengkapnya, lihat Integrasi Azure Boards-GitHub.
  • Anda harus menjadi kontributor proyek Azure Boards dan ke repositori GitHub.

Catatan

Proyek yang menggunakan model proses XML yang Dihosting memerlukan pembaruan pada jenis item kerja untuk melihat bagian Pengembangan dan jenis tautan GitHub. Untuk informasi selengkapnya, lihat Memperbarui definisi XML untuk memilih jenis item kerja.

Dari penerapan GitHub, permintaan pull, atau masalah, gunakan sintaks berikut untuk membuat tautan ke item kerja Azure Boards Anda. Masukkan dalam AB#ID teks pesan penerapan. Atau, untuk permintaan atau masalah pull, masukkan dalam AB#ID judul atau deskripsi (bukan komentar).

Catatan

Menautkan ke masalah GitHub memerlukan Azure DevOps Server 2019 Update 1 atau versi yang lebih baru.

AB#{ID}

Misalnya, AB#125 tautan ke ID item kerja 125.

Anda juga dapat memasukkan pesan permintaan penerapan atau pull untuk transisi item kerja. Sistem mengenali fix, fixes, fixed dan menerapkannya ke item #-mention yang mengikuti. Item kerja yang disebutkan beralih ke Status pertama yang terkait dengan status kategori alur kerja yang diselesaikan. Jika tidak ada Status yang terkait dengan Diselesaikan, status tersebut akan beralih ke Status yang terkait dengan status Kategori alur kerja yang telah selesai. Untuk memahami bagaimana status alur kerja dan status kategori dipetakan, lihat Bagaimana status kategori alur kerja digunakan di backlog dan papan Azure Boards.

Lihat tabel contoh berikut.

Menerapkan atau menarik pesan permintaan Perbuatan
Fixed AB#123 Menautkan dan mentransisikan item kerja ke kategori status alur kerja teratasi atau, jika tidak ada yang ditentukan, maka kategori status alur kerja selesai .
Adds a new feature, fixes AB#123. Menautkan dan mentransisikan item kerja ke kategori status alur kerja teratasi atau, jika tidak ada yang ditentukan, maka kategori status alur kerja selesai .
Fixes AB#123, AB#124, and AB#126 Tautan ke item kerja Azure Boards 123, 124, dan 126. Transisi hanya item pertama, 123 ke kategori status alur kerja teratasi atau, jika tidak ada yang ditentukan, maka kategori status alur kerja selesai .
Fixes AB#123, Fixes AB#124, Fixes AB#125 Tautan ke item kerja Azure Boards 123, 124, dan 126. Transisi semua item ke kategori status alur kerja terselesaikan atau, jika tidak ada yang ditentukan, maka kategori status alur kerja selesai .
Fixing multiple bugs: issue #123 and user story AB#234 Tautan ke masalah GitHub 123 dan item kerja Azure Boards 234. Tidak ada transisi yang dilakukan.

Catatan

Jika Anda menyambungkan repositori GitHub yang sama ke proyek yang ditentukan dalam dua organisasi Azure DevOps atau lebih, Anda mungkin melihat penautan AB# yang tidak terduga. Untuk informasi selengkapnya, lihat Mengatasi masalah koneksi. Untuk alasan ini, kami sarankan Anda hanya menghubungkan repositori GitHub ke proyek yang ditentukan dalam satu organisasi Azure DevOps.

Catatan

Menautkan ke masalah GitHub memerlukan Azure DevOps Server 2019 Update 1 atau versi yang lebih baru.

  1. Untuk menautkan ke permintaan penerapan atau penarikan, buka item kerja dan pilih Tambahkan tautan di bawah bagian Pengembangan.

    Screenshot of work item form, Development section, Add link option.

    Untuk menautkan ke masalah, pilih tab Tautan , lalu pilih Tambahkan Tautkan>item yang Sudah Ada.

    Screenshot of work item form, Links tab, Add link to issue.

  2. Dari dialog Tambahkan tautan, pilih salah satu jenis tautan GitHub, masukkan URL ke penerapan, permintaan pull, atau masalah lalu pilih OK.
    Di sini, kami menambahkan tautan ke permintaan pull GitHub.

    Screenshot of work item form, Links tab, Add link dialog, GitHub pull request link type selected.

    Azure Boards menyelesaikan pemeriksaan untuk memastikan bahwa Anda telah memasukkan tautan yang valid. Repositori GitHub yang ditautkan harus terhubung ke proyek Azure Boards atau validasi gagal.

    Di sini, kami menambahkan tautan ke masalah GitHub.

    Screenshot of work item form, Links tab, Add link dialog, GitHub issue link type selected.

Catatan

Ada penundaan saat menyelesaikan tautan AB# jika Anda menggunakan Azure DevOps Sever dan GitHub Enterprise Server. Kami memiliki desain 'push-and-pull' untuk menarik dari peristiwa GitHub setiap jam pada perubahan bertahap pada Penerapan, PR, dan Masalah.

Bagian Pengembangan dalam formulir item kerja mencantumkan tautan yang dibuat ke penerapan GitHub dan permintaan pull dengan ikon GitHub.

Screenshot of work item form, Development section shows GitHub links.

Pilih tautan yang disediakan untuk membuka permintaan penerapan atau pull di GitHub.

Melihat objek GitHub di papan Kanban

Dengan anotasi GitHub diaktifkan di papan Kanban, Anda dapat dengan cepat membuka penerapan GitHub tertaut, permintaan pull, atau masalah untuk detail selengkapnya. Untuk informasi selengkapnya, lihat Mengkustomisasi kartu.

Screenshot of Kanban board that shows GitHub links on work item cards.

Catatan

Anotasi GitHub memerlukan Azure DevOps Server 2019 Update 1 atau versi yang lebih baru.

Langkah berikutnya

Mengonfigurasi lencana status