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.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Dalam artikel ini, pelajari cara menautkan item kerja ke penerapan GitHub, permintaan pull, cabang, dan build setelah menyambungkan proyek Azure Boards Anda dengan repositori GitHub. Anda dapat menggunakan sintaks #mention untuk commit dan cabang, menggunakan ! sebutan untuk mereferensikan permintaan tarik GitHub dari diskusi item kerja, atau menambahkan tautan commit, permintaan tarik, atau cabang GitHub langsung dari item kerja di Azure Boards.
Note
GitHub dukungan integrasi:
- Azure DevOps Services: Terintegrasi dengan repositori GitHub.com dan GitHub Enterprise Server melalui aplikasi Azure Boards untuk GitHub.
- Azure DevOps Server 2020 dan yang lebih baru: Hanya mendukung integrasi dengan repositori GitHub Enterprise Server.
- Repositori Git lainnya: Integrasi tidak didukung.
Prerequisites
| Category | Requirements |
|---|---|
| Permissions | Contributor ke 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 ada. Untuk informasi selengkapnya, lihat integrasi Azure Boards-GitHub. |
Note
Untuk melihat bagian Pengembangan dan jenis tautan GitHub, proyek yang menggunakan model proses XML yang Dihosting memerlukan pembaruan pada tipe item kerja. Untuk informasi selengkapnya, lihat Memperbarui definisi XML untuk memilih jenis item kerja.
Gunakan AB# untuk menautkan dari GitHub ke item kerja Azure Boards
Dari komit GitHub, pull request, atau isu, gunakan sintaks berikut ini untuk menautkan 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 penggunaan status kategori alur kerja dalam backlog dan papan di 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 pekerjaan 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 Azure Boards item-item kerja 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 isu GitHub 123 dan item kerja Azure Boards 234. Tidak ada transisi yang dilakukan. |
Note
Jika Anda menghubungkan repositori GitHub yang sama ke proyek yang didefinisikan dalam dua atau lebih organisasi Azure DevOps, Anda mungkin melihat penautan penyebutan AB# yang tidak terduga. Untuk informasi selengkapnya, lihat Mengatasi masalah koneksi. Untuk alasan ini, kami sarankan Anda hanya menyambungkan repositori GitHub ke proyek yang ditentukan dalam satu organisasi Azure DevOps.
Saat Anda menambahkan tautan ke item kerja menggunakan AB# dalam deskripsi permintaan pull, tautan tersebut muncul di bagian Development dari permintaan pull GitHub. Tautan ini hanya tersedia saat Anda menggunakan AB# dalam deskripsi permintaan pull. Mereka tidak muncul jika Anda menghubungkan ke permintaan penarikan langsung dari item kerja. Menghapus AB# referensi dari deskripsi juga menghapusnya dari bagian Pengembangan.
Membuat cabang GitHub dari item kerja
Untuk membuat cabang GitHub langsung dari item kerja, gunakan langkah-langkah berikut:
Dari papan Anda, temukan item kerja yang ingin Anda gunakan untuk membuat cabang GitHub.
Pilih
Tindakan item kerja>Cabang GitHub baru.
Dalam dialog Buat cabang GitHub, masukkan nama cabang. 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, penerapan, atau permintaan pull GitHub
Buka item kerja Anda dan buka area Pengembangan .
Pilih Tambahkan tautan. Dari setiap menu dropdown, pilih jenis link, repositori GitHub, dan permintaan tarik GitHub. Anda dapat mencari dan melakukan pencarian mendalam dalam repositori untuk menemukan dan memilih permintaan tarik atau commit tertentu, tanpa perlu menyalin dan menempelkan URL.
Pilih Tambahkan tautan.
Azure Boards memeriksa untuk memastikan bahwa Anda memasukkan tautan yang valid. Repositori GitHub tertaut harus terhubung ke proyek Azure Boards atau validasi gagal.
Note
Jika Anda menggunakan Azure DevOps Server dan GitHub Enterprise Server, penundaan ada saat menyelesaikan tautan AB#. Proses ini menggunakan desain 'push-and-pull' untuk mengambil data dari events GitHub setiap jam pada perubahan bertahap pada Commit, PR, dan Issue.
Pembaruan tautan otomatis
Beberapa peristiwa secara otomatis memperbarui tautan pada formulir item kerja, sehingga Anda tidak perlu membuatnya secara manual. Peristiwa ini meliputi:
| Acara GitHub | Action |
|---|---|
| Tautan ke cabang | Saat permintaan pull dibuat dari cabang, permintaan tersebut secara otomatis ditautkan ke item kerja. |
| Gabungkan penerapan | Setelah permintaan tarik digabungkan, komit penggabungan yang dihasilkan ditautkan secara otomatis 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 untuk commit dan permintaan tarik GitHub dengan menggunakan ikon 
GitHub.
Pilih tautan untuk membuka commit atau permintaan tarik di GitHub.
GitHub wawasan permintaan pull
Permintaan pull GitHub tertaut di bagian Pengembangan menunjukkan detail status tambahan, sehingga Anda dapat menilai kemajuan tanpa membuka permintaan pull di GitHub.
Prasyarat untuk wawasan pull request
Untuk melihat wawasan pull request, buka aplikasi Azure Boards di GitHub dan terima izin yang diperbarui untuk akses baca dan tulis ke Checks.
Lihat detail status permintaan pull
Buka item kerja yang memiliki permintaan pull GitHub tertaut.
Di bagian Pengembangan, temukan pull request tertaut. Detail status berikut muncul di samping tautan permintaan pull:
- Status draf: Menunjukkan apakah permintaan pull masih merupakan draf.
- Status peninjauan: Menunjukkan apakah permintaan pull perlu ditinjau, telah disetujui, atau memiliki perubahan yang diminta.
- Status pemeriksaan: Menunjukkan apakah pemeriksaan CI melewati, gagal, atau tertunda.
Arahkan mouse ke atas indikator status untuk melihat detail selengkapnya, atau pilih tautan permintaan pull untuk membukanya langsung di GitHub.
Sebutkan permintaan pull GitHub dengan menggunakan !
Gunakan penyebutan ! untuk mereferensikan dan mendiskusikan permintaan pull GitHub langsung dari bidang teks kaya item kerja atau komentar diskusi. Saat Anda mengetik ! di bidang teks, pemilih muncul yang dapat Anda gunakan untuk mencari dan memilih permintaan pull GitHub dari repositori yang terhubung. Permintaan pull yang dipilih disisipkan sebagai tautan yang dapat diklik.
Fitur ini memudahkan untuk mereferensikan permintaan pull terkait dalam deskripsi item kerja, kriteria penerimaan, atau utas diskusi tanpa menyalin URL secara manual.
Gif menunjukkan cara menggunakan tanda seru (!) untuk menyebutkan permintaan pull GitHub dari diskusi item kerja.
Melihat status build untuk alur YAML (Terintegrasi dalam build)
Saat Anda menggunakan Azure Pipelines YAML untuk membangun kode yang dihosting di repositori GitHub, Anda dapat secara otomatis membuat tautan terintegrasi dalam build pada item kerja terkait. Fitur ini menyediakan keterlacakan build untuk repositori GitHub, mencapai paritas dengan pengalaman yang tersedia untuk Azure Repos.
Untuk mengaktifkan fitur ini:
Buka alur YAML Anda, pilih
Tindakan lainnya, lalu pilih Pengaturan.Dalam dialog Pengaturan alur , aktifkan Tautkan item kerja baru secara otomatis dalam build ini.
Setelah build selesai, tautan Terintegrasi dalam build secara otomatis muncul di bagian Pengembangan dari setiap item kerja terkait, memberi tim Anda keterlacakan penuh dari item kerja ke build.
Untuk informasi selengkapnya tentang mengonfigurasi pengaturan ini, lihat Mengonfigurasi alur untuk mendukung pelacakan kerja.
Menampilkan objek GitHub di papan
Dengan mengaktifkan anotasi GitHub di papan, Anda dapat dengan cepat membuka komit GitHub yang terhubung, pull request, atau isu untuk mendapatkan detail lebih lanjut. Untuk informasi selengkapnya, lihat Mengkustomisasi kartu.
