Memperbarui IoT Edge

Berlaku untuk: IoT Edge 1.6 IoT Edge 1.5

Penting

IoT Edge 1.6 LTS adalah rilis yang didukung. Dukungan IoT Edge 1.5 LTS berakhir pada 10 November 2026; IoT Edge 1.4 LTS habis masa pakainya mulai 12 November 2024.

Saat layanan IoT Edge merilis versi baru, perbarui perangkat IoT Edge Anda untuk fitur terbaru dan peningkatan keamanan. Artikel ini menyediakan informasi tentang cara memperbarui perangkat IoT Edge Anda saat versi baru tersedia.

Dua komponen logis dari perangkat IoT Edge perlu diperbarui jika Anda ingin pindah ke versi yang lebih baru.

• Subsistem keamanan - Ini berjalan pada perangkat, menangani tugas berbasis keamanan, dan memulai modul saat perangkat dimulai. Anda hanya dapat memperbarui subsistem keamanan dari perangkat itu sendiri.

• runtime IoT Edge - Runtime IoT Edge terdiri dari modul IoT Edge hub (edgeHub) dan agen IoT Edge (edgeAgent). Bergantung pada cara Anda menyusun penyebaran, Anda dapat memperbarui runtime dari perangkat atau dari jarak jauh.

Bagaimana cara memperbarui

Gunakan bagian artikel ini untuk memperbarui subsistem keamanan dan kontainer runtime pada perangkat.

Rilis patch

Saat Anda meningkatkan di antara rilis patch , misalnya 1.6.1 ke 1.6.2, urutan pembaruan tidak penting. Anda dapat meningkatkan subsistem keamanan atau kontainer runtime sebelum atau sesudah yang lain. Untuk memperbarui antara rilis patch:

1. Memperbarui subsistem keamanan
2. Memperbarui runtime kontainer
3. Memverifikasi kecocokan versi

Anda dapat memecahkan masalah proses peningkatan kapan saja.

Rilis besar atau kecil

Saat Anda memutakhirkan antara rilis utama atau minor, seperti dari 1.5 ke 1.6, perbarui subsistem keamanan dan kontainer runtime. Sebelum rilis, tim produk menguji subsistem keamanan dan kombinasi versi kontainer runtime. Untuk memperbarui antara rilis produk utama atau minor:

1. Pada perangkat, hentikan IoT Edge menggunakan perintah sudo iotedge system stop dan uninstall.

2. Pada perangkat, tingkatkan mesin kontainer Anda, baik Docker atau Moby.

3. Pada perangkat, install IoT Edge.

   Jika Anda mengimpor konfigurasi lama dengan menggunakan iotedge config import, modifikasi gambar [agent.config] dari file yang dihasilkan /etc/aziot/config.toml untuk menggunakan gambar 1.6 untuk edgeAgent.

   Untuk informasi selengkapnya, lihat Konfigurasi pengaturan perangkat IoT Edge.

4. Dalam IoT Hub, mengupdate penyebaran modul untuk mereferensikan modul sistem terbaru.

5. Mulai IoT Edge pada perangkat menggunakan sudo iotedge config apply.

Anda dapat memecahkan masalah proses peningkatan kapan saja.

Memperbarui subsistem keamanan

Subsistem keamanan IoT Edge mencakup sekumpulan komponen asli yang perlu Anda perbarui dengan menggunakan manajer paket pada perangkat IoT Edge.

Periksa versi subsistem keamanan yang berjalan di perangkat Anda dengan menggunakan perintah iotedge version. Jika Anda menggunakan IoT Edge untuk Linux di Windows, Anda perlu SSH ke komputer virtual Linux untuk memeriksa versi.

Ubuntu / Debian

Pada perangkat Linux x64, gunakan apt-get atau manajer paket yang sesuai untuk memperbarui subsistem keamanan ke versi terbaru.

Perbarui apt:

sudo apt-get update

Catatan

Untuk petunjuk tentang cara mendapatkan konfigurasi repositori terbaru dari Microsoft, lihat langkah-langkah awal untuk Install IoT Edge.

