Memperbarui IoT Edge

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.

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

Dua komponen logis 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. Subsistem keamanan hanya dapat diperbarui dari perangkat itu sendiri.

• Runtime IoT Edge - Runtime IoT Edge terdiri dari modul hub IoT Edge (edgeHub) dan agen IoT Edge (edgeAgent). Bergantung pada cara Anda menyusun penyebaran, runtime dapat diperbarui 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 antara rilis patch , misalnya 1.4.1 ke 1.4.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 kontainer runtime
3. Memverifikasi kecocokan versi

Anda dapat memecahkan masalah proses peningkatan kapan saja.

Rilis utama atau minor

Saat Anda meningkatkan antara rilis utama atau minor, misalnya dari 1.4 ke 1.5, perbarui subsistem keamanan dan kontainer runtime. Sebelum rilis, kami 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 systemctl stop iotedge dan hapus instalan.

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

3. Di perangkat, instal IoT Edge.

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

   Untuk informasi selengkapnya, lihat Mengonfigurasi pengaturan perangkat IoT Edge.

4. Di IoT Hub, perbarui penyebaran modul untuk mereferensikan modul sistem terbaru.

5. Pada perangkat, mulai IoT Edge 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 diperbarui 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 mengecek versinya.

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 instruksi untuk mendapatkan konfigurasi repositori terbaru dari Microsoft, lihat langkah-langkah awal untuk Menginstal IoT Edge.

Periksa untuk melihat versi IoT Edge mana yang tersedia:

apt list -a aziot-edge

Perbarui IoT Edge:

sudo apt-get install aziot-edge defender-iot-micro-agent-edge

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

Disarankan untuk menginstal agen mikro dengan agen Edge untuk mengaktifkan pemantauan dan pengerasan keamanan perangkat Edge Anda. Untuk mempelajari selengkapnya tentang Pertahanan Microsoft untuk IoT, lihat Apa itu Pertahanan Microsoft untuk IoT untuk penyusun perangkat.

Red Hat Enterprise Linux

Cek untuk melihat versi IoT Edge mana yang tersedia.

yum list aziot-edge

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

sudo yum install aziot-edge

Linux di Windows

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

Windows

Catatan

Saat ini, tidak ada dukungan untuk IoT Edge yang berjalan pada perangkat Windows di kontainer Windows. Gunakan kontainer Linux untuk menjalankan IoT Edge di Windows.

Kemudian, terapkan kembali konfigurasi untuk memastikan sistem diperbarui sepenuhnya.

sudo iotedge config apply

Memperbarui kontainer runtime

Cara Anda memperbarui agen IoT Edge dan kontainer hub IoT Edge bergantung pada apakah Anda menggunakan tag bergulir (seperti 1,5) atau tag tertentu (seperti 1.5.1) dalam penyebaran Anda.

Cek versi agen IoT Edge dan modul hub IoT Edge yang saat ini ada di perangkat Anda 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 mengecek versi modul runtime.

Memahami tag IoT Edge

Agen IoT Edge dan gambar hub IoT Edge ditandai dengan versi IoT Edge yang terkait dengannya. Ada dua cara berbeda untuk menggunakan tag dengan gambar runtime bahasa umum:

• Tag bergulir - Gunakan hanya dua nilai pertama dari nomor versi untuk mendapatkan gambar terbaru yang cocok dengan digit tersebut. Misalnya, 1.5 diperbarui setiap kali ada rilis baru untuk menunjuk ke versi 1.5.x terbaru. Jika runtime bahasa umum kontainer pada perangkat IoT Edge Anda menarik gambar lagi, modul runtime bahasa umum diperbarui ke versi terbaru. Penyebaran dari portal Microsoft Azure default ke tag bergulir. Pendekatan ini disarankan untuk tujuan pengembangan.

• Tag tertentu - Gunakan ketiga nilai nomor versi untuk mengatur versi gambar secara eksplisit. Misalnya, 1.5.0 tidak akan berubah setelah rilis awal. Anda dapat mendeklarasikan nomor versi baru dalam manifes penyebaran saat Anda siap untuk memperbarui. Pendekatan ini disarankan untuk keperluan produksi.

Memperbarui citra tag bergulir

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

Hapus versi lokal citra 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.5
docker rmi mcr.microsoft.com/azureiotedge-agent:1.5

Anda mungkin perlu menggunakan bendera -f force untuk menghapus citra.

Layanan IoT Edge menarik versi terbaru gambar runtime dan secara otomatis memulainya di perangkat Anda lagi.

Memperbarui citra tag tertentu

Jika Anda menggunakan tag tertentu dalam penyebaran Anda (misalnya, mcr.microsoft.com/azureiotedge-hub:1.4) maka yang perlu Anda lakukan adalah memperbarui tag dalam manifes penyebaran Anda dan menerapkan perubahan ke perangkat Anda.

1. Pada Hub IoT di portal Microsoft Azure, pilih perangkat IoT Edge Anda, dan pilih Atur Modul.

2. Pada tab Modul, pilih Runtime Pengaturan.

3. Di Runtime Pengaturan, perbarui nilai URI Gambar di bagian Agen Edge dengan versi yang diinginkan. Misalnya, mcr.microsoft.com/azureiotedge-agent:1.5 Jangan pilih Terapkan belum.

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

5. Pilih Terapkan untuk menyimpan perubahan.

6. 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. Output mencakup nomor versi utama, minor, dan revisi. Misalnya, iotedge 1.4.2.

2. Dalam pengaturan runtime penyebaran perangkat Anda, verifikasi versi URI gambar edgeHub dan edgeAgent cocok dengan versi utama dan minor dari subsistem keamanan. Jika versi subsistem keamanan adalah 1.4.2, versi gambarnya adalah 1.4. Misalnya, mcr.microsoft.com/azureiotedge-hub:1.4 dan mcr.microsoft.com/azureiotedge-agent:1.4.

Catatan

Perbarui subsistem keamanan IoT Edge dan kontainer runtime ke versi rilis yang didukung yang sama. Meskipun versi yang tidak cocok didukung, kami 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 dengan 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 Memecahkan masalah perangkat IoT Edge Anda.

Langkah berikutnya

Lihat rilis Azure IoT Edge terbaru.

Dapatkan informasi terbaru dengan pembaruan dan pengumuman terbaru di blog Internet of Things