Bagikan melalui

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

Category Requirements
Permissions - Anggota grup Administrator Koleksi Proyek. Jika Anda membuat proyek, Anda memiliki izin.
- Administrator atau pemilik organisasi GitHub untuk memasang aplikasi Azure Boards.
- Read hak akses untuk repositori GitHub.
Keanggotaan Proyek Anggota proyek.

Important

Jika repositori Anda sudah tersambung dengan menggunakan jenis autentikasi lain seperti OAuth, Anda harus menghapus repositori tersebut dari koneksi yang ada sebelum menyambungkannya kembali dengan menggunakan Aplikasi GitHub. Ikuti langkah-langkah yang disediakan di Tambahkan atau hapus 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. Anda tidak boleh menyambungkan repositori GitHub ke lebih dari satu organisasi Azure DevOps.

Menginstal dan mengonfigurasi aplikasi Azure Boards

Urutan penginstalan Anda mungkin bervariasi karena konfigurasi akun Anda. Jika perlu, ikuti petunjuk layar di antara langkah-langkah berikut.

  1. Buka aplikasi Azure Boards di GitHub Marketplace.

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

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

    Contoh ini menggunakan Semua repositori:

    Cuplikan layar memperlihatkan halaman Instal dan Otorisasi dengan semua repositori dipilih.

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

    Screenshot memperlihatkan halaman Siapkan proyek Azure Boards tempat Anda memilih organisasi dan project.

    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.

Memberikan akses kepada organisasi Azure Boards

Jika perlu, untuk memberikan akses GitHub ke organisasi Azure DevOps Anda, lakukan langkah-langkah berikut.

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

    Cuplikan layar memperlihatkan opsi Pengaturan di profil Anda.

  2. Pilih Aplikasi di bawah Integrasi.

  3. Pilih Aplikasi GitHub Resmi>Azure Boards.

    Screenshot menunjukkan aplikasi GitHub resmi dengan Azure Boards disorot.

  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.

    Cuplikan layar memperlihatkan akses ke organisasi dengan organisasi lain yang tidak memiliki akses.

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.

    Cuplikan layar memperlihatkan kebijakan akses aplikasi pihak ketiga.

Nota

Anda harus menjadi pemilik atau administrator organisasi untuk mengubah pengaturan ini.

Gunakan koneksi

Pada titik ini, integrasi GitHub Azure Boards 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 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. Dari jenis Link, pilih GitHub Pull Request.

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

  5. Pilih Tambahkan tautan.

    Cuplikan layar memperlihatkan tindakan Tambahkan 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 tersambung.
    • Membuat commit GitHub untuk update yang dilakukan dengan menambahkan lencana ke file README.
    • Membuat permintaan pull GitHub untuk menggabungkan perubahan yang dibuat ke file README.
    • Menautkan komit dan permintaan tarik GitHub ke item kerja yang dibuat di langkah 1.

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

    Screenshot menunjukkan formulir masalah untuk permintaan pull yang dibuka di GitHub.

    Permintaan GitHub pull terbuka di tab browser baru.

  7. Pilih Gabungkan pull request.

    Screenshot menunjukkan contoh permintaan pull di GitHub.

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

    Screenshot menunjukkan repositori GitHub dengan lencana yang telah ditambahkan.

    Untuk informasi selengkapnya, lihat Tambahkan lencana status untuk repositori GitHub Anda.

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, kami sarankan Anda menghapus koneksi dan memulai kembali dengan koneksi baru.

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

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

    Screenshot memperlihatkan menu koneksi GitHub Lainnya.

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

    Screenshot menunjukkan konfirmasi penghapusan koneksi GitHub.

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.

    Screenshot memperlihatkan Aplikasi GitHub terinstal dengan Azure Boards dan opsi 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 tertentu, pilih repositori yang ingin Anda gabungkan dalam integrasi dengan Azure Boards.

    Cuplikan layar memperlihatkan akses Repositori, tempat Anda dapat memilih repositori yang dipilih.

  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 memperlihatkan bagian Zona bahaya, dengan opsi untuk menangguhkan dan menghapus instalasi.

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

    Cuplikan layar memperlihatkan dialog 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 memperlihatkan dialog konfirmasi penghapusan instalasi.

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 Pindahkan koneksi untuk menghapus semua koneksi GitHub yang dibuat sebelumnya. Untuk informasi selengkapnya, lihat Tambahkan atau hapus repositori GitHub.

Screenshot menunjukkan aplikasi Azure Boards GitHub yang belum diinstal.

Langkah selanjutnya

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

Konten terkait

  • Last updated on