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.
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
Masuk ke portal Azure dan navigasikan ke IoT hub Anda.
Di panel kiri, pilih Perangkat di bawah menu Manajemen perangkat .
Pilih perangkat IoT Edge target dari daftar.
Di bilah atas, pilih Atur Modul.
Di bagian Kredensial Container Registry di halaman, berikan kredensial untuk mengakses registri kontainer privat yang berisi gambar modul Anda.
Di bagian Modul IoT Edge pada halaman, pilih Tambahkan.
Pilih salah satu dari tiga jenis modul dari menu drop-down:
- Modul IoT Edge - Anda menyediakan nama modul dan URI gambar kontainer. Misalnya, URI gambar untuk sampel modul SimulatedTemperatureSensor adalah
mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:1.0
. Jika gambar modul disimpan dalam registri kontainer pribadi, tambahkan kredensial di halaman ini untuk mengakses gambar. - Modul Marketplace - Modul yang dihosting di Azure Marketplace. Beberapa modul marketplace memerlukan konfigurasi tambahan, jadi tinjau detail modul di daftar Modul IoT Edge Azure Marketplace.
- Modul Azure Stream Analytics - Modul yang dihasilkan dari beban kerja Azure Stream Analytics.
- Modul IoT Edge - Anda menyediakan nama modul dan URI gambar kontainer. Misalnya, URI gambar untuk sampel modul SimulatedTemperatureSensor adalah
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 kembaran modul, lihat Menentukan atau memperbarui properti yang diinginkan.
Ulangi langkah 6 sampai 8 untuk menambahkan modul tambahan ke penyebaran Anda.
Pilih Berikutnya: Rute untuk melanjutkan ke bagian rute.
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 mencakup rute yang disebut rute dan didefinisikan sebagai FROM /messages/* INTO $upstream, yang berarti bahwa setiap output pesan oleh modul apa pun dikirim ke hub IoT 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.
Menyebarkan modul dari Azure Marketplace
Azure Marketplace adalah pasar aplikasi dan layanan online tempat Anda dapat menelusuri berbagai aplikasi dan solusi perusahaan yang bersertifikat dan dioptimalkan untuk dijalankan di Azure, termasukmodul IoT Edge.
Anda dapat menyebarkan modul IoT Edge dari Azure Marketplace dan dari IoT Hub Anda.
Sebarkan dari Azure Marketplace
Baca modul IoT Edge di pasar dengan teliti dan ketika Anda menemukan modul yang Anda inginkan, Anda dapat menyebarkannya dengan memilih Buat atau Dapatkan sekarang. Lanjutkan dengan langkah-langkah wizard penyebaran yang dapat bervariasi tergantung pada modul IoT Edge yang Anda pilih:
- Pilih Lanjutkan untuk mengakui ketentuan penggunaan dan kebijakan privasi penyedia. Anda mungkin terlebih dahulu harus memberikan informasi kontak.
- Pilih langganan Anda dan IoT Hub tempat perangkat target terpasang.
- Pilih Sebarkan ke perangkat.
- Masukkan nama perangkat atau pilih Cari Perangkat untuk menelusuri seluruh perangkat yang terdaftar di hub.
- Pilih Buat untuk melanjutkan proses standar konfigurasi manifes penyebaran, termasuk menambahkan modul lain jika diinginkan. Detail untuk modul baru seperti URI gambar, opsi buat, dan properti yang diinginkan telah ditentukan tetapi dapat diubah.
Verifikasi bahwa modul disebar di IoT Hub Anda di portal Microsoft Azure. Pilih perangkat Anda, pilih Atur Modul dan modul harus dicantumkan di bagian Modul IoT Edge.
Sebarkan dari Azure IoT Hub
Anda dapat dengan cepat menyebarkan modul dari Azure Marketplace ke perangkat Anda di IoT Hub Anda di portal Microsoft Azure.
- Di portal Azure, navigasi ke hub IoT Anda.
- Di panel kiri, pilih Perangkat di bawah menu Manajemen perangkat .
- Pilih perangkat IoT Edge yang akan menerima penyebaran.
- Di bilah atas, pilih Atur Modul.
- Di bagian Modul IoT Edge, klik Tambahkan,dan pilih Modul Marketplace dari menu drop-down.
Pilih modul dari halaman IoT Edge Module Marketplace. Modul yang Anda pilih dikonfigurasi secara otomatis untuk langganan, grup sumber daya, dan perangkat Anda. Kemudian muncul dalam daftar modul IoT Edge Anda. Beberapa modul mungkin memerlukan konfigurasi tambahan.
Tip
Informasi tentang modul IoT Edge dari Azure IoT Hub terbatas. Anda dapat mempelajari lebih lanjut tentang modul IoT Edge di Azure Marketplace.
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