Instal aplikasi Azure Boards untuk GitHub

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Dalam panduan cepat ini, Anda menginstal aplikasi Azure Boards untuk GitHub agar menghubungkan Azure Boards ke repositori GitHub Anda. Dengan menyambungkan proyek Azure Boards dengan repositori GitHub.com, Anda mendukung penautan antara commit GitHub dan permintaan pull ke item kerja. Anda dapat menggunakan GitHub untuk pengembangan perangkat lunak saat menggunakan Azure Boards untuk merencanakan dan melacak pekerjaan Anda. Setelah Menginstal aplikasi Azure Boards untuk GitHub di akun atau organisasi GitHub Anda, pilih repositori GitHub mana yang ingin Anda sambungkan dari proyek Anda.

Untuk gambaran umum integrasi yang didukung aplikasi Azure Boards untuk GitHub, lihat integrasi Azure Boards-GitHub.

Prerequisites

Menginstal dan mengonfigurasi aplikasi Azure Boards

Langkah-langkah berikut menunjukkan urutan penginstalan umum. Ikuti perintah di layar apa pun untuk menyelesaikan penyiapan.

1. Buka aplikasi Azure Boards di GitHub Marketplace.

2. Di bawah Paket dan harga, di bawah Gratis, pilih Instal.

3. Dalam Instal & Otorisasi Azure Boards, pilih repositori yang ingin Anda sambungkan ke Azure Boards, lalu pilih Instal & Otorisasi.

   Contoh ini menggunakan Semua repositori:

   

4. Pilih organisasi Azure DevOps dan proyek Azure Boards yang ingin Anda sambungkan ke GitHub.com.

   

   Anda hanya dapat menyambungkan satu proyek pada satu waktu. Jika Anda ingin menyambungkan proyek lain, lihat Mengonfigurasi proyek atau repositori lain.

Berikan akses organisasi ke Azure Boards

Untuk memberikan akses GitHub ke organisasi Azure DevOps Anda, selesaikan langkah-langkah berikut.

1. Dari portal web GitHub, buka Settings dari menu profil Anda.

   

2. Pilih Aplikasi di bawah Integrasi.

3. Pilih Aplikasi GitHub Resmi>Azure Boards.

   

4. Di bawah Akses organisasi, atasi masalah apa pun yang mungkin muncul. Pilih Berikan untuk memberikan akses ke organisasi mana pun yang memiliki permintaan akses tertunda.

   

Periksa kebijakan akses aplikasi pihak ketiga Anda

Pastikan organisasi GitHub Anda mengizinkan akses aplikasi pihak ketiga untuk aplikasi Azure Boards. Jika akses pihak ketiga dibatasi, menambahkan repositori dari Azure DevOps dapat menampilkan daftar kosong atau menghasilkan kesalahan.

Untuk mengaktifkan akses:

1. Di GitHub, buka organisasi Anda dan buka Pengaturan>kebijakan aplikasi OAuth.

2. Setujui aplikasi Azure Boards secara khusus (disarankan), atau hapus batasan untuk semua aplikasi pihak ketiga.

   

Tautkan item kerja ke pull request GitHub

Setelah mengonfigurasi integrasi Azure Boards-GitHub, Anda dapat menautkan item kerja Anda ke permintaan pull dan commit GitHub.

Contoh berikut menunjukkan integrasi dengan membuat item kerja dan menautkannya ke permintaan pull:

1. Di papan Anda, pilih Item kerja baru untuk membuat item kerja. Untuk contoh ini, gunakan judul "Tambahkan lencana ke README". Jenis item kerja bergantung pada proses Anda: Isu (Basic), Cerita Pengguna (Agile), atau Item Backlog Produk (Scrum).

   Item kerja baru muncul di papan Anda.

2. Buka item kerja Anda dan buka bagian Pengembangan .

3. Pilih Tambahkan tautan lalu pilih GitHub Permintaan Pull dari menu Jenis tautan.

4. Pilih repositori dan masukkan ID permintaan pull. Anda juga dapat menambahkan komentar opsional.

5. Pilih Tambahkan tautan untuk membuat koneksi.

   Azure Boards secara otomatis melakukan tindakan berikut di latar belakang:

   • Menambahkan lencana ke file README dari repositori pertama dalam daftar repositori GitHub yang tersambung
   • Membuat commit GitHub untuk pembaruan lencana
   • Membuat permintaan pull GitHub untuk menggabungkan perubahan ke file README
   • Menautkan commit dan pull request GitHub ke item kerja Anda

6. Di item kerja Anda, pilih tautan permintaan pull untuk membukanya di GitHub.

7. Pilih Gabungkan permintaan pull di GitHub.

8. Di repositori GitHub Anda, buka file README untuk memverifikasi lencana ditambahkan. Untuk informasi selengkapnya, lihat Mengonfigurasi lencana status untuk ditambahkan ke file README GitHub.

Mengonfigurasi proyek atau repositori lain

