Menerapkan modul IoT Edge dalam skala besar menggunakan portal Microsoft Azure

Berlaku untuk: IoT Edge 1.5

Penting

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

Membuat penyebaran otomatis IoT Edge di portal Microsoft Azure untuk mengelola penyebaran yang sedang berlangsung untuk banyak perangkat sekaligus. Penyebaran otomatis untuk IoT Edge adalah bagian dari fitur manajemen perangkat IoT Hub. Penyebaran adalah proses dinamis yang memungkinkan Anda untuk menyebarkan beberapa modul ke beberapa perangkat, melacak status dan kesehatan modul, dan membuat perubahan jika diperlukan.

Untuk informasi selengkapnya, lihat Memahami penyebaran otomatis IoT Edge untuk satu perangkat atau dalam skala besar.

Mengidentifikasi perangkat menggunakan tag

Sebelum dapat membuat penyebaran, Anda harus dapat menentukan perangkat mana yang ingin Anda pengaruhi. Azure IoT Edge mengidentifikasi perangkat menggunakan tag di perangkat kembar. Setiap perangkat dapat memiliki beberapa tag yang ditentukan dengan cara apa pun yang masuk akal untuk solusi Anda.

Misalnya, jika Anda mengelola kampus gedung pintar, Anda dapat menambahkan tag lokasi, jenis kamar, dan lingkungan ke perangkat:

"tags":{
  "location":{
    "building": "20",
    "floor": "2"
  },
  "roomtype": "conference",
  "environment": "prod"
}

Untuk informasi selengkapnya tentang perangkat kembar dan tag, lihat Memahami dan menggunakan perangkat kembar di IoT Hub.

Membuat penyebaran

IoT Edge menyediakan dua jenis penyebaran otomatis berbeda yang dapat digunakan untuk menyesuaikan skenario Anda. Anda dapat membuat penyebaran standar, yang mencakup modul runtime sistem tersebut dan modul dan rute lainnya. Setiap perangkat hanya dapat menerapkan satu penyebaran. Atau Anda dapat membuat penyebaran berlapis, yang hanya menyertakan modul dan rute khusus, bukan waktu proses sistem. Banyak penyebaran berlapis dapat digabungkan pada perangkat, di atas penyebaran standar. Untuk informasi selengkapnya tentang cara kerja dua jenis penerapan otomatis, lihat Memahami penyebaran otomatis IoT Edge untuk perangkat tunggal atau dalam skala besar.

Langkah-langkah untuk membuat penyebaran dan penyebaran berlapis serupa. Setiap perbedaan disebutkan dalam langkah-langkah berikut.

1. Di portal Microsoft Azure, buka IoT hub Anda.
2. Pada menu sumber daya di panel kiri, pilih Konfigurasi + Penyebaran di bawah Manajemen Perangkat.
3. Pada bilah perintah, pilih Tambahkan>Penyebaran atau Penyebaran Berlapis.

Ada lima langkah untuk membuat penyebaran. Bagian berikut memandu Anda langkah demi langkah.

Catatan

Langkah-langkah dalam artikel ini mencerminkan versi skema terbaru dari agen dan hub IoT Edge.

Jika Anda menerapkan ke perangkat yang menjalankan versi 1.0.9 atau yang lebih lama, edit Pengaturan Runtime pada langkah Modul dalam panduan untuk menetapkan skema versi 1.0.

Langkah 1: Nama dan label

1. Beri penyebaran Anda nama unik hingga 128 huruf kecil. Hindari spasi dan karakter tidak valid berikut: & ^ [ ] { } \ | " < > /.
2. Anda dapat menambahkan label sebagai pasangan nilai kunci untuk membantu melacak penyebaran Anda. Misalnya, HostPlatform dan Linux, atau Versi dan 3.0.1.
3. Pilih Selanjutnya: Modul untuk lanjut ke langkah kedua.

Langkah 2: Modul

Anda dapat menambahkan hingga 50 modul ke penyebaran. Jika Anda membuat penyebaran tanpa modul, itu akan menghapus semua modul saat ini dari perangkat target.

Dalam penyebaran, Anda dapat mengelola pengaturan untuk agen IoT Edge dan modul hub IoT Edge. Pilih Pengaturan Runtime untuk mengonfigurasi kedua modul runtime. Dalam penyebaran berlapis, modul runtime tidak disertakan sehingga tidak dapat dikonfigurasi.

