Menyambungkan Azure Boards ke GitHub (cloud)

Layanan Azure DevOps

Sambungkan proyek Azure Boards Anda ke repositori GitHub.com sehingga permintaan penerapan dan penarikan secara otomatis ditautkan ke item kerja. Integrasi ini memungkinkan Anda merencanakan dan melacak pekerjaan di Azure Boards saat tim Anda berkembang di GitHub.

Setelah tersambung, Anda dapat:

• Menautkan komit, cabang, dan pull request secara otomatis ke item kerja
• Memantau kemajuan pengembangan langsung dari Azure Boards
• Menggunakan GitHub Copilot dengan item kerja untuk pengembangan yang dibantu AI

Note

Azure Boards mendukung integrasi dengan GitHub.com dan GitHub Enterprise Server. Untuk menyambungkan dari Azure DevOps Server lokal, lihat Menyambungkan Server Azure DevOps ke GitHub Enterprise Server.

Prerequisites

Category	Requirements
Permissions	- Anggota grup Administrator Koleksi Proyek Jika Anda membuat proyek, Anda memiliki izin. - Administrator atau pemilik repositori GitHub untuk disambungkan. Anda dapat terhubung ke beberapa repositori GitHub selama Anda adalah administrator untuk repositori tersebut.
Keanggotaan proyek	Anggota proyek.

Opsi autentikasi

Opsi autentikasi berikut didukung berdasarkan platform GitHub yang ingin Anda sambungkan.

GitHub.com

Server Perusahaan GitHub

• GitHub.com akun pengguna (Disarankan)
• Token akses pribadi (PAT)

• OAuth (disukai, pendaftaran diperlukan)
• PAT
• GitHub kredensial

Note

Jika Anda terhubung dengan PAT, konfigurasikan single sign-on (SSO) untuk itu di akun GitHub Anda. SSO diperlukan untuk mencantumkan repositori dari organisasi yang menggunakan autentikasi SAML.

Menyambungkan Azure Boards ke repositori GitHub

