Menyebarkan modul Azure IoT Edge dari portal Microsoft Azure

Berlaku untuk: IoT Edge 1.5 IoT Edge 1.4

Penting

IoT Edge 1.5 LTS dan IoT Edge 1.4 LTS adalah rilis yang didukung. IoT Edge 1.4 LTS adalah akhir masa pakai pada 12 November 2024. Jika Anda menggunakan rilis sebelumnya, lihat Memperbarui IoT Edge.

Penting

Mulai 28 Agustus 2024, Marketplace Azure memperbarui model distribusi untuk modul IoT Edge. Mitra (penerbit modul) akan mulai menghosting modul IoT Edge mereka di registri kontainer milik penerbit. Gambar modul IoT Edge tidak akan tersedia untuk diunduh dari registri kontainer Marketplace Azure.

Hubungi penerbit modul IoT Edge untuk mendapatkan URI gambar kontainer yang diperbarui dan perbarui konfigurasi perangkat IoT Edge Anda dengan URI gambar baru yang disediakan oleh penerbit.

Perangkat IoT Edge yang tidak menggunakan modul mitra yang diperoleh dari Marketplace Azure tidak terpengaruh dan tidak ada tindakan yang diperlukan.

Setelah Anda membuat modul IoT Edge dengan logika bisnis Anda, Anda ingin menyebarkannya ke perangkat Anda untuk beroperasi di tepi. Jika Anda memiliki beberapa modul yang bekerja sama mengumpulkan dan memproses data, Anda dapat menyebarkan semuanya sekaligus dan menyatakan aturan perutean yang menghubungkannya.

Artikel ini memperlihatkan cara portal Microsoft Azure memandu Anda membuat manifes penyebaran dan mendorong penyebaran ke perangkat IoT Edge. Untuk informasi tentang membuat penyebaran yang menargetkan beberapa perangkat berdasarkan tag bersama mereka, lihat Menerapkan dan memantau modul IoT Edge dalam skala besar.

Prasyarat

• IoT Hub di langganan Azure Anda.

• Perangkat IoT Edge.

  Jika Anda tidak menyiapkan perangkat IoT Edge, Anda dapat membuatnya di komputer virtual Azure. Ikuti langkah-langkah di salah satu artikel mulai cepat untuk Membuat perangkat Linux virtual atau Membuat perangkat Windows virtual.

Mengonfigurasi manifes penerapan

Manifes penyebaran adalah dokumen JSON yang menjelaskan modul mana yang akan disebarkan, bagaimana data mengalir di antara modul, dan properti yang diinginkan dari modul twin. Untuk informasi selengkapnya tentang cara kerja manifes penyebaran dan cara membuatnya, lihat Memahami cara modul IoT Edge dapat digunakan, dikonfigurasi, dan digunakan kembali.

Portal Microsoft Azure memiliki wizard yang memandu Anda membuat manifes penyebaran, bukan membuat dokumen JSON secara manual. Wizard ini memiliki tiga langkah: Menambahkan modul, Menentukan rute, dan Meninjau penyebaran.

Catatan

Langkah-langkah dalam artikel ini mencerminkan versi skema terbaru dari agen dan hub IoT Edge. Skema versi 1.1 dirilis bersama dengan IoT Edge versi 1.0.10, dan memungkinkan pesanan startup modul dan fitur prioritas rute.

Jika Anda menyebarkan ke perangkat yang menjalankan versi 1.0.9 atau versi yang lebih lama, edit Pengaturan Runtimedi langkah Modul wizard untuk menggunakan skema versi 1.0.

Pilih perangkat dan tambahkan modul

1. Masuk ke portal Microsoft Azure dan navigasikan ke IoT Hub Anda.

2. Di panel kiri, pilih Perangkat di bawah menu Manajemen perangkat .

3. Pilih perangkat IoT Edge target dari daftar.

4. Di bilah atas, pilih Atur Modul.

5. Di bagian Kredensial Container Registry halaman, berikan kredensial untuk mengakses registri kontainer yang berisi gambar modul. Misalnya, modul Anda berada di registri kontainer privat atau Anda menggunakan registri kontainer mitra yang memerlukan autentikasi.

6. Di bagian Modul IoT Edge pada halaman, pilih Tambahkan.

   

