Azure Repos dengan Slack

  • Artikel

Azure DevOps

Jika Anda menggunakan Slack, Anda dapat menggunakan aplikasi Azure Repos untuk Slack untuk memantau repositori Azure Repos Anda dengan mudah. Siapkan dan kelola langganan untuk menerima pemberitahuan di saluran Anda setiap kali kode didorong atau dicek masuk dan setiap kali permintaan pull (PR) dibuat, diperbarui, atau digabungkan. Aplikasi ini mendukung peristiwa Git dan Team Foundation Version Control (TFVC).

Prasyarat

  • Untuk membuat langganan di saluran Slack untuk peristiwa terkait repositori, Anda harus menjadi anggota grup Administrator Proyek, atau menjadi administrator tim. Untuk ditambahkan, lihat Mengubah izin tingkat proyek atau Menambahkan administrator tim.
  • Untuk menerima pemberitahuan, akses aplikasi pihak ketiga melalui pengaturan OAuth harus diaktifkan untuk organisasi. Untuk informasi selengkapnya, lihat Mengubah kebijakan akses aplikasi untuk organisasi Anda.

Catatan

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

Menambahkan aplikasi Azure Repos ke ruang kerja Slack Anda

  1. Buka aplikasi Azure Repos Slack dan pilih Tambahkan ke Slack.

    Cuplikan layar direktori aplikasi Slack, Azure Repos dan tombol, Tambahkan ke Slack.

    Setelah ditambahkan, Anda menerima sesuatu seperti pesan selamat datang berikut.

    Cuplikan layar pesan Selamat Datang dari Slack.

  2. /azrepos Gunakan handel Slack untuk berinteraksi dengan aplikasi. Daftar lengkap perintah disediakan di bagian Referensi perintah di artikel ini.

Koneksi aplikasi Azure Repos ke repositori Anda

  1. Koneksi dan autentikasi diri Anda ke Azure Repos menggunakan /azrepos signin perintah.

    Cuplikan layar permintaan Masuk untuk Slack.

  2. Pilih Masuk.

  3. Terima Integrasi Azure Repos Slack.

    Cuplikan layar tombol Terima di layar masuk yang dihasilkan.

    Kode verifikasi ditampilkan untuk digunakan di aplikasi obrolan Anda untuk menyelesaikan autentikasi.

  4. Salin kode autentikasi.

    Cuplikan layar kode verifikasi yang disediakan oleh Azure Repos.

  5. Pilih Masukkan kode, tempelkan kode, lalu pilih Kirim.

    Cuplikan layar autentikasi akhir saat kode verifikasi ditempelkan lalu tombol kirim dipilih.

    Konfirmasi tampilan masuk dalam obrolan.

    Cuplikan layar konfirmasi masuk dalam obrolan.

Untuk mulai memantau semua repositori Git dalam proyek, gunakan perintah garis miring berikut di dalam saluran:

/azrepos subscribe [project url]

URL proyek dapat ke halaman mana pun dalam proyek Anda (kecuali URL ke repositori). Contohnya:

/azrepos subscribe https://dev.azure.com/myorg/myproject/

Anda juga dapat memantau repositori tertentu menggunakan perintah berikut:

/azrepos subscribe [repository url]

URL repositori dapat ke halaman mana pun dalam repositori Anda yang memiliki nama repositori Anda. Misalnya, untuk repositori Git, gunakan:

/azrepos subscribe https://dev.azure.com/myorg/myproject/_git/myrepository

Untuk repositori TFVC, gunakan:

/azrepos subscribe https://dev.azure.com/myorg/myproject/_versionControl

Catatan

Anda hanya dapat berlangganan repositori publik.

Perintah berlangganan membuat Anda mulai dengan langganan default. Untuk repositori Git, saluran berlangganan peristiwa yang dibuat permintaan Pull (dengan cabang target = utama), dan untuk repositori TFVC, saluran berlangganan Kode yang dicentang.

Cuplikan layar memperlihatkan Pesan pembuatan langganan default.

Kelola langganan

Untuk melihat, menambahkan, atau menghapus langganan untuk saluran, gunakan perintah berikut subscriptions :

/azrepos subscriptions

Perintah ini mencantumkan semua langganan saat ini untuk saluran dan memungkinkan Anda menambahkan langganan baru atau menghapus langganan yang sudah ada. Saat menambahkan langganan, Anda bisa mengkustomisasi pemberitahuan yang Anda dapatkan dengan menggunakan berbagai filter, seperti yang dijelaskan di bagian berikut.