Anda dapat mengonfigurasi Azure Boards/Azure DevOps Projects lainnya, GitHub.com repositori, atau mengubah konfigurasi saat ini dari halaman aplikasi Azure Boards. Untuk informasi selengkapnya, lihat Tambahkan atau hapus repositori, atau hapus koneksi dari Azure Boards.

Menambahkan atau menghapus repositori, atau menghapus koneksi dari Azure Boards

Jika Anda mengalami masalah dengan koneksi, hapus koneksi dan mulai lagi dengan koneksi baru.

Mengubah akses repositori

1. Dari portal web GitHub, buka Settings dari menu profil Anda.

2. Pilih Integrasi>Aplikasi. Di bawah Instal GitHub Apps, pilih Konfigurasi.

   

   Halaman konfigurasi Azure Boards terbuka.

3. Gulir ke bawah ke bagian Akses repositori .

4. Pilih opsi yang Anda inginkan, Semua repositori atau Hanya pilih repositori.

   Jika Anda memilih Hanya pilih repositori tertentu, pilih repositori yang ingin Anda gabungkan dalam integrasi dengan Azure Boards.

   

5. Pilih Simpan.

Menangguhkan atau menghapus instalan integrasi Azure Boards

1. Mulai dari langkah 2 di prosedur sebelumnya, gulir ke bawah ke bagian Zona bahaya.

   

2. Untuk menangguhkan integrasi, pilih Tangguhkan. Dari jendela konfirmasi, pilih OK untuk mengonfirmasi penangguhan.

   

   Untuk membatalkan penangguhan integrasi, pilih Batalkan penangguhan.

3. Untuk menghapus instalan aplikasi Azure Boards, pilih Hapus instalan, lalu pilih OK dari jendela konfirmasi popup.

   

Memperbarui koneksi Azure Boards-GitHub

Jika Anda mengubah repositori yang didukung aplikasi Azure Boards untuk GitHub, Anda mungkin diarahkan ke koneksi Azure Boards GitHub. Praktik yang baik adalah menghapus repositori di Azure Boards yang tidak dapat lagi terhubung ke GitHub. Untuk informasi selengkapnya, lihat Tambahkan atau hapus repositori GitHub.

Jika Anda menghapus instalan aplikasi Azure Boards untuk GitHub, pesan berikut ditampilkan di Azure Boards, Pengaturan proyek>GitHub koneksi. Pilih Hapus koneksi untuk menghapus semua koneksi GitHub yang dibuat sebelumnya. Untuk informasi selengkapnya, lihat Tambahkan atau hapus repositori GitHub.

Memecahkan masalah integrasi

Daftar repositori kosong saat menambahkan repositori

Jika daftar repositori muncul kosong di Azure DevOps:

• Verifikasi bahwa organisasi GitHub Anda telah mengaktifkan akses aplikasi pihak ketiga.
• Pastikan Anda telah memberikan izin kepada Azure Boards untuk mengakses organisasi Anda di Memberikan akses organisasi Azure Boards.
• Di GitHub, periksa pengaturan organisasi Anda > Aplikasi GitHub yang terinstal > Azure Boards > Akses organisasi. Jika status memperlihatkan "Permintaan akses tertunda", pilih Berikan untuk menyetujui.

Status macet "Permintaan akses tertunda"

Jika akses organisasi tetap tertunda:

• Anda harus menjadi pemilik atau administrator organisasi GitHub untuk menyetujui permintaan.
• Pilih Grant di bagian Akses organisasi pada pengaturan aplikasi yang diizinkan Anda.
• Jika masalah berlanjut, hapus instalan aplikasi Azure Boards dan instal ulang dengan mengikuti langkah-langkah di Menginstal dan mengonfigurasi aplikasi Azure Boards.

Lencana tidak muncul setelah menautkan permintaan pull

Jika lencana tidak muncul di file README Anda setelah menautkan permintaan pull:

• Lencana hanya muncul saat Anda menautkan pull request dan repositori tersebut merupakan yang pertama dalam daftar terhubung Anda.
• Verifikasi bahwa PR yang Anda tautkan masih terbuka (PR gabungan tidak memicu pembuatan lencana).
• Periksa apakah Azure Boards memiliki akses tulis ke repositori Anda.

Kesalahan autentikasi atau izin

Jika Anda melihat kesalahan autentikasi selama penyiapan:

• Verifikasi bahwa Anda adalah pemilik atau administrator organisasi di GitHub.
• Pastikan organisasi GitHub Anda belum membatasi akses aplikasi pihak ketiga.
• Periksa apakah Anda memiliki izin Baca di repositori yang ingin Anda sambungkan.
• Coba keluar dari GitHub dan masuk kembali, lalu coba lagi otorisasi.

Langkah selanjutnya

Konten terkait

• Mendorong pengembangan Git dari item kerja
• Ubah akses ke repositori GitHub, atau menangguhkan maupun menghapus pemasangan integrasi
• Konfigurasi lencana status untuk ditambahkan ke GitHub file README