Untuk menambahkan kode kustom sebagai modul, atau menambahkan modul layanan Azure secara manual, ikuti langkah-langkah berikut:

1. Di bagian Kredensial Container Registry pada halaman, masukkan kredensial untuk mengakses registri kontainer privat yang berisi gambar-gambar modul Anda.

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

3. Pilih salah satu 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.5. Untuk daftar gambar modul Microsoft IoT Edge, lihat Registri Artefak Microsoft.
   • Modul Azure Stream Analytics - Modul yang dihasilkan dari beban kerja Azure Stream Analytics.

4. Jika diperlukan, ulangi langkah 2 dan 3 untuk menambahkan lebih banyak modul ke penyebaran Anda.

Setelah Anda menambahkan modul ke penyebaran, Anda dapat memilih namanya untuk membuka laman Perbarui Modul IoT Edge. Pada halaman ini, Anda dapat mengedit pengaturan modul, variabel lingkungan, membuat opsi, urutan pengaktifan, dan kembar modul. Jika Anda menambahkan modul dari marketplace, modul mungkin sudah memiliki beberapa parameter yang diisi. Untuk informasi selengkapnya tentang pengaturan modul yang tersedia, lihat Konfigurasi dan manajemen modul.

Jika Anda membuat pengaturan berlapis, Anda mungkin mengonfigurasi modul yang sudah ada dalam pengaturan lain yang ditujukan untuk perangkat yang sama. Untuk memperbarui kembar modul tanpa menimpa versi lain, buka tab Setelan Modul Kembar. Buat Properti Kembar Modul baru dengan nama unik untuk subbagian dalam properti kembar modul yang diinginkan, misalnya properties.desired.settings. Jika Anda menentukan properti hanya properties.desired dalam bidang , properti yang diinginkan akan menimpa properti yang diinginkan untuk modul yang ditentukan dalam penyebaran prioritas yang lebih rendah.

Untuk informasi selengkapnya tentang konfigurasi kembar modul dalam penyebaran berlapis, lihat Penyebaran berlapis.

Setelah semua modul untuk penyebaran dikonfigurasi, pilih Selanjutnya: Rute untuk lanjut ke langkah ketiga.

Langkah 3: Rute

Pada tab Rute , Anda menentukan bagaimana pesan diteruskan antara modul dan hub IoT. Pesan dibuat menggunakan pasangan nama/nilai.

