Bagikan melalui


Azure Repos dengan Slack

Layanan 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 acara Git dan Team Foundation Version Control (TFVC).

Prasyarat

Nota

  • 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. Gunakan tanda Slack /azrepos untuk berinteraksi dengan aplikasi. Daftar lengkap perintah disediakan di bagian Referensi Perintah di artikel ini.

Menyambungkan aplikasi Azure Repos ke repositori Anda

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

    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 masuk ditampilkan 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). Misalnya:

/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

Nota

Anda hanya dapat berlangganan repositori publik.

Perintah berlangganan membuat Anda mulai dengan langganan default. Untuk repositori Git, saluran berlangganan pada peristiwa Pull request yang dibuat (dengan cabang target = main), dan untuk repositori TFVC, saluran berlangganan pada peristiwa Kode yang dimasukkan .

Cuplikan layar memperlihatkan Pesan pembuatan langganan default.

Mengelola langganan

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

/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.

Nota

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 perintah /azrepos subscribe, 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 bahwa tim saya berada di bawah pengawasan Peninjau.

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

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

Nota

  • Semua filter biasanya berbentuk menu pilihan. Tetapi jika drop-down memiliki lebih dari 100 item, maka pengguna harus memasukkan nilai secara manual.
  • Untuk acara TFVC Code Checked in, filter dengan jalur harus dalam 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 pemunculan URL.

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 /azrepos commands yang bisa Anda gunakan di saluran Slack Anda.

Perintah Slash Fungsionalitas
/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 membatalkan langganan 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.

Mengatasi masalah

Jika Anda mengalami kesalahan berikut saat menggunakan Azure Repos App for Slack, 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 sama, mulai tab baru, navigasikan ke https://slack.com, dan masuk ke ruang kerja Anda (menggunakan klien web). Jalankan perintah /azrepos signout diikuti oleh perintah /azrepos signin.

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.

Cuplikan layar memperlihatkan Persetujuan untuk izin aplikasi yang diminta.

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