Bagikan melalui

Menggunakan Azure Repos dengan Microsoft Teams

  • Artikel

Layanan Azure DevOps

Jika Anda menggunakan Microsoft Teams dan Azure Repos, Anda dapat menggunakan aplikasi Azure Repos for Teams untuk memantau repositori Anda. Aplikasi ini mendukung pemantauan repositori Git dan Team Foundation Version Control (TFVC), tetapi tidak mendukung integrasi dengan repositori GitHub.

Dalam artikel ini, pelajari cara melakukan tugas berikut:

  • Menambahkan aplikasi Azure Repos ke tim Anda di Microsoft Teams
  • Menyambungkan aplikasi Azure Repos ke repositori Anda
  • Mengelola langganan untuk acara terkait repo di saluran Anda
  • Cari dan bagikan info PR menggunakan ekstensi untuk menyusun
  • Pratinjau URL PR
  • Menghapus langganan dan repositori dari saluran

Prasyarat

  • Kelola langganan Anda, sehingga Anda menerima pemberitahuan di saluran Anda setiap kali kode diteruskan atau diunggah, atau saat pull request (PR) dibuat, diperbarui, atau digabungkan. Untuk membuat langganan untuk peristiwa terkait repositori, jadilah anggota grup Administrator Proyek , atau administrator tim. Untuk ditambahkan, lihat Mengubah izin tingkat proyek atau Menambahkan administrator tim.
  • Untuk menerima pemberitahuan, aktifkan akses aplikasi pihak ketiga melalui pengaturan OAuth untuk organisasi Azure DevOps. Lihat Mengubah kebijakan akses aplikasi untuk organisasi Anda.

Nota

  • Pemberitahuan saat ini tidak didukung di dalam pesan langsung.
  • Anda hanya dapat menautkan aplikasi Azure Repos untuk Microsoft Teams ke proyek yang dihosting di Azure DevOps Services.

Menambahkan aplikasi Azure Repos ke tim di Microsoft Teams

  1. Buka aplikasi Azure Repos di Microsoft Teams, Microsoft Teams > Azure Repos.

  2. Pilih Tambahkan atau jika Anda sudah mengunduh aplikasi, pilih menu dropdown di samping Buka, lalu pilih Tambahkan ke tim.

  3. Masukkan nama tim atau saluran, lalu pilih Siapkan bot.

    Cuplikan layar pesan selamat datang dari Azure Repos di Teams.

Menyambungkan aplikasi Azure Repos ke repositori Anda

  1. Setelah aplikasi diinstal di tim Anda, masukkan teks berikut ke dalam bidang balasan: @azure repos signin

    Jika Microsoft Teams dan Azure Boards Anda berada di tenant yang berbeda, pilih masuk menggunakan email berbeda.

    Cuplikan layar memperlihatkan tampilan masuk Teams untuk Azure Repos.

    Cuplikan layar memperlihatkan balasan lengkap masuk.

  2. Untuk memantau semua repositori Git dalam proyek, masukkan @azure repos subscribe [project url] ke saluran. Pastikan untuk menambahkan URL proyek Anda. URL proyek dapat mengarah ke halaman mana pun dalam proyek Anda (kecuali URL repositori).

    Anda juga dapat memantau repositori tertentu menggunakan: @azure repos subscribe [repo url].

    URL repositori dapat ke halaman mana pun dalam repositori Anda yang memiliki nama repositori Anda, misalnya, @azure repos subscribe https://dev.azure.com/myorg/myproject/_git/myrepo, atau untuk repositori TFVC: @azure repos subscribe https://dev.azure.com/myorg/myproject/_versionControl.

  3. Perintah subscribe membuat Anda mulai menggunakan langganan default. Untuk repositori Git, saluran akan berlangganan permintaan Pull yang dibuat peristiwa (dengan cabang target = utama). Untuk repositori TFVC, saluran berlangganan Code yang diperiksa dalam peristiwa.

    Cuplikan layar memperlihatkan pesan pembuatan langganan default.

