Bagikan melalui

Menginstal aplikasi Azure Boards untuk GitHub

  • Artikel

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

Instal aplikasi Azure Boards untuk GitHub untuk menyambungkan Azure Boards ke repositori GitHub Anda. Saat Anda menyambungkan proyek Azure Boards dengan repositori GitHub.com, Anda mendukung penautan antara penerapan 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.

Untuk gambaran umum integrasi yang didukung aplikasi Azure Boards untuk GitHub, lihat Integrasi Azure Boards-GitHub. Setelah Anda menginstal aplikasi Azure Boards untuk GitHub di akun atau organisasi GitHub Anda, pilih repositori GitHub mana yang ingin Anda sambungkan dari proyek Anda.

Prasyarat

Izin:

  • Anda harus menjadi administrator atau pemilik organisasi GitHub untuk menginstal aplikasi Azure Boards.
  • Anda harus memiliki izin Baca untuk repositori GitHub.
  • Anda harus menjadi anggota grup Administrator Koleksi Proyek. Jika Anda membuat proyek, Anda sudah memiliki izin ini.

Penting

Jika repositori Anda sudah tersambung melalui jenis autentikasi lain seperti OAuth, Anda harus menghapus repositori tersebut dari koneksi yang ada sebelum menyambungkannya kembali melalui Aplikasi GitHub. Ikuti langkah-langkah yang disediakan di Menambahkan atau menghapus repositori GitHub nanti di artikel ini sebelum Anda mengonfigurasi Aplikasi GitHub.

Anda dapat menyambungkan organisasi Azure DevOps ke beberapa repositori GitHub jika Anda adalah administrator untuk repositori tersebut. Namun, Anda tidak boleh menghubungkan repositori GitHub ke lebih dari satu organisasi Azure DevOps.

Memberikan akses organisasi Azure Boards

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

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

    Cuplikan layar profil terbuka, pilih Pengaturan.

  2. Pilih Aplikasi di bawah Integrasi.

  3. Pilih GitHub Apps>Resmi Azure Boards.

    Cuplikan layar tab Aplikasi OAuth Resmi, pilih Papan Azure.

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

    Cuplikan layar akses Organisasi dengan organisasi tanpa akses.

Menginstal dan mengonfigurasi aplikasi Azure Boards

  1. Buka aplikasi Azure Boards di GitHub Marketplace.

  2. Pilih Siapkan paket.

    Cuplikan layar GitHub Marketplace, tombol Siapkan paket.

  3. Pilih organisasi GitHub yang ingin Anda sambungkan ke Azure Boards.

    Cuplikan layar memperlihatkan dialog Instal Azure Boards.

  4. Pilih repositori yang ingin Anda sambungkan ke Azure Boards.

    Dalam contoh berikut, kami memilih untuk terhubung ke semua repositori.

    Cuplikan layar memperlihatkan semua repositori dipilih.

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

    Cuplikan layar menyiapkan dialog koneksi.

    Anda hanya dapat menyambungkan satu proyek pada satu waktu. Jika Anda memiliki proyek lain yang ingin Anda sambungkan, Anda dapat melakukannya nanti seperti yang dijelaskan di Mengonfigurasi proyek atau repositori lain nanti di artikel ini.

  6. Untuk menyambungkan dengan GitHub.com, otorisasi organisasi Azure Boards Anda.

    Cuplikan layar dialog otorisasi Azure Boards.

  7. Konfirmasikan repositori GitHub.com yang ingin Anda sambungkan. Pilih setiap repositori yang ingin Anda sambungkan. Batal pilih repositori apa pun yang tidak ingin Anda ikuti dalam integrasi.

    Cuplikan layar dialog Konfirmasi repositori GitHub Anda.

Gunakan koneksi

