Bagikan melalui


Mengintegrasikan dengan kait layanan

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

Service Hooks memungkinkan Anda menjalankan tugas di layanan lain saat peristiwa terjadi di 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. Langganan dikelola melalui App Center.
AppVeyor Kode didorong Memicu build AppVeyor. Langganan dikelola melalui AppVeyor.
Azuqua Semua Posting acara ke FLO. Langganan dikelola melalui Azuqua.
Azure App Service Kode didorong Menyebarkan aplikasi web. Langganan dikelola melalui Azure App Service.
Azure Service Bus Semua Kirim pesan ke Notification Hub, Bus Layanan Queue, atau Bus Layanan Topic. Langganan dikelola melalui Azure App Service.
Azure Storage Semua Sisipkan pesan dalam Antrean Penyimpanan.
Bambu Build selesai, Kode didorong Mengantrekan build.
Datadog Semua Memposting peristiwa di Datadog.
Grafana Penyebaran rilis selesai Tambahkan anotasi ke database Grafana.
Jenkins Build selesai, kode didorong, upaya penggabungan PR, penyebaran rilis selesai Memicu build generik atau Git.
Microsoft Teams Semua Memposting pesan ke saluran. Langganan dikelola di Microsoft Teams.
MyGet Build selesai, kode didorong Terbitkan paket NuGet ke MyGet. Memicu build MyGet. Langganan dikelola oleh MyGet.
Office 365 Semua Memposting pesan ke grup.
Slack Semua Memposting pesan ke saluran.
Trello Semua Buat kartu atau daftar.
UserVoice Item kerja dibuat, item kerja diperbarui Mengirim peristiwa item kerja tertaut. Langganan dikelola melalui UserVoice.
Web Hook Semua Posting melalui HTTP.
Aplikasi Pesan Tempat Kerja Semua Kirim pemberitahuan. Langganan dikelola melalui Aplikasi Pesan Tempat Kerja.
Zapier Semua Kirim pemberitahuan. Langganan dikelola melalui Zapier.
Zendesk Item kerja dikomentari Buat komentar privat dalam tiket.
Layanan Peristiwa yang didukung Tindakan yang didukung
Azure Service Bus Semua Kirim pesan ke Notification Hub, Bus Layanan Queue, atau Bus Layanan Topic. Langganan dikelola melalui Azure App Service.
Azure Storage Semua Sisipkan pesan dalam Antrean Penyimpanan.
Bambu Build selesai, Kode didorong Mengantrekan build.
Datadog Semua Memposting peristiwa di Datadog.
Grafana Penyebaran rilis selesai Tambahkan anotasi ke database Grafana.
Jenkins Build selesai, kode didorong, upaya penggabungan PR, penyebaran rilis selesai Memicu build generik atau Git.
Microsoft Teams Semua Memposting pesan ke saluran. Langganan dikelola di Microsoft Teams.
Office 365 Semua Memposting pesan ke grup.
Slack Semua Memposting pesan ke saluran.
Trello Semua Buat kartu atau daftar.
[UserVoice] ((https://www.uservoice.com) Item kerja dibuat, item kerja diperbarui Mengirim peristiwa item kerja tertaut. Langganan dikelola melalui UserVoice.
Web Hook Semua Posting melalui HTTP.
Zendesk Item kerja dikomentari Buat 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 konfigurasi di layanan lain. Untuk detail spesifik, lihat informasi untuk 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 .

Untuk memberikan izin Tampilan untuk grup, lihat Mengatur izin Tampilan untuk grup di halaman Service Hooks .

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 izinnya untuk diakses, langganan tidak akan dipicu.

Misalnya: Langganan yang Anda buat untuk peristiwa pembaruan item kerja di jalur area XYZ tidak akan mengirim pemberitahuan jika Anda tidak memiliki akses ke item kerja tersebut. Namun, Anda dapat melihat riwayat pemberitahuan pengguna lain yang memang memiliki akses ke item kerja tersebut.

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. Untuk informasi selengkapnya, lihat pengumuman.