Mengelola langganan

Untuk melihat, menambahkan, dan menghapus langganan untuk saluran, masukkan teks berikut: @azure repos subscriptions.

Anda melihat daftar semua langganan saat ini untuk saluran dan Anda dapat menambahkan langganan baru atau menghapus langganan yang sudah ada. Kustomisasi pemberitahuan Anda dengan berbagai filter, seperti yang dijelaskan di bagian berikut.

Nota

Administrator tim tidak dapat menghapus atau mengubah langganan yang dibuat oleh administrator Proyek.

Menampilkan langganan

Gunakan filter untuk hanya mendapatkan pemberitahuan yang Anda inginkan

Saat Anda berlangganan repositori dengan @azure repos subscribe, langganan default akan dibuat tanpa filter yang diterapkan. Seringkali, pengguna perlu menyesuaikan langganan ini untuk diberi tahu hanya ketika kondisi tertentu terpenuhi. Cuplikan layar berikut menunjukkan contoh pengaturan pemberitahuan hanya ketika tim kami berada dalam daftar peninjau untuk PR.

  1. Masukkan teks berikut ke saluran Anda: @azure repos subscriptions.

  2. Dalam daftar langganan, jika ada langganan yang tidak Anda inginkan atau harus diubah, pilih Hapus untuk menghapusnya.

  3. Pilih tombol Tambahkan langganan.

  4. Pilih jenis peristiwa, lalu pilih Berikutnya.

    Cuplikan layar memperlihatkan pilihan jenis peristiwa.

  5. Pilih repositori, lalu pilih Berikutnya.

    Cuplikan layar memperlihatkan pilihan repositori.

  6. Pilih filter yang sesuai untuk menyesuaikan langganan Anda, lalu pilih Kirim.

    Cuplikan layar memperlihatkan filter yang dipilih.

Nota

  • Semua filter biasanya berupa menu tarik-turun. Namun, jika drop-down memiliki lebih dari 100 item, Anda harus memasukkan nilai secara manual.
  • Untuk acara TFVC Code Checked in, filter pada jalur harus dalam format $/myproject/path.

Cari dan bagikan informasi pull request menggunakan ekstensi komposisi

Untuk membantu pengguna mencari dan berbagi informasi tentang pull request, aplikasi Azure Repos untuk Microsoft Teams mendukung ekstensi penyusun. Anda dapat mencari permintaan pull berdasarkan ID atau nama. Agar ekstensi berfungsi, masuk ke proyek Azure Repos dengan memasukkan @azure repos signin atau dengan masuk dalam ekstensi compose secara langsung.

Cuplikan layar memperlihatkan ekstensi menulis.

Pratinjau URL permintaan penarikan

Saat Anda menempelkan URL PR, pratinjau menunjukkan seperti yang ada di gambar berikut, yang membantu menjaga agar percakapan terkait PR tetap kontekstual dan akurat. Masuklah, lalu Anda dapat mempratinjau PR untuk URL di semua saluran dalam sebuah Tim.

Cuplikan layar memperlihatkan URL yang terbuka.

Hapus langganan dan repositori dari saluran

Untuk menghapus semua langganan yang terkait dengan repositori apa pun dalam proyek dan menghapus repositori dari saluran, masukkan teks berikut ke Teams: @azure repos unsubscribe all [project url]. Pastikan untuk memasukkan URL proyek. Hanya admin proyek yang dapat melakukan tugas ini.

Pemberitahuan Berjejak

Untuk menautkan serangkaian pemberitahuan terkait dan juga untuk mengurangi ruang yang ditempati oleh pemberitahuan di saluran, pemberitahuan akan diurutkan. Semua pemberitahuan yang ditautkan ke permintaan pull tertentu ditautkan bersama-sama.

Tampilan ringkas pemberitahuan utasCuplikan layar memperlihatkan tampilan ringkas pemberitahuan utas.