Misalnya, rute dengan rute nama dan nilai FROM /messages/* INTO $upstream akan mengambil output pesan apa pun oleh modul apa pun dan mengirimkannya 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.

Pilih Berikutnya: Perangkat Target.

Langkah 4: Perangkat target

Untuk menargetkan perangkat tertentu yang harus menerima penyebaran ini, gunakan tags properti dari perangkat Anda.

Karena beberapa penyebaran dapat menargetkan perangkat yang sama, Anda harus memberikan nomor prioritas pada setiap penyebaran. Jika pernah terjadi konflik, penerapan dengan prioritas tertinggi (nilai yang lebih besar menunjukkan prioritas yang lebih tinggi) akan menang. Jika dua penyebaran memiliki nomor prioritas yang sama, yang dibuat paling baru akan menang.

Jika beberapa penyebaran menargetkan perangkat yang sama, maka hanya perangkat dengan prioritas lebih tinggi yang diterapkan. Jika beberapa penerapan bertingkat menarget perangkat yang sama, semuanya akan diterapkan. Namun, jika ada duplikat properti, seperti jika ada dua rute dengan nama yang sama, maka salah satu dari penyebaran berlapis dengan prioritas lebih tinggi akan menimpa sisanya.

Setiap penyebaran berlapis yang menargetkan perangkat harus memiliki prioritas lebih tinggi daripada penyebaran dasar agar dapat diterapkan.

1. Masukkan bilangan bulat positif untuk Prioritas penyebaran.
2. Masukkan kondisi Target untuk menentukan perangkat mana yang ditargetkan dengan penyebaran ini. Persyaratan ini didasarkan pada tag kembar perangkat atau properti yang dilaporkan perangkat kembar dan harus sesuai dengan format ekspresi. Misalnya, tags.environment='test' atau properties.reported.devicemodel='4000x'.

Pilih Berikutnya: Metrik.

Langkah 5: Metrik

Metrik menyediakan jumlah ringkasan dari berbagai status yang mungkin dilaporkan kembali oleh perangkat sebagai akibat dari penerapan konten konfigurasi.

1. Masukkan nama untuk Nama Metrik.

2. Masukkan kueri untuk Kriteria Metrik. Kueri didasarkan pada properti yang dilaporkan kembar modul hub IoT Edge. Metrik menunjukkan jumlah baris yang dikembalikan oleh kueri.

   Contohnya:

   SELECT deviceId FROM devices
     WHERE properties.reported.lastDesiredStatus.code = 200
   

Pilih Berikutnya: Tinjau + buat untuk melanjutkan ke langkah terakhir.

Langkah 6: Tinjau dan buat

Tinjau informasi penyebaran Anda, lalu pilih Buat.

Untuk memantau penyebaran, lihat Memantau penyebaran IoT Edge.

Catatan

Saat penyebaran IoT Edge baru dibuat, terkadang diperlukan waktu hingga 5 menit agar hub IoT memproses konfigurasi baru dan menyebarkan properti baru yang diinginkan ke perangkat yang ditargetkan.

Mengubah penyebaran

Saat Anda memodifikasi penyebaran, perubahan akan segera mereplikasi ke semua perangkat yang ditargetkan. Anda dapat mengubah pengaturan dan fitur berikut untuk penyebaran yang sudah ada:

• Persyaratan target
• Metrik kustom
• Label
• Tag
• Properti yang diinginkan

Mengubah persyaratan target, metrik kustom, dan label

1. Di hub IoT Anda, pilih Konfigurasi + Penyebaran di bawah **Manajemen perangkat ** dari menu sumber daya.

2. Pilih penyebaran yang ingin Anda konfigurasi.

3. Pilih tab Perangkat Target. Ubah Kondisi Target untuk menargetkan perangkat yang dimaksudkan. Anda juga dapat menyesuaikan Prioritas.

   Jika Anda memperbarui kondisi target, pembaruan berikut terjadi:

   • Jika perangkat tidak memenuhi kondisi target lama tetapi memenuhi kondisi target baru, dan penerapan ini merupakan prioritas tertinggi untuk perangkat tersebut, maka penerapan ini akan diterapkan ke perangkat.
   • Jika perangkat yang saat ini menjalankan penyebaran ini tidak lagi memenuhi persyaratan target, perangkat akan menghapus instalan penyebaran ini dan mengambil penyebaran prioritas tertinggi berikutnya.
   • Jika perangkat yang saat ini menjalankan penyebaran ini tidak lagi memenuhi persyaratan target dan tidak memenuhi persyaratan target penyebaran lainnya, maka tidak ada perubahan yang terjadi pada perangkat. Perangkat terus menjalankan modul yang sedang digunakan dalam kondisi saat ini, tetapi tidak lagi dikelola sebagai bagian dari implementasi ini. Setelah memenuhi kondisi target penyebaran lain, perangkat menghapus penyebaran ini dan mengambil penyebaran baru.

4. Pilih tab Metrik dan tambahkan atau ubah metrik kustom, menggunakan sintaks contoh sebagai panduan. Pilih Simpan.

   

5. Pilih tab Label dan buat perubahan yang diinginkan, lalu pilih Simpan.

Menghapus penyebaran

Saat Anda menghapus penyebaran, semua perangkat yang diterapkan akan mengambil penyebaran prioritas tertinggi berikutnya. Jika perangkat Anda tidak memenuhi kondisi target dari penyebaran lain mana pun, maka modul tidak akan dihapus ketika penyebaran tersebut dihapus.

1. Masuk ke portal Azure dan navigasikan ke IoT hub Anda.
2. Di menu sumber daya, pilih Konfigurasi + Penyebaran di bawah Manajemen perangkat.
3. Gunakan kotak centang untuk memilih penyebaran yang ingin Anda hapus.
4. Pilih Hapus dari bilah perintah.
5. Perintah memberi tahu Anda bahwa tindakan ini menghapus penyebaran ini dan kembali ke status sebelumnya untuk semua perangkat. Penyebaran dengan prioritas yang lebih rendah berlaku. Jika tidak ada penyebaran lain yang ditargetkan, tidak ada modul yang dihapus. Jika Anda ingin menghapus semua modul dari perangkat Anda, buat penyebaran dengan nol modul dan terapkan ke perangkat yang sama. Pilih Ya untuk melanjutkan.

Langkah berikutnya

Untuk mempelajari selengkapnya tentang menyebarkan modul ke perangkat IoT Edge, lihat Memahami penyebaran otomatis IoT Edge untuk satu perangkat atau dalam skala besar.