Catatan

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

Cuplikan layar memperlihatkan Tampilan daftar langganan.

Menggunakan filter untuk mengkustomisasi langganan

Saat pengguna berlangganan repositori menggunakan /azrepos subscribe perintah , langganan default akan dibuat. Seringkali, pengguna perlu menyesuaikan langganan ini. Misalnya, pengguna mungkin ingin mendapatkan pemberitahuan hanya ketika PR memiliki peninjau tertentu.

Langkah-langkah berikut menunjukkan cara mengkustomisasi langganan.

  1. Jalankan perintah /azrepos subscriptions.
  2. Dalam daftar langganan, jika ada langganan yang tidak diinginkan atau harus dimodifikasi (Contoh: membuat kebisingan di saluran), pilih tombol Hapus .
  3. Pilih tombol Tambahkan langganan .
  4. Pilih repositori yang diperlukan dan peristiwa yang diinginkan.
  5. Pilih filter yang sesuai.

Contoh: Dapatkan pemberitahuan hanya ketika tim saya berada dalam daftar peninjau untuk PR

Cuplikan layar memperlihatkan Peninjau memiliki tim saya.

Contoh: Beri tahu saya saat upaya penggabungan gagal karena pelanggaran kebijakan

Cuplikan layar memperlihatkan Upaya penggabungan tidak berhasil – karena pelanggaran kebijakan.

Catatan

  • Semua filter biasanya drop-down. Tetapi jika drop-down memiliki lebih dari 100 item, maka pengguna harus memasukkan nilai secara manual.
  • Untuk Kode TFVC Yang Diperiksa jika terjadi, filter Di bawah jalur harus dari format $/myproject/path.

Pratinjau URL permintaan penarikan

Saat pengguna menempelkan URL PR, tampilan pratinjau seperti gambar berikut, yang membantu menjaga agar percakapan terkait PR tetap kontekstual dan akurat.

Cuplikan layar memperlihatkan URL yang tidak berfungsi.

Setelah pengguna masuk, fitur ini berfungsi untuk semua saluran di ruang kerja.

Menghapus langganan dan repositori dari saluran

Gunakan perintah berikut untuk membersihkan saluran Anda dengan menghapus repositori dan langganan.

/azrepos unsubscribe all [project url]

Misalnya, perintah berikut menghapus semua langganan yang terkait dengan repositori apa pun dalam proyek dan menghapus repositori dari saluran. Hanya admin proyek yang dapat menjalankan perintah ini.

/azrepos unsubscribe all https://dev.azure.com/myorg/myproject

Referensi perintah

Tabel berikut mencantumkan semua yang /azrepos commands bisa Anda gunakan di saluran Slack Anda.

Perintah garis miring Fungsi
/azrepos berlangganan [url repositori/ url proyek] Berlangganan ke repositori atau semua repositori dalam proyek untuk pemberitahuan
Langganan /azrepos Menambahkan atau menghapus langganan untuk saluran ini
/azrepos signin Masuk ke organisasi Azure Repos Anda
/azrepos signout Keluar dari organisasi Azure Repos Anda
Umpan balik /azrepos Melaporkan masalah atau menyarankan fitur
/azrepos berhenti berlangganan semua [url proyek] Menghapus semua repositori (milik proyek) dan langganan terkait dari saluran

Pemberitahuan di saluran privat

Aplikasi Azure Repos juga dapat membantu Anda memantau peristiwa repositori di saluran privat Anda. Undang bot ke saluran privat Anda dengan menggunakan /invite @azrepos. Kemudian, Anda dapat mengelola pemberitahuan dengan cara yang sama seperti yang Anda lakukan untuk saluran publik.

Pecahkan masalah

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

Maaf, terjadi kesalahan. Harap coba lagi.

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

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 menggunakan https://aka.ms/VsSignout browser Anda.

Buka jendela browser Dalam privat atau penyamaran dan navigasikan 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, mulai tab baru, navigasi ke https://slack.com, dan masuk ke ruang kerja Anda (gunakan klien web). Jalankan /azrepos signout perintah diikuti oleh /azrepos signin perintah .

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

Cuplikan layar memperlihatkan Persetujuan untuk izin aplikasi yang diminta.

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