Periksa versi IoT Edge mana yang tersedia:

apt list -a aziot-edge

Perbarui IoT Edge:

sudo apt-get install aziot-edge

Melakukan peningkatan subsistem keamanan dan menginstal layanan identitas, apt-get install aziot-edge, sebagai dependensi yang diperlukan.

Red Hat Enterprise Linux

Periksa versi IoT Edge mana yang tersedia:

yum list aziot-edge

Jika Anda ingin memperbarui ke versi terbaru IoT Edge, gunakan perintah berikut. Ini juga memperbarui layanan identitas ke versi terbaru:

sudo yum install aziot-edge

Linux pada Windows

Untuk informasi tentang pembaruan IoT Edge untuk Linux pada Windows, lihat Pembaruan EFLOW.

Windows

Catatan

Saat ini, kontainer Windows tidak mendukung IoT Edge berjalan di perangkat Windows. Gunakan kontainer Linux untuk menjalankan IoT Edge di Windows.

Kemudian, terapkan kembali konfigurasi untuk memastikan sistem diperbarui sepenuhnya.

sudo iotedge config apply

Memperbarui runtime kontainer

Cara Anda memperbarui agen IoT Edge dan kontainer hub IoT Edge bergantung pada apakah Anda menggunakan tag bergulir (seperti 1.6) atau tag tertentu (seperti 1.6.1) dalam penyebaran Anda.

Periksa versi agen IoT Edge dan modul hub IoT Edge yang saat ini ada di perangkat Anda dengan menggunakan perintah iotedge logs edgeAgent atau iotedge logs edgeHub. Jika Anda menggunakan IoT Edge untuk Linux di Windows, Anda perlu SSH ke komputer virtual Linux untuk memeriksa versi modul runtime.

Memahami tag IoT Edge

Agen IoT Edge dan gambar hub IoT Edge menggunakan tag yang cocok dengan versi IoT Edge yang terkait dengannya. Gunakan dua metode berbeda untuk menandai gambar runtime:

• Tag bergulir - Gunakan hanya dua nilai pertama dari nomor versi untuk mendapatkan gambar terbaru yang cocok dengan digit tersebut. Misalnya, 1.6 diperbarui setiap kali ada rilis baru untuk mengarah ke versi 1.6.x terbaru. Jika runtime kontainer pada perangkat IoT Edge Anda mengambil image lagi, modul runtime akan diperbarui ke versi terbaru. Penyebaran dari portal Azure secara default menggunakan tag bertingkat. Gunakan pendekatan ini untuk tujuan pengembangan.

• Tag tertentu - Gunakan ketiga nilai nomor versi untuk mengatur versi gambar secara eksplisit. Misalnya, 1.6.0 tidak berubah setelah rilis awalnya. Anda dapat mendeklarasikan nomor versi baru dalam manifes penyebaran saat Anda siap untuk memperbarui. Gunakan pendekatan ini untuk tujuan produksi.

Memperbarui gambar label bergulir

Jika Anda menggunakan tag bergulir dalam penyebaran Anda (misalnya, mcr.microsoft.com/azureiotedge-hub:**1.6**), maka Anda perlu memaksa runtime kontainer di perangkat Anda untuk menarik versi terbaru gambar.

Hapus versi lokal gambar dari perangkat IoT Edge Anda. Pada komputer Windows, menghapus instalan subsistem keamanan juga menghapus gambar runtime, sehingga Anda tidak perlu mengambil langkah ini lagi.

docker rmi mcr.microsoft.com/azureiotedge-hub:1.6
docker rmi mcr.microsoft.com/azureiotedge-agent:1.6

Anda mungkin perlu menggunakan bendera paksa -f untuk menghapus gambar.

Layanan IoT Edge mengunduh versi terbaru citra runtime dan secara otomatis memulainya kembali pada perangkat Anda.

Memperbarui citra tag tertentu

Jika Anda menggunakan tag tertentu dalam penyebaran (misalnya, mcr.microsoft.com/azureiotedge-hub:**1.6.1**), perbarui tag di manifes penyebaran dan terapkan perubahan ke perangkat Anda.