1. Masuk ke proyek Anda (https://dev.azure.com/{Your_Organization/Your_Project}).

2. Pilih Pengaturan Proyek>Koneksi GitHub.

   

3. Untuk koneksi pertama kali, pilih Sambungkan akun GitHub Anda untuk mengautentikasi dengan kredensial GitHub Anda.

   

   Untuk koneksi berikutnya, pilih Koneksi baru dan pilih metode autentikasi Anda.

   Untuk menyambungkan dengan PAT, lihat Menambahkan koneksi GitHub menggunakan PAT. Untuk GitHub Enterprise Server, lihat Mendaftarkan Azure DevOps di GitHub sebagai Aplikasi OAuth.

Menambahkan koneksi GitHub dengan kredensial GitHub

Anda dapat menyambungkan hingga 1.000 repositori GitHub ke proyek Azure Boards.

1. Masuk dengan kredensial GitHub Anda. Pilih akun tempat Anda menjadi administrator repositori.

2. Pilih akun gitHub atau organisasi yang akan disambungkan. Hanya organisasi yang Anda miliki atau kelola yang muncul dalam daftar.

   Jika semua repositori untuk organisasi sudah tersambung, pesan berikut muncul:

   

3. Masukkan kredensial GitHub Anda. Jika Anda mengaktifkan autentikasi dua faktor, masukkan kode yang dikirim oleh GitHub dan pilih Verifikasi.

Menambahkan repositori GitHub

Setelah Anda mengautentikasi, pilih repositori yang akan disambungkan.

1. Dialog Tambahkan Repositori GitHub ditampilkan dan telah memilih semua repositori tempat Anda menjadi administrator di organisasi yang dipilih. Hapus repositori apa pun yang tidak ingin Anda sambungkan.

   

   Tip

   Sambungkan setiap repositori GitHub ke proyek dalam satu organisasi Azure DevOps untuk mencegah terjadinya penautan AB# yang tidak diinginkan. Untuk informasi selengkapnya, lihat Mengatasi masalah koneksi.

   Jika semua repositori sudah tersambung ke organisasi saat ini atau organisasi lain, pesan berikut muncul:

   

2. Pilih Simpan.

Konfirmasikan koneksi

1. Pada halaman GitHub, pilih Setujui, Instal, & Otorisasi.

   

2. Masukkan kredensial GitHub Anda untuk mengonfirmasi.

3. Koneksi baru ditampilkan dengan repositori terpilih yang tercantum.

Untuk mengubah konfigurasi atau mengelola aplikasi Azure Boards untuk GitHub, lihat Change repository access to Azure Boards.

Menambahkan koneksi GitHub menggunakan PAT

Important

Pertimbangkan untuk menggunakan token Microsoft Entra yang lebih aman daripada token akses personal yang berisiko lebih tinggi. Untuk informasi selengkapnya, lihat Mengurangi penggunaan PAT. Tinjau panduan autentikasi untuk memilih mekanisme autentikasi yang tepat untuk kebutuhan Anda.

Tip

Saat Anda membuat PAT GitHub Anda, sertakan cakupan ini: repo, read:user, user:email, admin:repo_hook.

1. Pilih Token Akses Pribadi dalam dialog Koneksi Baru .

   

   Untuk membuat PAT GitHub, buka GitHub Pengaturan Pengembang > Token akses pribadi.

2. Masukkan PAT dan pilih Sambungkan.

   

3. Pilih repositori yang akan disambungkan. Untuk detailnya, lihat Menambahkan repositori GitHub.

4. Untuk koneksi pertama kali, instal aplikasi Azure Boards untuk GitHub. Lihat Mengonfirmasi koneksi.

Mendaftarkan Azure DevOps di GitHub sebagai Aplikasi OAuth

Untuk menyambungkan Azure DevOps dengan GitHub Enterprise Server Anda menggunakan OAuth, daftarkan aplikasi sebagai Aplikasi OAuth. Untuk informasi selengkapnya, lihat Membuat Aplikasi OAuth.

Mendaftarkan Layanan Azure DevOps

1. Masuk ke portal web untuk GitHub Enterprise Server Anda.

   

2. Buka Pengaturan>Pengaturan Pengembang>Oauth Apps>Aplikasi OAuth Baru.

   

3. Masukkan informasi pendaftaran.

   • URL Beranda — URL organisasi Anda.
   • URL panggilan balik otorisasi — Gunakan pola {Organization URL}/_admin/oauth2/callback. Misalnya: https://dev.azure.com/fabrikam/_admin/oauth2/callback

   

4. Pilih Daftar aplikasi.

5. Salin ID Klien dan Rahasia Klien yang muncul untuk aplikasi OAuth terdaftar Anda.

   

Daftarkan konfigurasi OAuth Anda di Layanan Azure DevOps

1. Masuk ke portal web untuk Layanan Azure DevOps.

2. Pilih Pengaturan organisasi> Konfigurasi >Tambahkan konfigurasi Oauth.

   

3. Masukkan informasi Anda dan pilih Buat.

   

Menyambungkan Azure DevOps Services ke GitHub Enterprise Server

Important

GitHub Enterprise Server Anda harus dapat diakses dari Internet. Verifikasi bahwa Azure DNS dapat mengatasi nama server dan firewall Anda mengizinkan akses dari rentang IP Azure Data Center. Kesalahan umumnya adalah:

Nama host tidak dapat dipecahkan: 'github-enterprise-server.contoso.com'

Jika Anda melihat kesalahan ini, periksa aksesibilitas server Anda. Untuk informasi selengkapnya, lihat FAQ Azure DNS.

1. Pilih Pengaturan proyek>GitHub koneksi>GitHub Enterprise Server untuk koneksi pertama kali.

   

   Untuk koneksi berikutnya, pilih GitHub Enterprise Server dari dialog Koneksi GitHub Baru .

   

2. Pilih metode autentikasi.

   

   Sambungkan dengan OAuth — Pilih konfigurasi OAuth yang Anda daftarkan di Daftarkan konfigurasi OAuth Anda, lalu pilih Sambungkan.

   

   Sambungkan dengan Token Akses Pribadi — Masukkan URL Dan PAT GitHub Enterprise Server Anda, lalu pilih Sambungkan.

   

   Sambungkan dengan kredensial GitHub — Masukkan URL GitHub Enterprise Server dan info masuk administrator Anda, lalu pilih Sambungkan.

   

3. Dialog mencantumkan semua repositori tempat Anda memiliki hak administrasi. Alihkan antara Milik Saya dan Semua untuk menemukan repositori tambahan, pilih repositori yang akan ditambahkan, lalu pilih Simpan.

   

   Tip

   Setiap koneksi hanya mendukung satu organisasi GitHub. Untuk menyambungkan repositori dari organisasi lain, tambahkan koneksi terpisah.

4. Untuk koneksi pertama kali, instal aplikasi Azure Boards untuk GitHub. Lihat Mengonfirmasi koneksi.

Mengatasi masalah koneksi

Integrasi Azure Boards–GitHub menggunakan beberapa protokol autentikasi untuk mempertahankan koneksi. Perubahan pada cakupan izin atau kredensial dapat memutuskan sambungan repositori GitHub yang ditautkan.

Untuk gambaran umum integrasi, lihat Integrasi Azure Boards-GitHub.

Opsi autentikasi yang didukung

Opsi autentikasi yang didukung berikut bergantung pada platform GitHub yang Anda sambungkan:

Platform

GitHub.com

Server Perusahaan GitHub

Layanan Azure DevOps

• GitHub.com akun pengguna
• Token akses pribadi (PAT)

• OAuth
• PAT
• kredensial GitHub

Azure DevOps Server 2020

Tidak berlaku

• PAT
• kredensial GitHub

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.

Memberikan akses Azure Boards kepada organisasi

Jika integrasi tidak berfungsi seperti yang diharapkan, verifikasi bahwa Anda memberikan akses organisasi.

1. Di portal web GitHub, buka Pengaturan dari menu profil Anda.
   

2. Pilih Aplikasi di bawah Integrasi> Aplikasi OAuth Resmi>Azure Boards.

3. Di bawah Akses organisasi, pilih Berikan untuk organisasi apa pun yang memperlihatkan Permintaan akses tertunda.

   

Mengatasi masalah akses

Saat koneksi Azure Boards ke GitHub kehilangan akses, pemberitahuan red-X muncul di UI. Arahkan mouse ke atas pemberitahuan untuk mengonfirmasi kredensial tidak lagi valid. Hapus koneksi dan buat yang baru.

• Koneksi OAuth:

  • Akses Azure Boards ditolak untuk salah satu repositori.

  • GitHub atau Azure DevOps mungkin tidak dapat dijangkau karena pemadaman layanan atau masalah jaringan. Periksa status: GitHub | Azure DevOps

    Hapus dan buat ulang koneksi. GitHub meminta Anda untuk mengotorisasi ulang Azure Boards.

• Koneksi PAT:

  • PAT dicabut atau cakupan izinnya tidak mencukupi.

  • Pengguna mungkin tidak memiliki izin admin pada repositori GitHub.

    Buat ulang PAT dengan cakupan yang diperlukan: repo, read:user, user:email, admin:repo_hook. Untuk informasi selengkapnya, lihat panduan praktik terbaik untuk menggunakan PAT.

Mengatasi koneksi GitHub Enterprise Server yang rusak

Jika Anda bermigrasi dari Azure DevOps Server ke Azure DevOps Services dengan koneksi GitHub Enterprise Server yang ada, item kerja yang disebutkan di GitHub mungkin tertunda atau hilang karena URL panggilan balik tidak lagi valid.

• Hapus dan buat ulang koneksi — Ikuti langkah-langkah di Menyambungkan Layanan Azure DevOps ke GitHub Enterprise Server.

• Perbaiki URL webhook — Di pengaturan repositori GitHub Anda, perbarui URL webhook untuk menunjuk ke organisasi yang dimigrasikan: https://dev.azure.com/{OrganizationName}/_apis/work/events?api-version=5.2-preview

Terhubung ke beberapa organisasi Azure DevOps

Menghubungkan repositori GitHub ke proyek di beberapa organisasi Azure DevOps (misalnya, dev.azure.com/Contoso dan dev.azure.com/Fabrikam) dapat menyebabkan perilaku penyebutan AB# yang tidak terduga. ID item kerja tidak unik di seluruh organisasi, sehingga AB#12 dapat mencocokkan item kerja di salah satu organisasi. Kedua organisasi mungkin mencoba membuat tautan ke ID yang sesuai, sehingga menyebabkan kebingungan.

Untuk menghindari masalah ini, sambungkan setiap repositori GitHub hanya ke satu organisasi Azure DevOps.

Note

Aplikasi Azure Boards untuk GitHub mencegah koneksi ke beberapa organisasi. Jika repositori tersambung ke organisasi yang salah, hubungi pemilik organisasi tersebut untuk menghapus koneksi sebelum menambahkannya ke organisasi yang benar.

Memperbarui definisi XML untuk memilih jenis item kerja

Jika organisasi Anda menggunakan xml yang dihosting atau model proses XML lokal, perbarui definisi XML untuk jenis item kerja untuk menampilkan jenis tautan GitHub di bagian Pengembangan formulir item kerja.

Misalnya, untuk menautkan cerita pengguna dan bug ke komitmen GitHub dan permintaan tarik dari bagian Pengembangan, perbarui definisi XML untuk jenis item pekerjaan tersebut.

Ikuti langkah-langkah dalam model proses XML yang dihosting. Untuk setiap jenis item kerja, temukan bagian Group Label="Development" dan tambahkan baris berikut untuk mendukung jenis tautan GitHub Commit dan GitHub Pull Request :

             <ExternalLinkFilter Type="GitHub Pull Request" />  
             <ExternalLinkFilter Type="GitHub Commit" />  

Setelah Anda memperbarui, bagian akan muncul sebagai berikut:

<Group Label="Development">  
   <Control Type="LinksControl" Name="Development">  
      <LinksControlOptions ViewMode="Dynamic" ZeroDataExperience="Development" ShowCallToAction="true">  
         <ListViewOptions GroupLinks="false">   
         </ListViewOptions>  
         <LinkFilters>  
             <ExternalLinkFilter Type="Build" />  
             <ExternalLinkFilter Type="Integrated in build" />  
             <ExternalLinkFilter Type="Pull Request" />  
             <ExternalLinkFilter Type="Branch" />  
             <ExternalLinkFilter Type="Fixed in Commit" />  
             <ExternalLinkFilter Type="Fixed in Changeset" />  
             <ExternalLinkFilter Type="Source Code File" />  
             <ExternalLinkFilter Type="Found in build" />  
             <ExternalLinkFilter Type="GitHub Pull Request" />  
             <ExternalLinkFilter Type="GitHub Commit" />  
         </LinkFilters>  
      </LinksControlOptions>  
   </Control>  
</Group>  

FAQs

T: Beberapa pengguna saya di Azure DevOps memiliki identitas GitHub. Apakah saya perlu menambahkannya sebagai pengguna GitHub baru ke organisasi saya?

A: Tidak. Instruksikan pengguna Anda untuk keluar, lalu masuk kembali ke organisasi dengan kredensial GitHub mereka dari sesi baru di browser.

T: Saya adalah Administrator organisasi dan saya mengaktifkan kebijakan untuk mengundang pengguna GitHub. Mengapa saya tidak dapat mengundang pengguna GitHub baru?

J: Logout dari Azure DevOps dan login kembali ke organisasi (dev.azure.com/{organizationName} atau organizationName.visualstudio.com) dengan kredensial GitHub Anda dari sesi baru di browser.

T: Saya masuk dengan kredensial GitHub saya, tetapi mengapa saya tidak dapat mengundang pengguna GitHub?

A: Hanya Administrator organisasi atau proyek yang dapat mengundang pengguna baru. Bekerja sama dengan administrator Anda untuk mendapatkan izin atau meminta mereka untuk menambahkan pengguna.

T: Apakah pengguna perusahaan GitHub mendapatkan akses gratis ke Azure DevOps?

A: Untuk informasi selengkapnya, lihat TANYA JAWAB UMUM pengelolaan Pengguna dan izin/GitHub Enterprise.

Langkah selanjutnya

Link GitHub penerapan, permintaan pull, dan cabang untuk item kerja

Konten terkait

• Install dan konfigurasikan aplikasi Azure Boards untuk GitHub
• Konfigurasi lencana status untuk ditambahkan ke GitHub file README
• Memecahkan masalah integrasi GitHub dan Azure Boards
• Membangun repositori GitHub
• Ubah akses repositori GitHub