Mengintegrasikan dengan pengait layanan

Layanan Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Anda dapat menggunakan hook layanan untuk menjalankan tugas di layanan lain saat peristiwa terjadi di proyek Azure DevOps Anda.

Misalnya, Anda dapat menggunakan integrasi layanan untuk membuat kartu secara otomatis di Trello saat tugas dibuat di Azure DevOps. Atau Anda dapat secara otomatis 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 service hooks?

Hook layanan publishers mendefinisikan serangkaian peristiwa yang dapat Anda langgani. Langganan mendengarkan peristiwa ini dan menentukan tindakan yang akan diambil berdasarkan peristiwa.

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

Diagram dengan panah berlabel 'Event' dari kotak penerbit ke kotak langganan, dan panah dari kotak langganan ke kotak konsumen dan kotak tindakan.

Catatan

Untuk menggunakan kait layanan, Anda harus mengizinkan rentang alamat IP tertentu untuk koneksi masuk ke titik akhir layanan. Titik akhir layanan adalah sekumpulan properti yang disediakan untuk pengait layanan. Untuk informasi selengkapnya, lihat Alamat IP dan pembatasan rentang.

Layanan yang tersedia

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

Layanan Peristiwa yang didukung Tindakan yang didukung Manajemen langganan
Visual Studio App Center Item kerja diperbarui Mengirim pemberitahuan Di Pusat Aplikasi
AppVeyor Kode telah diunggah Memicu build AppVeyor Di AppVeyor
Azuqua Semua Mengirim acara ke objek bahasa alur (FLO) Di Azuqua
Azure App Service Kode telah diunggah Menyebarkan aplikasi web Dalam Layanan Aplikasi
Azure Service Bus Semua Mengirim pesan ke Azure Notification Hubs, antrean Bus Layanan, atau topik Bus Layanan Di Azure DevOps
Azure Storage Semua Menyisipkan pesan dalam antrean Penyimpanan Di Azure DevOps
Bambu Build selesai, kode diunggah Mengantrikan pembangunan Di Azure DevOps
Datadog Semua Memposting peristiwa di Datadog Di Azure DevOps
Grafana Proses penyebaran rilis telah selesai Menambahkan anotasi ke database Grafana Di Azure DevOps
Jenkins Build selesai, kode didorong, penggabungan PR dicoba Memicu proses build generik atau membangun menggunakan Git Di Azure DevOps
Microsoft Teams Semua Memposting pesan ke saluran Di dalam Teams
MyGet Build selesai, kode diunggah Publikasikan paket NuGet ke MyGet, memicu pembangunan MyGet Di MyGet
Office 365 Semua Mengirimkan pesan ke grup Dalam Office 365
Slack Semua Memposting pesan ke saluran Di Azure DevOps
Trello Semua Membuat kartu atau daftar Di Azure DevOps
UserVoice Item kerja dibuat, item kerja diperbarui Mengirimkan acara item kerja yang terhubung Di UserVoice
Webhook Semua Memposting permintaan melalui HTTP Di Azure DevOps
Aplikasi olahpesan tempat kerja Semua Mengirim pemberitahuan Dalam aplikasi pesan di tempat kerja
Zapier Semua Mengirim pemberitahuan Di Zapier
Zendesk Tugas telah dikomentari Membuat komentar privat dalam tiket Di Azure DevOps
Layanan Peristiwa yang didukung Tindakan yang didukung Manajemen langganan
Azure Service Bus Semua Mengirim pesan ke Azure Notification Hubs, antrean Bus Layanan, atau topik Bus Layanan Di Azure DevOps
Azure Storage Semua Menyisipkan pesan dalam antrean Penyimpanan Di Azure DevOps
Bambu Build selesai, kode diunggah Mengantrikan pembangunan Di Azure DevOps
Datadog Semua Memposting peristiwa di Datadog Di Azure DevOps
Grafana Proses penyebaran rilis telah selesai Menambahkan anotasi ke database Grafana Di Azure DevOps
Jenkins Build selesai, kode didorong, penggabungan PR dicoba Memicu proses build generik atau membangun menggunakan Git Di Azure DevOps
Microsoft Teams Semua Memposting pesan ke saluran Di Microsoft Teams
Office 365 Semua Mengirimkan pesan ke grup Dalam Office 365
Slack Semua Memposting pesan ke saluran Di Azure DevOps
Trello Semua Membuat kartu atau daftar Di Azure DevOps
UserVoice Item kerja dibuat, item kerja diperbarui Mengirimkan acara item kerja yang terhubung Di UserVoice
Webhook Semua Memposting permintaan melalui HTTP Di Azure DevOps
Zendesk Tugas telah dikomentari Membuat komentar privat dalam tiket Di Azure DevOps