1. Di IoT Hub di portal Azure, pilih perangkat IoT Edge Anda, dan pilih modul Set.

2. Pada tab Modul, pilih Pengaturan Runtime.

3. Di Runtime Settings, perbarui nilai Image URI di bagian Edge Agent dengan versi yang diinginkan. Misalnya, mcr.microsoft.com/azureiotedge-agent:1.6.1 Jangan pilih Terapkan belum.

4. Pilih tab Edge Hub dan perbarui URI Gambar dengan versi yang sama yang diinginkan. Contohnya, mcr.microsoft.com/azureiotedge-hub:1.6.1.

5. Pilih Terapkan untuk menyimpan perubahan.

6. Pilih Tinjau + buat, tinjau penyebaran seperti yang terlihat dalam file JSON, dan pilih Buat.

Memperbarui URI modul mitra

Jika Anda menggunakan modul mitra, perbarui penyebaran modul Anda dengan URI gambar yang disediakan oleh mitra. Hubungi penerbit modul IoT Edge untuk mendapatkan URI gambar kontainer yang diperbarui. Perbarui konfigurasi perangkat Anda dengan URI gambar baru yang disediakan oleh penerbit.

1. Masuk ke portal Azure dan navigasikan ke IoT Hub Anda.
2. Di panel kiri, pilih Perangkat di bawah menu Manajemen perangkat .
3. Pilih perangkat IoT Edge yang menggunakan modul mitra dari daftar.
4. Di bilah atas, pilih Atur Modul.
5. Pilih modul mitra IoT Edge yang ingin Anda perbarui dengan URI gambar baru.
6. Perbarui nilai URI Gambar dengan URI gambar baru yang disediakan oleh penerbit.
7. Pilih Terapkan untuk menyimpan perubahan.
8. Pilih Tinjau + buat, tinjau penyebaran seperti yang terlihat dalam file JSON, dan pilih Buat.

Memverifikasi kecocokan versi

1. Di perangkat Anda, gunakan iotedge version untuk memeriksa versi subsistem keamanan. Keluaran mencakup nomor versi utama, nomor versi minor, dan nomor versi revisi. Misalnya, iotedge 1.6.0.

2. Dalam pengaturan runtime penyebaran perangkat Anda, pastikan URI gambar edgeHub dan edgeAgent memiliki versi utama dan minor yang sesuai dengan subsistem keamanan. Jika versi subsistem keamanan adalah 1.6.0, versi gambar adalah 1.6. Misalnya, mcr.microsoft.com/azureiotedge-hub:1.6 dan mcr.microsoft.com/azureiotedge-agent:1.6.

Catatan

Perbarui subsistem keamanan IoT Edge dan kontainer runtime ke versi rilis yang didukung yang sama. Meskipun versi yang tidak cocok didukung, Microsoft belum menguji semua kombinasi versi.

Untuk menemukan versi terbaru Azure IoT Edge, lihat rilis Azure IoT Edge.

Pemecahan Masalah

Anda dapat melihat log sistem kapan saja dengan menjalankan perintah berikut dari perangkat Anda.

• Mulai pemecahan masalah menggunakan perintah periksa . Ini menjalankan kumpulan pengujian konfigurasi dan konektivitas untuk masalah umum.

  sudo iotedge check --verbose
  

• Untuk melihat status sistem IoT Edge, jalankan:

  sudo iotedge system status 
  

• Untuk melihat log komponen host, jalankan:

  sudo iotedge system logs
  

• Untuk memeriksa masalah berulang yang dilaporkan oleh edgeAgent dan edgeHub, jalankan:

  Pastikan untuk mengganti <module> dengan nama modul Anda sendiri. Jika tidak ada masalah, Anda tidak akan melihat output.

  sudo iotedge logs <module>
  

Untuk informasi selengkapnya, lihat Pemecahan Masalah perangkat IoT Edge Anda.

Langkah berikutnya

Lihat rilis Azure IoT Edge terbaru.