Tutorial: Merutekan pesan MQTT di Azure Event Grid ke Azure Functions menggunakan topik kustom - portal Microsoft Azure

Dalam tutorial ini, Anda merutekan pesan MQTT yang diterima oleh namespace Azure Event Grid ke fungsi Azure dengan menggunakan topik kustom Event Grid.

Jika Anda tidak memiliki langganan Azure, Anda dapat mendaftar untuk uji coba gratis .

Membuat fungsi Azure menggunakan pemicu Event Grid

Ikuti instruksi dari Membuat fungsi Azure menggunakan Visual Studio Code, tetapi gunakan Pemicu Azure Event Grid alih-alih menggunakan Pemicu HTTP.

Penting

Buat semua sumber daya di wilayah yang sama.

Anda akan melihat kode yang mirip dengan contoh berikut:

using System;
using Azure.Messaging;
using Microsoft.Azure.Functions.Worker;
using Microsoft.Extensions.Logging;

namespace Company.Function
{
    public class MyEventGridTriggerFunc
    {
        private readonly ILogger<MyEventGridTriggerFunc> _logger;

        public MyEventGridTriggerFunc(ILogger<MyEventGridTriggerFunc> logger)
        {
            _logger = logger;
        }

        [Function(nameof(MyEventGridTriggerFunc))]
        public void Run([EventGridTrigger] CloudEvent cloudEvent)
        {
            _logger.LogInformation("Event type: {type}, Event subject: {subject}", cloudEvent.Type, cloudEvent.Subject);
        }
    }
}

Anda menggunakan fungsi Azure ini sebagai penanganan aktivitas untuk langganan topik nanti dalam tutorial ini.

Nota

Tutorial ini telah diuji dengan fungsi Azure yang menggunakan tumpukan runtime .NET 8.0 (terisolasi).

Membuat topik Event Grid (topik kustom)

Membuat topik Event Grid. Lihat Membuat topik kustom menggunakan portal Microsoft Azure. Saat Anda membuat topik Event Grid, pada tab Tingkat Lanjut , untuk Skema Peristiwa, pilih Cloud Event Schema v1.0.

Nota

Gunakan Cloud Event Schema v1.0 di mana-mana dalam tutorial ini.

Menambahkan langganan ke topik menggunakan fungsi

Dalam langkah ini, buat langganan ke topik Event Grid menggunakan fungsi Azure yang Anda buat sebelumnya.

1. Pada halaman Topik Event Grid , pilih Langganan.

   

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

   1. Masukkan Nama untuk langganan peristiwa.

   2. Untuk Skema Peristiwa, pilih Skema Peristiwa Cloud 1.0.

   3. Untuk Jenis Titik Akhir, Pilih Azure Function.

   4. Lalu, pilih Konfigurasikan titik akhir.

      

3. Pada halaman Pilih fungsi Azure , lakukan langkah-langkah berikut:

   1. Untuk Langganan, pilih langganan Azure Anda.

   2. Untuk Grup sumber daya, pilih grup sumber daya yang memiliki fungsi Azure Anda.

   3. Untuk Aplikasi fungsi, pilih aplikasi Functions yang memiliki fungsi .

   4. Untuk Slot, pilih Produksi.

   5. Untuk Fungsi, pilih Azure Function Anda.

   6. Lalu, pilih Konfirmasi Pilihan.

      

4. Pada halaman Buat Langganan Peristiwa , pilih Buat.

5. Pada halaman Langganan Peristiwa , Anda akan melihat langganan yang Anda buat.

Membuat namespace, klien, ruang topik, dan pengikatan izin

Ikuti instruksi dari Mulai Cepat: Menerbitkan dan berlangganan pesan MQTT menggunakan namespace Layanan Event Grid dengan portal Microsoft Azure untuk:

1. Buat namespace Event Grid.
2. Buat dua klien.
3. Membuat ruang topik.
4. Membuat pengikatan izin penerbit dan pelanggan.
5. Uji menggunakan aplikasi MQTTX untuk mengonfirmasi bahwa klien dapat mengirim dan menerima pesan.

Mengaktifkan identitas terkelola untuk namespace

Di bagian ini, Anda mengaktifkan identitas terkelola yang ditetapkan oleh sistem untuk namespace Event Grid. Kemudian, berikan identitas izin kirim ke topik kustom Event Grid. Kemudian dapat merutekan pesan ke topik kustom. Anda mengaktifkannya dengan menambahkan identitas terkelola ke peran Pengirim Data Event Grid pada topik kustom.

1. Pada halaman Event Grid Namespace, pilih Identitas. Pilih Aktif lalu Simpan.

   

2. Navigasi ke Topik Event Grid untuk topik kustom Event Grid Anda.

3. Pilih Kontrol akses di bilah navigasi kiri.

4. Pada halaman Kontrol akses , pilih Tambahkan, lalu pilih Tambahkan penetapan peran.

   

5. Pada halaman Peran wizard Tambahkan penetapan peran , pilih peran Pengirim Data Event Grid , dan pilih Berikutnya.

   

6. Pada Tambahkan penetapan peran, pada halaman Anggota , pilih Identitas terkelola, lalu pilih Pilih anggota.

   

7. Pada halaman Pilih identitas terkelola , lakukan langkah-langkah berikut:

   1. Pilih langganan Azure Anda.

   2. Untuk Identitas terkelola, pilih Namespace Layanan Event Grid.

   3. Pilih identitas terkelola yang memiliki nama yang sama dengan namespace Layanan Event Grid.

   4. Pilih Pilih.

      

8. Pada halaman Tambahkan penetapan peran , pilih Berikutnya.

9. Pada halaman Tinjau + tetapkan, tinjau pengaturan, lalu pilih Tinjau + tetapkan.

Mengonfigurasi pesan perutean ke fungsi Azure melalui topik kustom

Di bagian ini, konfigurasikan perutean untuk namespace Layanan Event Grid sehingga pesan yang diterimanya dirutekan ke topik kustom buatan Anda.

1. Pada halaman Namespace Event Grid, pilih Perutean.

2. Pada halaman Perutean , pilih Aktifkan perutean.

3. Untuk Jenis topik, pilih Topik kustom.

4. Untuk Topik, pilih topik kustom yang Anda buat untuk tutorial ini.

5. Untuk Identitas terkelola untuk pengiriman, pilih Sistem Ditetapkan.

6. Pilih Terapkan.

   

Mengirim pesan MQTT pengujian menggunakan MQTTX

Kirim pesan MQTT uji ke namespace dan pastikan bahwa fungsi menerimanya.

Ikuti instruksi dari Terbitkan dan berlangganan menggunakan aplikasi MQTTX untuk mengirim beberapa pesan pengujian ke namespace Layanan Event Grid.

Berikut adalah alur peristiwa atau pesan:

1. MQTTX mengirim pesan ke ruang topik ruang nama Event Grid.

2. Pesan dirutekan ke topik kustom yang Anda konfigurasikan.

3. Pesan diteruskan ke langganan acara, yang merupakan fungsi Azure.

4. Gunakan fitur pengelogan untuk memverifikasi bahwa fungsi menerima peristiwa.

   

Langkah selanjutnya

Sampel dalam MqttApplicationSamples.