Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Layanan Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022
Dalam artikel ini, pelajari cara menautkan item kerja ke komit GitHub, permintaan pull, dan branch setelah menyambungkan proyek Azure Boards Anda dengan repositori GitHub. Anda dapat menggunakan sintaks #mention untuk penerapan dan cabang atau menambahkan tautan penerapan, permintaan pull, atau cabang GitHub langsung dari item kerja Azure Boards.
Note
Dukungan integrasi GitHub:
- Layanan Azure DevOps: Terintegrasi dengan repositori GitHub.com dan GitHub Enterprise Server melalui aplikasi Azure Boards untuk GitHub.
- Azure DevOps Server 2020 dan yang lebih baru: Mendukung integrasi dengan repositori GitHub Enterprise Server saja.
- Repositori Git lainnya: Integrasi tidak didukung.
Prerequisites
| Category | Requirements |
|---|---|
| Permissions | Kontributor untuk proyek Azure Boards dan repositori GitHub. |
| Koneksi proyek | Proyek Azure Boards terhubung ke repositori GitHub tempat komit, permintaan tarik, dan cabang yang ingin Anda tautkan ke atau dari situ. Untuk informasi selengkapnya, lihat Integrasi Azure Boards-GitHub. |
Note
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.
Gunakan AB# untuk menautkan dari GitHub ke item kerja Azure Boards
Dari penerapan GitHub, permintaan pull, atau masalah, gunakan sintaks berikut untuk membuat tautan ke item kerja Azure Boards Anda. Masukkan AB#ID ke dalam teks pesan komit. Atau, untuk permintaan tarik atau masalah, masukkan AB#ID dalam deskripsi. Menggunakan AB#ID dalam judul komentar atau permintaan tarik tidak membuat tautan di item kerja.
AB#{ID}
Misalnya, AB#125 tautan ke ID item kerja 125.
Anda juga dapat memasukkan pesan komit atau permintaan tarik untuk mengalihkan item kerja. Sistem mengenali {state} atau {state category}, bersama dengan fix, fixes, fixed, dan menerapkannya ke item #-mention yang mengikuti.
Saat deskripsi permintaan pull menyertakan nama status yang valid, misalnya, Closed AB#1234, sistem memperbarui item kerja yang dirujuk ke status tertentu. Jika nama status tidak dikenali secara langsung, Azure Boards mencoba mencocokkannya dengan kategori alur kerja seperti Resolved atau Completed. Jika kecocokan ditemukan, item kerja beralih ke status pertama yang tersedia yang ditentukan di bawah kategori tersebut.
Secara default, item kerja yang direferensikan dengan fix, , fixesatau fixed transisi ke status pertama yang terkait dengan kategori Diselesaikan . Jika tidak ada status seperti itu dalam proses saat ini, sistem akan mentransisikan item kerja ke status pertama dalam kategori Selesai .
Important
Anda masih dapat menautkan item kerja dan menargetkan cabang lain, tetapi aturan transisi status tidak berlaku kecuali permintaan pull digabungkan ke cabang default.
Untuk informasi selengkapnya, lihat Bagaimana status kategori alur kerja digunakan di backlog dan papan Azure Boards.
Tinjau tabel contoh berikut:
| Menerapkan atau menarik pesan permintaan | Action |
|---|---|
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 . |
Closed AB#123 |
Menghubungkan dan memindahkan item kerja ke status alur kerja Tertutup. Jika tidak ada yang didefinisikan, tidak ada transisi yang dilakukan. |
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 Resolved atau, jika kategori tersebut tidak didefinisikan, maka ke kategori status alur kerja Completed. |
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 |
Link ke isu GitHub 123 dan work item Azure Boards 234. Tidak ada transisi yang dilakukan. |
Note
Jika Anda menyambungkan repositori GitHub yang sama ke proyek yang ditentukan dalam dua atau lebih organisasi Azure DevOps, 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.
Saat Anda menambahkan tautan ke item kerja menggunakan AB#, tautan tersebut muncul di bagian Pengembangan permintaan pull.
Membuat cabang GitHub dari item kerja
Untuk membuat cabang GitHub langsung dari item kerja, lakukan langkah-langkah berikut:
Di papan Anda, temukan tugas dari mana Anda ingin membuat cabang GitHub.
Pilih
Tindakan item kerja>Cabang GitHub baru.
Dalam dialog Buat cabang GitHub , masukkan nama cabang, dan pilih repositori GitHub dan cabang dasar.
Pilih Buat.
Azure Boards membuat cabang di repositori GitHub yang ditentukan dan menautkannya ke item kerja. Untuk informasi selengkapnya, lihat Integrasi Azure Boards-GitHub.
Menambahkan tautan item kerja ke cabang GitHub, menerapkan, atau menarik permintaan
Buka item kerja dan buka tab Tautan .
Dari dialog Tambahkan tautan , pilih salah satu jenis tautan GitHub , pilih repositori GitHub, masukkan URL ke cabang GitHub, penerapan, atau permintaan pull, lalu pilih Tambahkan tautan.
Dalam contoh berikut, kami menambahkan tautan ke permintaan pull GitHub.
Azure Boards menyelesaikan pemeriksaan untuk memastikan bahwa Anda memasukkan tautan yang valid. Repositori GitHub yang ditautkan harus terhubung ke proyek Azure Boards atau validasi gagal.
Note
Ada penundaan saat menyelesaikan tautan AB# jika Anda menggunakan Azure DevOps Server dan GitHub Enterprise Server. Kami memiliki desain 'push-and-pull' untuk mengambil dari peristiwa GitHub setiap jam pada perubahan bertahap pada Komit, PR, dan Masalah.
Pembaruan tautan otomatis
Beberapa peristiwa secara otomatis memperbarui tautan pada formulir item kerja, sehingga Anda tidak perlu membuatnya secara manual. Ini termasuk:
| Peristiwa GitHub | Action |
|---|---|
| Tautan ke cabang | Saat permintaan pull dibuat dari cabang, permintaan tersebut secara otomatis ditautkan ke item kerja. |
| Gabungkan penerapan | Setelah pull request digabungkan, commit penggabungan yang dihasilkan secara otomatis ditautkan ke item kerja. |
| Hapus cabang | Jika cabang dihapus (biasanya setelah penggabungan), tautannya secara otomatis dihapus dari item kerja. |
Menampilkan atau membuka tautan dari bagian Pengembangan
Bagian Pengembangan dalam formulir item kerja mencantumkan tautan yang dibuat ke komit GitHub dan permintaan tarik dengan ikon GitHub 
.
Pilih tautan yang disediakan untuk membuka permintaan penerapan atau pull di GitHub.
Menampilkan objek GitHub di papan
Dengan anotasi GitHub diaktifkan di papan, Anda dapat dengan cepat membuka commit GitHub tertaut, pull request, atau isu untuk mendapatkan detail lebih lanjut. Untuk informasi selengkapnya, lihat Mengkustomisasi kartu.