Tampilan pemberitahuan yang diperluasCuplikan layar memperlihatkan tampilan pemberitahuan utas yang diperluas.

Referensi perintah

Tabel berikut mencantumkan semua perintah azure repos yang bisa Anda gunakan di saluran Teams Anda.

Perintah Fungsionalitas
@azure repos subscribe [repo url/ project url] Berlangganan repositori atau semua repositori dalam proyek untuk menerima pemberitahuan
@azure repos subscriptions Menambahkan atau menghapus langganan untuk saluran ini
@azure repos signin Masuk ke organisasi Azure Repos Anda
@azure repos signout Keluar dari organisasi Azure Repos Anda
@azure repos feedback Melaporkan masalah atau menyarankan fitur
@azure repos unsubscribe all [project url] Menghapus semua repositori (milik proyek) dan langganan terkait dari saluran

Dukungan multi-penyewa

Jika Anda menggunakan email atau penyewa lain untuk Microsoft Teams dan Azure DevOps, lakukan langkah-langkah berikut untuk masuk, berdasarkan kasus penggunaan Anda.

Kasus penggunaan ID Email + penyewa Microsoft Teams ID Email + penyewa Azure DevOps Langkah
1 email1@abc.com (penyewa 1) email1@abc.com (penyewa 1) Pilih Masuk.
2 email1@abc.com (penyewa 1) email1@abc.com (penyewa 2) Masuk ke Azure DevOps. Di browser yang sama, mulai tab baru dan buka https://teams.microsoft.com/. Jalankan perintah signin dan pilih Sign in.
3 email1@abc.com (penyewa 1) email2@pqr.com (penyewa 2) Pilih Masuk dengan alamat email yang berbeda, lalu di pemilih ID email gunakan email2 untuk masuk ke Azure DevOps.
4 email1@abc.com (penyewa 1) email2@pqr.com (penyewa non default 3) Skenario ini tidak didukung.

Pemecahan masalah

Jika Anda mengalami kesalahan berikut saat menggunakan Aplikasi Azure Repos, ikuti prosedur di bagian ini.

Maaf, terjadi kesalahan. Silakan coba lagi.

Aplikasi Azure Repos menggunakan protokol autentikasi OAuth, dan memerlukan akses aplikasi pihak ketiga melalui OAuth agar organisasi diaktifkan. Untuk mengaktifkan pengaturan ini, navigasi ke Pengaturan Organisasi >Kebijakan>Keamanan, dan atur akses aplikasi pihak ketiga melalui OAuth untuk pengaturan organisasi ke Di.

Mengaktifkan akses aplikasi pihak ketiga melalui OAuth untuk pengaturan organisasi

Konfigurasi gagal. Pastikan organisasi '{nama organisasi}' ada dan Anda memiliki izin yang memadai.

Keluar dari Azure DevOps dengan menavigasi ke https://aka.ms/VsSignout menggunakan browser Anda.

Buka Di privat atau penyamaran jendela browser dan navigasi ke https://aex.dev.azure.com/me dan masuk. Di menu dropdown di bawah ikon profil di sebelah kiri, pilih direktori yang berisi organisasi yang berisi repositori tempat Anda ingin berlangganan.

Pilih direktori yang berisi organisasi yang berisi proyek

Di browser yang sama, buka tab baru dan masuk ke https://teams.microsoft.com/. Jalankan perintah @Azure Repos signout lalu jalankan perintah @Azure Repos signin di saluran tempat aplikasi Azure Repos untuk Microsoft Teams diinstal.

Pilih tombol Sign in dan Anda diarahkan ke halaman persetujuan seperti yang ada dalam contoh berikut. Pastikan bahwa direktori yang ditampilkan di samping email sama dengan apa yang dipilih di langkah sebelumnya. Terima dan selesaikan proses masuk.

Persetujuan untuk izin aplikasi yang diminta

Jika langkah-langkah ini tidak mengatasi masalah autentikasi Anda, hubungi kami di Komunitas Pengembang.