Buat langganan

Untuk mengintegrasikan salah satu layanan ini dengan Azure DevOps, Anda membuat langganan. Dalam banyak kasus, Anda juga perlu mengonfigurasi layanan target. Untuk informasi terperinci, lihat dokumentasi untuk layanan yang ingin Anda integrasikan.

  1. Buka proyek Anda, pilih Pengaturan proyek, lalu pilih Hook layanan.

    Cuplikan layar yang memperlihatkan proyek Azure DevOps. Di sisi lain, Pengaturan proyek dan Kait layanan disorot.

  2. Pilih Buat langganan.

    Cuplikan layar halaman Service Hooks dari proyek Azure DevOps. Tombol Buat langganan disorot.

  3. Pilih layanan yang ingin Anda integrasikan.

    Cuplikan layar dialog Layanan. Banyak layanan terdaftar, Trello dipilih, dan deskripsi Trello terlihat.

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

    Cuplikan layar dialog Pemicu. Peristiwa Kode yang didorong dipilih. Filter diatur pada repositori dan grup.

  5. Pilih tindakan untuk dijalankan pada layanan target.

    Catatan

    Tindakan yang tersedia bergantung pada jenis peristiwa yang Anda pilih.

    Cuplikan layar dialog Tindakan. Buat kartu dipilih. Bidang tersedia untuk menentukan token, papan, dan pengaturan lainnya.

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

    Cuplikan layar jendela Pemberitahuan Pengujian. Di tab Ringkasan, pesan tentang pendorongan memperlihatkan status Berhasil.

    Cuplikan layar jendela Pemberitahuan Pengujian. Tab Permintaan memperlihatkan permintaan POST ke Trello dengan informasi tentang penerapan yang didorong.

Tanya Jawab Umum

T: Izin apa yang saya perlukan untuk menyiapkan langganan?

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

Untuk memberikan izin Lihat ke grup, lihat Setel izin Lihat untuk grup di service hooks.

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

A: Pengguna yang memiliki izin Edit langganan dan Lihat langganan dapat:

  • Lihat semua langganan dalam proyek.
  • Lihat riwayat pemberitahuan untuk semua langganan dalam proyek.
  • Buat semua jenis langganan hook layanan dalam proyek.

Jika pengguna menyiapkan langganan untuk sumber daya yang mereka tidak memiliki izin untuk mengaksesnya, langganan tersebut tidak akan diaktifkan.

Misalnya, Anda membuat langganan untuk mengirim pemberitahuan saat item kerja di jalur area tertentu diperbarui. Jika Anda tidak memiliki akses ke item kerja di jalur area tersebut, pemberitahuan tidak akan dikirim. Namun, jika pengguna lain memiliki akses ke item kerja, Anda dapat melihat riwayat pemberitahuan untuk langganan yang memperingatkan mereka tentang pembaruan.

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

J: Ya. Untuk informasi selengkapnya, lihat Membuat langganan pengait layanan melalui pemrograman.

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

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

  1. Pergi ke https://visualstudio.microsoft.com. Pilih foto profil Anda, lalu pilih profil Visual Studio.

    Pastikan Anda memulai dari situs Visual Studio, https://visualstudio.microsoft.com, saat Anda mengelola otorisasi. Dari situs tersebut, Anda dapat mengakses implementasi fitur manajemen otorisasi yang benar. Jangan mulai dari organisasi Anda (https://dev.azure.com/{organization-name}).

  2. Pilih Kelola otorisasi.

    Cuplikan layar halaman profil Visual Studio dengan informasi kontak untuk pengguna. Di bagian Otorisasi, Kelola aplikasi disorot.

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

    Cuplikan layar dialog Otorisasi. Daftar izin terlihat, dan tautan Cabut disorot.

Mengapa saya tidak dapat menyiapkan kait layanan untuk HipChat lagi?

A: Atlassian tidak lagi mendukung HipChat. Untuk informasi selengkapnya, lihat Tanya Jawab Umum Atlassian.