Gunakan Azure Event Grid untuk merutekan kejadian penyimpanan Blob ke titik akhir web (portal Azure)

  • Artikel

Event Grid adalah layanan terkelola penuh yang memungkinkan Anda mengelola kejadian dengan mudah di berbagai layanan dan aplikasi Azure. Event Grid menyederhanakan pembangunan aplikasi berbasis kejadian dan nirserver. Untuk gambaran umum layanan tersebut, lihat Gambaran umum Event Grid.

Dalam artikel ini, Anda menggunakan portal Azure untuk melakukan tugas berikut:

  1. Membuat akun penyimpanan blob.
  2. Berlangganan ke kejadian untuk penyimpanan blob tersebut.
  3. Memicu kejadian dengan mengunggah file ke penyimpanan blob.
  4. Melihat hasilnya di aplikasi web pemroses. Biasanya, Anda mengirim peristiwa ke titik akhir yang memproses data peristiwa dan mengambil tindakan. Sederhananya, Anda mengirim kejadian ke aplikasi web yang mengumpulkan dan menampilkan pesan.

Jika Anda tidak memiliki Langganan Azure, buat Akun gratis Azure sebelum memulai.

Setelah selesai, Anda akan melihat bahwa data peristiwa telah dikirim ke aplikasi web.

Screenshot that shows the sample Azure Event Grid Viewer app with an event.

Buat akun penyimpanan

  1. Masuk ke portal Microsoft Azure.

  2. Untuk membuat penyimpanan Blob, pilih Buat sumber daya.

  3. Di bidang Cari, masukkan Akun penyimpanan, dan pilih Akun penyimpanan dari daftar hasil.

    Screenshot showing the search for Storage account on the Create a resource page.

  4. Pada halaman Akun penyimpanan, pilih Buat untuk mulai membuat akun penyimpanan. Untuk berlangganan peristiwa, buat akun penyimpanan v2 tujuan umum atau akun penyimpanan Blob.

  5. Pada halaman Buat akun penyimpanan, lakukan langkah-langkah berikut ini:

    1. Pilih langganan Azure Anda.

    2. Untuk Grup sumber daya, buat grup sumber daya baru atau pilih yang sudah ada.

    3. Masukkan nama untuk akun penyimpanan Anda.

    4. Pilih Wilayah tempat Anda ingin membuat akun penyimpanan.

    5. Untuk Redundansi, pilih Penyimpanan menurut lokasi (LRS) dari daftar menurun.

    6. Pilih Tinjau di bagian bawah halaman.

      Screenshot showing the Create a storage account page.

    7. Pada halaman Tinjau , tinjau pengaturan, dan pilih Buat.

      Catatan

      Hanya akun penyimpanan jenis StorageV2 (tujuan umum v2) dan BlobStorage yang mendukung integrasi peristiwa. Storage (tujuan umum v1)tidak mendukung integrasi dengan Event Grid.

  6. Penyebaran ini membutuhkan waktu beberapa menit untuk diselesaikan. Pada halaman Penyebaran , pilih Buka sumber daya.

    Screenshot showing the deployment succeeded page with a link to go to the resource.

  7. Pada halaman Akun penyimpanan, pilih Peristiwa di menu sebelah kiri.

    Screenshot showing the Events page for an Azure storage account.

  8. Biarkan halaman ini tetap terbuka di browser web.

Buat titik akhir pesan

Sebelum berlangganan peristiwa untuk penyimpanan Blob, mari kita buat titik akhir untuk pesan peristiwa. Biasanya, titik akhir mengambil tindakan berdasarkan data kejadian. Untuk menyederhanakan mulai cepat ini, Anda menyebarkan aplikasi web bawaan yang menampilkan pesan peristiwa. Solusi yang disebarkan mencakup rencana App Service, aplikasi web App Service, dan kode sumber dari GitHub.

  1. Pilih Sebarkan ke Azure untuk menyebarkan solusi ke langganan Anda.

    Button to deploy the Resource Manager template to Azure.

  2. Pada halaman Penyebaran kustom, lakukan langkah-langkah berikut ini:

    1. Untuk grup Sumber Daya, pilih grup sumber daya yang Anda buat saat membuat akun penyimpanan. Akan lebih mudah bagi Anda untuk membersihkan setelah Anda selesai dengan tutorial dengan menghapus grup sumber daya.

    2. Untuk Nama Situs, masukkan nama untuk aplikasi web.

    3. Untuk Nama paket hosting, masukkan nama untuk paket App Service yang akan digunakan untuk menghosting aplikasi web.

    4. Pilih Tinjau + buat.

      Screenshot showing the Custom deployment page.

  3. Pada halaman Tinjau + buat, pilih Buat.

  4. Penyebaran ini membutuhkan waktu beberapa menit untuk diselesaikan. Pada halaman Penyebaran , pilih Buka grup sumber daya.

    Screenshot showing the deployment succeeded page with a link to go to the resource group.

  5. Pada halaman Grup sumber daya, di daftar sumber daya, pilih aplikasi web yang Anda buat. Anda juga melihat paket App Service dan akun penyimpanan dalam daftar ini.

    Screenshot that shows the selection of web app in the resource group.

  6. Pada halaman App Service untuk aplikasi web Anda, pilih URL untuk menavigasi ke situs web. URL harus dalam format ini: https://<your-site-name>.azurewebsites.net.

    Screenshot that shows the selection of link to navigate to web app.

  7. Konfirmasikan bahwa Anda melihat situs tetapi belum ada peristiwa yang diposting ke situs tersebut.

    View new site.

    Penting

    Biarkan jendela Penampil Azure Event Grid terbuka sehingga Anda dapat melihat peristiwa saat diposting.

