Bagikan melalui

Menginstal aplikasi Azure Boards untuk GitHub

Layanan Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Dalam mulai cepat ini, Anda menginstal 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 komit GitHub dan permintaan tarik ke item kerja. Anda dapat menggunakan GitHub untuk pengembangan perangkat lunak saat menggunakan Azure Boards untuk merencanakan dan melacak pekerjaan Anda. Setelah Anda menginstal aplikasi Azure Boards untuk GitHub di akun gitHub atau organisasi 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.
- 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 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. 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. Di Instal & Otorisasi Azure Boards, pilih repositori yang ingin Anda sambungkan ke Azure Boards, lalu pilih Instal & 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.

    Cuplikan layar memperlihatkan halaman Siapkan proyek Azure Boards tempat Anda memilih organisasi dan proyek.

    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 ke organisasi Azure Boards

Jika perlu, 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 memperlihatkan opsi Pengaturan di profil Anda.

  2. Pilih Aplikasi di bawah Integrasi.

  3. Pilih GitHub Apps Resmi>Azure Boards.

    Cuplikan layar memperlihatkan 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 Organisasi dengan organisasi tanpa 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 masuk ke 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 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 "Menambahkan lencana pada README"—Masalah (Dasar), Cerita Pengguna (Tangkas), atau Item Backlog Produk (Scrum)—bergantung pada model proses yang digunakan oleh proyek Anda di Azure Boards.

    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 tautan, pilih Permintaan Pull GitHub.

  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 terhubung.
    • Membuat komit GitHub untuk memperbarui yang dilakukan dengan menambahkan lencana ke file README.
    • Membuat permintaan pull GitHub untuk menggabungkan perubahan yang dibuat ke file README.
    • Menyambungkan commit dan permintaan tarik GitHub ke item kerja yang dibuat di langkah 1.

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

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

    Permintaan pull GitHub terbuka di tab browser baru.

  7. Pilih Gabungkan pull request.

    Cuplikan layar memperlihatkan contoh permintaan pull di GitHub.

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

    Cuplikan layar memperlihatkan repositori GitHub dengan lencana ditambahkan.

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

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 Menambahkan atau menghapus repositori, atau menghapus 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>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 memperlihatkan menu koneksi GitHub opsi Lainnya.

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

    Cuplikan layar memperlihatkan penghapusan konfirmasi koneksi GitHub.

Mengubah akses repositori

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

  2. PilihAplikasi>. Di bawah Aplikasi GitHub terinstal, pilih Konfigurasikan.

    Cuplikan layar 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, pilih repositori yang ingin Anda berpartisipasi 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 dialihkan 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 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 atau menghapus repositori GitHub.

Cuplikan layar memperlihatkan aplikasi GitHub Azure Boards yang dihapus instalasinya.

Langkah selanjutnya

Menautkan commit GitHub, permintaan pull, dan cabang ke item kerja

Konten terkait

  • Last updated on