7. Pilih jenis modul yang ingin Anda tambahkan dari menu drop-down. Anda dapat menambahkan modul IoT Edge atau modul Azure Stream Analytics.

Modul IoT Edge

Gunakan opsi ini untuk menambahkan modul Microsoft, modul mitra, atau modul kustom. Anda memberikan nama modul dan URI gambar kontainer. URI gambar kontainer adalah lokasi gambar modul dalam registri kontainer. Untuk daftar gambar modul Microsoft IoT Edge, lihat Registri Artefak Microsoft. Untuk modul mitra, hubungi penerbit modul IoT Edge untuk mendapatkan URI gambar kontainer.

Misalnya untuk menambahkan modul sensor suhu yang disimulasikan Microsoft:

1. Masukkan pengaturan berikut:

   Pengaturan	Nilai
   URI gambar	mcr.microsoft.com/azureiotedge-simulated-temperature-sensor
   Kebijakan Menghidupkan Ulang	always
   Status yang Diinginkan	dijalankan

   

2. Pilih Tambahkan.

3. Setelah menambahkan modul, pilih nama modul dari daftar untuk membuka pengaturan modul. Isi bidang opsional jika perlu.

   

Untuk informasi selengkapnya tentang pengaturan modul yang tersedia, lihat Konfigurasi dan manajemen modul.

Untuk informasi selengkapnya tentang modul kembar, lihat Menentukan atau memperbarui properti yang diinginkan.

Modul Azure Stream Analytics

Gunakan opsi ini untuk modul yang dihasilkan dari beban kerja Azure Stream Analytics.

1. Pilih langganan Anda dan tugas Azure Stream Analytics Edge yang Anda buat.
2. Pilih Simpan.

Untuk informasi selengkapnya tentang menyebarkan Azure Stream Analytics dalam modul IoT Edge, lihat Tutorial: Menyebarkan Azure Stream Analytics sebagai modul IoT Edge.

Menentukan rute

Pada tab Rute, Anda menentukan bagaimana pesan disampaikan antara modul dan IoT Hub. Pesan dibuat menggunakan pasangan nama/nilai. Secara default, penyebaran pertama untuk perangkat baru menyertakan rute yang disebut rute dan didefinisikan sebagai FROM /messages/* INTO $upstream, yang berarti bahwa setiap output pesan oleh modul apa pun dikirim ke IoT Hub Anda.

Parameter Prioritas dan Waktu untuk hidup adalah parameter opsional yang dapat Anda sertakan dalam definisi rute. Parameter prioritas memungkinkan Anda untuk memilih rute mana yang harus memproses pesan mereka terlebih dahulu, atau rute mana yang harus diproses terakhir. Prioritas ditentukan dengan menetapkan angka 0-9, 0 adalah prioritas utama. Parameter waktu untuk hidup memungkinkan Anda untuk menyatakan berapa lama pesan dalam rute tersebut harus ditahan sampai diproses atau dihapus dari antrian.

Untuk informasi selengkapnya tentang cara membuat rute, lihat Menyatakan rute.

Setelah rute diatur, pilih Berikutnya: Tinjau + buat untuk melanjutkan ke langkah wizard berikutnya.

Meninjau penyebaran

Bagian peninjauan menunjukkan manifes penerapan JSON yang dibuat berdasarkan pilihan Anda di dua bagian sebelumnya. Perhatikan bahwa ada dua modul yang dinyatakan bahwa Anda tidak menambahkan: $edgeAgent dan $edgeHub. Kedua modul ini membentuk runtime IoT Edge dan diperlukan secara default dalam setiap penyebaran.

Tinjau informasi penyebaran Anda, lalu pilih Buat.

Melihat modul di perangkat Anda

Setelah menyebarkan modul ke perangkat, Anda dapat melihat semuanya di halaman detail perangkat IoT Hub Anda. Halaman ini menampilkan nama setiap modul yang disebar, serta informasi yang berguna seperti status penyebaran dan kode keluar.

Pilih Berikutnya: Rute dan lanjutkan dengan penyebaran seperti yang dijelaskan oleh Tentukan rute dan Tinjau Penyebaran sebelumnya di artikel ini.

Langkah berikutnya

Pelajari cara Menyebarkan dan memantau modul IoT Edge dalam skala besar.