Pada titik ini, integrasi Azure Boards-GitHub Anda selesai. Anda dapat melewati langkah-langkah berikutnya atau menelusurinya untuk memahami fitur yang didukung dengan koneksi.

  1. Di papan Anda, pilih Item kerja baru untuk memasukkan item kerja baru bernama "Tambahkan lencana ke README"—Masalah (Dasar), Cerita Pengguna (Tangkas), atau Item Backlog Produk (Scrum)—tergantung pada model proses yang digunakan oleh proyek Azure Boards Anda.

    Item kerja berjudul Tambahkan lencana ke README muncul di papan Anda.

  2. Buka item kerja Anda, buka bagian Pengembangan , dan pilih Tambahkan tautan.

  3. Pilih GitHub Pull Request dari menu dropdown Jenis tautan.

  4. Pilih repositori dan masukkan ID permintaan pull dan komentar opsional.

  5. Pilih Tambahkan tautan.

    Cuplikan layar Tambahkan tindakan tautan dalam cerita pengguna, memperlihatkan pemilihan repositori dan kotak kosong untuk input ID permintaan pull dan komentar opsional.

    Tindakan berikut terjadi di latar belakang, secara otomatis:

    • Menambahkan lencana ke file README dari repositori pertama dalam daftar repositori GitHub yang terhubung.
    • Membuat penerapan GitHub untuk pembaruan yang dibuat dengan menambahkan lencana ke file README.
    • Membuat permintaan pull GitHub untuk menggabungkan perubahan yang dibuat ke file README.
    • Menautkan permintaan penerapan dan penarikan GitHub ke item kerja yang dibuat di langkah 1.

  6. Pilih tautan permintaan pull pertama dari item kerja Anda.

    Cuplikan layar formulir masalah untuk permintaan pull yang dibuka di GitHub.

    Permintaan pull GitHub terbuka di tab browser baru.

  7. Pilih Gabungkan permintaan pull.

    Cuplikan layar contoh permintaan pull di GitHub.

  8. Buka file README repositori Anda dan lihat lencana yang ditambahkan.

    Cuplikan layar repositori GitHub dengan lencana ditambahkan.

    Untuk informasi selengkapnya, lihat Mengonfigurasi lencana status untuk ditambahkan ke file GITHub README.

Mengonfigurasi proyek atau repositori lain

Anda dapat mengonfigurasi Proyek Azure Boards/Azure DevOps lainnya, repositori GitHub.com, atau mengubah konfigurasi saat ini dari halaman aplikasi Azure Boards. Untuk informasi selengkapnya, lihat Mengubah akses repositori GitHub, atau menangguhkan atau menghapus instalasi integrasi.

Menambahkan atau menghapus repositori, atau menghapus koneksi dari Azure Boards

Jika Anda mengalami masalah dengan koneksi, kami sarankan Anda menghapus koneksi dan memulai kembali dengan koneksi baru.

  1. Dari proyek Anda di Azure DevOps, buka Pengaturan>proyek koneksi GitHub.

  2. Untuk menambahkan atau menghapus repositori, pilih elipsis Opsi lainnya untuk koneksi dan pilih Tambahkan repositori atau Hapus repositori dari menu.

    Cuplikan layar menu koneksi GitHub opsi Lainnya.

  3. Untuk menghapus semua repositori dan koneksi, pilih opsi Hapus koneksi . Lalu, pilih Hapus untuk mengonfirmasi.

    Cuplikan layar penghapusan konfirmasi koneksi GitHub.

  1. Untuk menambahkan atau menghapus repositori, buka ikon tindakan untuk koneksi dan pilih Tambahkan repositori atau Hapus repositori dari menu.

    Cuplikan layar menambahkan atau menghapus repositori GitHub.

  2. Untuk menghapus semua repositori dan koneksi, pilih opsi Hapus koneksi . Lalu, pilih Hapus untuk mengonfirmasi.

    Cuplikan layar konfirmasi dialog penghapusan koneksi GitHub.

Mengubah akses repositori

  1. Masuk ke GitHub dan buka pengaturan profil organisasi Anda.

    https://github.com/organizations/fabrikam-fiber/settings/profile

  2. Buka Konfigurasi Papan Azure GitHub Apps>terinstal>.
    Cuplikan layar akun Organisasi terbuka, Aplikasi GitHub Terinstal, Papan Azure, Konfigurasikan.

    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, pilih repositori yang ingin Anda berpartisipasi dalam integrasi dengan Azure Boards.

    Cuplikan layar akses Repositori, pilih Hanya pilih repositori.

  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.

    Cuplikan layar konfigurasi Azure Boards, bagian Zona bahaya.

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

    Cuplikan layar konfirmasi 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.

    Cuplikan layar konfirmasi penghapusan instalasi.

Memperbarui koneksi Azure Boards-GitHub

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

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

Cuplikan layar aplikasi GitHub Azure Boards yang dihapus instalasinya.

Langkah berikutnya

Menautkan GitHub menerapkan dan menarik permintaan ke item kerja