Azure Repos dengan Slack
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
Buka aplikasi Azure Repos Slack dan pilih Tambahkan ke Slack.
Setelah ditambahkan, Anda menerima sesuatu seperti pesan selamat datang berikut.
/azreposGunakan handel Slack untuk berinteraksi dengan aplikasi. Daftar lengkap perintah disediakan di bagian Referensi perintah di artikel ini.
Koneksi aplikasi Azure Repos ke repositori Anda
Koneksi dan autentikasi diri Anda ke Azure Repos menggunakan
/azrepos signinperintah.
Pilih Masuk.
Terima Integrasi Azure Repos Slack.
Kode verifikasi ditampilkan untuk digunakan di aplikasi obrolan Anda untuk menyelesaikan autentikasi.
Salin kode autentikasi.
Pilih Masukkan kode, tempelkan kode, lalu pilih Kirim.
Konfirmasi tampilan 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.
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.
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.
- Jalankan perintah
/azrepos subscriptions. - Dalam daftar langganan, jika ada langganan yang tidak diinginkan atau harus dimodifikasi (Contoh: membuat kebisingan di saluran), pilih tombol Hapus .
- Pilih tombol Tambahkan langganan .
- Pilih repositori yang diperlukan dan peristiwa yang diinginkan.
- Pilih filter yang sesuai.
Contoh: Dapatkan pemberitahuan hanya ketika tim saya berada dalam daftar peninjau untuk PR
Contoh: Beri tahu saya saat upaya penggabungan gagal 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.
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.
- Konfigurasi gagal. Pastikan organisasi '{nama organisasi}' ada dan Anda memiliki izin yang memadai.
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.
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.
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.
Jika langkah-langkah ini tidak mengatasi masalah autentikasi Anda, hubungi kami di Komunitas Pengembang.