Mengintegrasikan dengan kait layanan

Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

Service hook memungkinkan Anda menjalankan tugas pada layanan lain saat peristiwa terjadi dalam proyek Anda di Azure DevOps.

Misalnya, Anda dapat membuat kartu di Trello saat item kerja dibuat atau mengirim pemberitahuan push ke perangkat seluler tim Anda saat build gagal. Anda juga dapat menggunakan kait layanan di aplikasi dan layanan kustom sebagai cara yang lebih efisien untuk mendorong aktivitas saat peristiwa terjadi di proyek Anda.

Bagaimana cara kerja kait layanan?

Penerbit hook layanan menentukan serangkaian peristiwa yang dapat Anda berlangganan. Langganan mendengarkan peristiwa ini dan menentukan tindakan yang akan diambil berdasarkan peristiwa tersebut.

Langganan juga menargetkan konsumen, yang merupakan layanan eksternal yang dapat menjalankan tindakan mereka sendiri saat peristiwa terjadi.

Diagram kait layanan.

Catatan

Kait layanan memerlukan izin rentang IP untuk koneksi masuk ke titik akhir layanan. Titik akhir layanan adalah sekumpulan properti yang disediakan untuk kait layanan. Untuk informasi selengkapnya, lihat Daftar alamat yang diizinkan dan koneksi jaringan, alamat IP, dan pembatasan rentang.

Layanan yang tersedia

Layanan berikut tersedia sebagai target kait layanan. Untuk informasi selengkapnya tentang aplikasi dan layanan lain yang terintegrasi dengan Azure DevOps, buka Visual Studio Marketplace.

Layanan Peristiwa yang didukung Tindakan yang didukung
Pusat Aplikasi Item kerja diperbarui Kirim pemberitahuan
AppVeyor Kode didorong Memicu build AppVeyor
Azuqua Semua Memposting acara ke FLO
Azure App Service Kode didorong Menyebarkan aplikasi web
Azure Service Bus Semua Mengirim pesan ke Notification Hub, Bus Layanan Queue, atau Bus Layanan Topic
Azure Storage Semua Menyisipkan pesan dalam Antrean Penyimpanan
Bambu Build selesai, Kode didorong Mengantrekan build
Api unggun Semua Memposting pesan ke ruangan
Datadog Semua Memposting peristiwa di Datadog
Grafana Penyebaran rilis selesai Menambahkan anotasi ke database Grafana
HipChat (Tidak lagi didukung)
HockeyApp Item kerja diperbarui Kirim pemberitahuan
Jenkins Build selesai, kode didorong, upaya penggabungan PR, penyebaran rilis selesai Memicu build generik atau Git
Microsoft Teams Semua Memposting pesan ke saluran
MyGet Build selesai, kode didorong Terbitkan paket NuGet ke MyGet, picu build MyGet
Office 365 Semua Memposting pesan ke grup
Slack Semua Memposting pesan ke saluran
Trello Semua Membuat kartu atau daftar
UserVoice Item kerja dibuat atau diperbarui Mengirim peristiwa item kerja tertaut
Web Hook Semua Posting melalui HTTP
Aplikasi Pesan Tempat Kerja Semua Mengirim pemberitahuan
Zapier Semua Kirim pemberitahuan
Zendesk Item kerja dikomentari Membuat komentar privat dalam tiket

Buat langganan

Saat mengintegrasikan salah satu layanan ini dengan Azure DevOps, Anda harus membuat langganan baru. Dalam banyak kasus, Anda juga perlu melakukan beberapa pekerjaan di layanan lain. Untuk detail spesifik, lihat informasi tentang layanan yang Anda minati.

  1. Buka halaman admin untuk proyek di akses web.

    Cuplikan layar tombol pengaturan Proyek yang disorot.
  2. Jalankan wizard untuk membuat langganan.

    Cuplikan layar tombol yang disorot, Buat langganan.

  3. Pilih layanan yang ingin Anda integrasikan.

    Pilih layanan yang akan diintegrasikan

  4. Pilih peristiwa yang akan dipicu dan filter apa pun yang berlaku.

    Pilih peristiwa yang akan dipicu dan filter apa pun

  5. Pilih tindakan untuk dijalankan pada layanan target.

    Catatan

    Daftar tindakan yang tersedia mungkin dibatasi berdasarkan jenis peristiwa yang Anda pilih.

    Cuplikan layar memperlihatkan pemilihan tindakan untuk layanan target.

  6. Untuk mengonfirmasi bahwa pengaturan sudah benar, uji langganan lalu selesaikan wizard.

    Cuplikan layar memperlihatkan pemberitahuan pengujian 1.

    Cuplikan layar memperlihatkan pemberitahuan pengujian 2.

Tanya Jawab Umum

T: Izin apa yang saya perlukan untuk menyiapkan langganan?

A: Edit langganan dan Lihat langganan. Secara default, hanya administrator proyek yang akan memiliki izin ini. Untuk memberikannya kepada pengguna lain secara langsung, Anda dapat menggunakan alat baris perintah ataupun REST API Keamanan .

T: Apa implikasi keamanan dari pemberian izin Edit langganan dan Lihat langganan ?

A: Pengguna dengan izin ini dapat melihat semua langganan yang dibuat dalam proyek dan riwayat pemberitahuan untuk langganan tersebut. Pengguna tersebut kemudian dapat membuat semua jenis langganan kait layanan dalam proyek tersebut. Jika pengguna menyiapkan langganan untuk sumber daya yang tidak mereka miliki izin untuk mengaksesnya, langganan tidak akan dipicu.

Misalnya: Jika Anda tidak memiliki akses ke item kerja di jalur area XYZ, dan Anda menyiapkan langganan ke peristiwa pembaruan item kerja, Anda tidak mendapatkan pemberitahuan untuk pembaruan untuk item kerja di jalur area XYZ. Tetapi, jika pengguna lain, yang memang memiliki akses ke item kerja di jalur area XYZ, menerima peristiwa "pembaruan item kerja", maka Anda dapat melihat riwayat pemberitahuan peristiwa pengguna lain, yang mencakup data item kerja yang tidak dapat Anda akses.

T: Bisakah saya membuat langganan hook layanan untuk proyek secara terprogram?

J: Ya. Untuk informasi selengkapnya, lihat Membuat langganan hook layanan.

T: Dapatkah saya menghapus akses aplikasi ke organisasi saya setelah saya mengizinkannya?

J: Ya. Anda dapat mencabut otorisasi dari profil Anda.

  1. Buka halaman profil Anda dari https://visualstudio.microsoft.com/.

    Pastikan Anda memulai dari situs Visual Studio (https://visualstudio.microsoft.com/) alih-alih organisasi Anda (https://dev.azure.com/{orgName}) karena profil Anda diakses dari organisasi Anda membawa Anda ke implementasi fitur manajemen otorisasi yang salah.

  2. Mengelola otorisasi Anda.

    Cuplikan layar memperlihatkan tombol Kelola aplikasi yang disorot.

  3. Cabut otorisasi apa pun yang tidak ingin Anda izinkan lagi.

    Cuplikan layar memperlihatkan opsi Cabut untuk otorisasi.

T: Mengapa kami tidak dapat menyiapkan kait layanan untuk HipChat lagi?

A: Atlassian secara resmi menjatuhkan dukungan untuk HipChat. Lihat selengkapnya tentang pengumuman itu di sini.