Mendaftarkan penyedia sumber Event Grid

Kecuali jika Event Grid telah digunakan sebelumnya, Anda harus mendaftarkan penyedia sumber daya Event Grid. Jika Anda pernah menggunakan Event Grid sebelumnya, lewati ke bagian berikutnya.

Di portal Azure, lakukan langkah-langkah berikut:

  1. Di menu sebelah kiri, pilih Langganan.

  2. Pilih langganan yang ingin Anda gunakan untuk Event Grid dari daftar langganan.

  3. Pada halaman Langganan, pilih Penyedia sumber pada bagian Pengaturan di menu sebelah kiri.

  4. Cari Microsoft.EventGrid, dan konfirmasikan bahwa StatusTidak Terdaftar.

  5. Pilih Microsoft.EventGrid dalam daftar penyedia.

  6. Pilih Daftar pada bilah perintah.

    Image showing the registration of Microsoft.EventGrid provider with the Azure subscription.

  7. Refresh untuk memastikan status Microsoft.EventGrid diubah menjadi Terdaftar.

    Image showing the successful registration of Microsoft.EventGrid provider with the Azure subscription.

Berlangganan ke penyimpanan Blob

Anda berlangganan topik untuk memberi tahu Event Grid peristiwa mana yang ingin Anda lacak dan tempat mengirim peristiwa tersebut.

  1. Jika Anda menutup halaman Akun penyimpanan, navigasikan ke akun Azure Storage yang Anda buat sebelumnya. Di menu sebelah kiri, pilih Semua sumber daya dan pilih akun penyimpanan Anda.

  2. Pada halaman Akun penyimpanan, pilih Peristiwa di menu sebelah kiri.

  3. Pilih Opsi Lainnya, dan WebHook. Anda mengirim peristiwa ke aplikasi penampil menggunakan web hook untuk titik akhir.

    Screenshot showing the selection of Web Hook on the Events page.

  4. Pada halaman Buat Langganan Peristiwa, lakukan langkah-langkah berikut ini:

    1. Masukkan nama untuk langganan acara.

    2. Masukkan nama untuk topik sistem. Untuk mempelajari tentang topik sistem, lihatGambaran umum topik sistem.

      Screenshot showing the Create Event Subscription page with a name for the system topic.

    3. Pilih WebHook untuk Jenis titik akhir.

      Screenshot showing the Create Event Subscription page with Web Hook selected as an endpoint.

  5. Untuk Titik Akhir, pilih Pilih titik akhir, dan masukkan URL aplikasi web Anda dan tambahkan api/updates ke URL halaman beranda (misalnya: https://spegridsite.azurewebsites.net/api/updates), lalu pilih Konfirmasi Pilihan.

    Screenshot showing the Select Web Hook page.

  6. Sekarang, pada halaman Buat Langganan Peristiwa, pilih Buat untuk membuat langganan peristiwa.

    Screenshot showing the Create Event Subscription page with all fields selected.

  7. Lihat lagi aplikasi web Anda, dan perhatikan bahwa peristiwa validasi langganan telah dikirim ke sana. Pilih ikon mata untuk meluaskan data peristiwa. Event Grid mengirimkan peristiwa validasi sehingga titik akhir dapat memverifikasi bahwa ia ingin menerima data peristiwa. Aplikasi web menyertakan kode untuk memvalidasi langganan.

    Screenshot showing the Event Grid Viewer with the subscription validation event.

Sekarang, mari kita picu kejadian untuk melihat cara Event Grid mendistribusikan pesan ke titik akhir Anda.

Mengirim peristiwa ke titik akhir Anda

Anda memicu peristiwa untuk penyimpanan Blob dengan mengunggah file. File tidak memerlukan konten tertentu.

  1. Di portal Azure, navigasikan ke akun penyimpanan Blob Anda, dan pilih Kontainer di halaman menu.

  2. Pilih +Kontainer. Beri nama kontainer, dan gunakan tingkat akses apa pun, lalu pilih Buat.

    Screenshot showing the New container page.

  3. Memilih kontainer baru Anda.

    Screenshot showing the selection of the container.

  4. Untuk mengunggah file, pilih Unggah. Pada halaman Unggah blob, telusuri dan pilih file yang ingin Anda unggah untuk pengujian, lalu pilih Unggah di halaman tersebut.

    Screenshot showing Upload blob page.

  5. Telusuri ke file pengujian Anda dan unggah.

  6. Anda telah memicu kejadian, dan Event Grid mengirim pesan ke titik akhir yang Anda konfigurasi saat berlangganan. Pesan tersebut menggunakan format JSON dan berisi array dengan satu atau beberapa peristiwa. Dalam contoh berikut, pesan JSON berisi array dengan satu peristiwa. Lihat aplikasi web Anda dan perhatikan bahwa peristiwa yang dibuat blob diterima.

    Screenshot showing the Event Grid Viewer page with the Blob Created event.

Membersihkan sumber daya

Jika Anda berencana untuk terus bekerja dengan peristiwa ini, jangan bersihkan sumber daya yang dibuat di artikel ini. Jika tidak, hapus sumber daya yang Anda buat di artikel ini.

Pilih grup sumber daya, dan pilih Hapus grup sumber daya.

Langkah berikutnya

Setelah Anda mengetahui cara membuat topik kustom dan langganan peristiwa, pelajari lebih lanjut tentang apa yang Event Grid bisa bantu Anda lakukan: