Penyediaan Agen Pembaruan Perangkat

  • Artikel

Agen Modul Pembaruan Perangkat dapat berjalan bersama proses sistem lain dan modul IoT Edge yang terhubung ke Azure IoT Hub Anda sebagai bagian dari perangkat logis yang sama. Bagian ini menjelaskan cara menyediakan agen Pembaruan Perangkat sebagai identitas modul.

Perubahan pada agen Pembaruan Perangkat pada rilis GA

Jika Anda menggunakan versi agen Pembaruan Perangkat, silakan migrasikan ke agen terbaru versi 1.0.0 yang merupakan versi GA. Lihat agen GA untuk perubahan dan cara meningkatkan

Anda dapat memeriksa versi terinstal dari agen Pembaruan Perangkat dan agen Optimalisasi Pengiriman di bagian Properti Perangkat dari kembaran perangkat IoT Anda. Pelajari selengkapnya tentang properti perangkat di bawah Antarmuka ADU Core.

Identitas modul vs identitas perangkat

Di Azure IoT Hub, pada setiap identitas perangkat, Anda dapat membuat hingga 50 identitas modul. Setiap identitas modul membuat kembaran modul secara implisit. Di sisi perangkat, SDK perangkat IoT Hub memungkinkan Anda membuat modul di mana masing-masing modul membuka koneksi independen ke IoT Hub. Identitas modul dan kembaran modul menyediakan kemampuan yang sama seperti identitas perangkat dan kembaran perangkat tetapi dengan perincian yang lebih baik. Pelajari lebih lanjut tentang Identitas Modul di Azure IoT Hub

Jika Anda bermigrasi dari agen tingkat perangkat untuk menambahkan agen sebagai identitas Modul pada perangkat, hapus agen lama yang berkomunikasi melalui Device Twin. Saat Anda menyediakan agen Pembaruan Perangkat sebagai Identitas Modul, semua komunikasi antara perangkat dan layanan Pembaruan Perangkat terjadi melalui Modul Kembar jadi jangan lupa untuk menandai Modul Kembar perangkat saat membuat grup dan semua komunikasi harus terjadi melalui kembaran modul.

Dukungan untuk Pembaruan Perangkat

Jenis pembaruan perangkat IoT berikut melalui udara saat ini didukung dengan Pembaruan Perangkat:

Prasyarat

Jika Anda menyiapkan perangkat IoT/perangkat IoT Edge untuk pembaruan berbasis paket, tambahkan package.microsoft.com ke repositori mesin Anda dengan mengikuti langkah-langkah berikut:

  1. Masuk ke mesin atau perangkat IoT tempat Anda ingin memasang agen Pembaruan Perangkat.

  2. Buka jendela Terminal.

  3. Pasang konfigurasi repositori yang cocok dengan sistem operasi perangkat Anda.

    curl https://packages.microsoft.com/config/ubuntu/18.04/multiarch/prod.list > ./microsoft-prod.list

  4. Salin daftar yang dibuat pada direktori sources.list.d.

    sudo cp ./microsoft-prod.list /etc/apt/sources.list.d/

  5. Pasang kunci umum GPG Microsoft.

    curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg

    sudo cp ./microsoft.gpg /etc/apt/trusted.gpg.d/

Cara menyediakan agen Pembaruan Perangkat sebagai Identitas Modul

Bagian ini menjelaskan cara menentukan agen Pembaruan Perangkat sebagai identitas modul

  • Perangkat berkemampuan IoT Edge, atau
  • Perangkat IoT Non-Azure Stack Edge, atau
  • Perangkat IoT lainnya.

Untuk memeriksa apakah Anda mengaktifkan IoT Edge di perangkat Anda, silakan lihat instruksi penginstalan IoT Edge.

Ikuti semua atau salah satu bagian di bawah ini untuk menambahkan agen pembaruan Perangkat berdasarkan jenis perangkat IoT yang Anda kelola.

Di perangkat yang mendukung IoT Edge

Ikuti petunjuk ini untuk menyediakan agen Pembaruan Perangkat di perangkat berkemampuan Azure IoT Edge.

  1. Ikuti instruksi untuk Memprovisikan secara manual perangkat IoT Edge Linux tunggal.

  2. Pasang agen pembaruan gambar dari Pembaruan Perangkat.

    Kami menyediakan gambar sampel di repositori Aset di sini. File swUpdate adalah gambar dasar yang dapat Anda flash ke papan Raspberry Pi B3+. File .gz adalah pembaruan yang akan Anda impor melalui Device Update for IoT Hub. Sebagai contoh, lihat Cara mem-flash gambar ke perangkat IoT Hub Anda.

  3. Pasang agen pembaruan paket Pembaruan Perangkat.

    • Untuk versi agen terbaru dari packages.microsoft.com: Perbarui daftar paket di perangkat Anda dan instal paket agen Pembaruan Perangkat dan dependensinya menggunakan:

      sudo apt-get update

      sudo apt-get install deviceupdate-agent

    • Untuk 'rc' mana pun, yaitu rilis versi kandidat agen dari Artefak : Unduh file .dep ke komputer tempat Anda ingin menginstal agen Pembaruan Perangkat, lalu:

      sudo apt-get install -y ./"<PATH TO FILE>"/"<.DEB FILE NAME>"

    • Jika Anda menyiapkan MCC untuk skenario perangkat yang terputus, instal plugin APT Pengoptimalan Pengiriman:

      sudo apt-get install deliveryoptimization-plugin-apt

  4. Setelah Anda memasang agen pembaruan perangkat, Anda perlu mengedit file konfigurasi untuk Pembaruan Perangkat dengan menjalankan perintah di bawah ini.

    sudo nano /etc/adu/du-config.json

    Ubah connectionType menjadi "AIS" untuk agen yang akan menggunakan Layanan Identitas IoT untuk provisi. Bidang Koneksi ionData harus berupa string kosong. Harap dicatat bahwa semua nilai dengan tag 'Tempatkan nilai di sini' harus diatur. Lihat Mengonfigurasi agen DU.

  5. Anda sekarang siap untuk memulai agen Pembaruan Perangkat di perangkat IoT Anda.

Di perangkat Linux IoT tanpa IoT Edge terpasang

Ikuti petunjuk ini untuk menyediakan agen Pembaruan Perangkat di perangkat IoT Linux Anda.

  1. Instal IoT Identity Service dan tambahkan versi terbaru ke perangkat IoT Anda dengan mengikuti instruksi dalam Menginstal Azure IoT Identity Service.

  2. Konfigurasikan Layanan Identitas IoT dengan mengikuti petunjuk dalam Mengonfigurasi Layanan Identitas Azure IoT.

  3. Terakhir pasang agen Pembaruan Perangkat. Kami menyediakan gambar sampel di Aset di sini,file swUpdate adalah gambar dasar yang dapat Anda flash ke papan Raspberry Pi B3+, dan file .gz adalah pembaruan yang akan Anda impor melalui Device Update for IoT Hub. Lihat contoh cara mem-flash citra ke perangkat IoT Hub Anda.

  4. Setelah Anda memasang agen pembaruan perangkat, Anda perlu mengedit file konfigurasi untuk Pembaruan Perangkat dengan menjalankan perintah di bawah ini.

    sudo nano /etc/adu/du-config.json

    Ubah connectionType menjadi "AIS" untuk agen yang akan menggunakan Layanan Identitas IoT untuk provisi. Bidang Koneksi ionData harus berupa string kosong. Harap dicatat bahwa semua nilai dengan tag 'Tempatkan nilai di sini' harus diatur. Lihat Mengonfigurasi agen DU.

  5. Anda sekarang siap untuk memulai agen Pembaruan Perangkat di perangkat IoT Anda.

Perangkat IoT lainnya

Agen Pembaruan Perangkat juga dapat dikonfigurasi tanpa layanan IoT Identity untuk pengujian atau pada perangkat yang dibatasi. Ikuti langkah-langkah di bawah ini untuk menyediakan agen Pembaruan Perangkat menggunakan string koneksi (dari Modul atau Perangkat).

  1. Kami menyediakan gambar sampel di repositori Aset di sini. File swUpdate adalah gambar dasar yang dapat Anda flash ke papan Raspberry Pi B3+. File .gz adalah pembaruan yang akan Anda impor melalui Device Update for IoT Hub. Sebagai contoh, lihat Cara mem-flash gambar ke perangkat IoT Hub Anda.

  2. Masuk ke mesin atau perangkat IoT Edge/perangkat IoT.

  3. Buka jendela terminal.

  4. Tambahkan string koneksi ke file konfigurasi Pembaruan Perangkat:

    1. Masukkan di bawah ini di jendela terminal:

    2. Salin string koneksi utama

      • Jika agen Pembaruan Perangkat dikonfigurasi sebagai modul, salin string koneksi utama modul.
      • Jika tidak, salin string koneksi utama perangkat.

    3. Masukkan string koneksi utama yang disalin ke nilai bidang 'connectionData' di file du-config.json. Harap dicatat bahwa semua nilai dengan tag 'Tempatkan nilai di sini' harus diatur. Lihat Mengonfigurasi agen DU

  5. Sekarang Anda sekarang siap untuk memulai agen Pembaruan Perangkat di perangkat IoT Anda.

Bagaimana memulai Agen Pembaruan Perangkat

Bagian ini menjelaskan cara memulai dan memverifikasi agen Pembaruan Perangkat sebagai identitas modul yang berhasil berjalan di perangkat IoT Anda.

  1. Masuk ke komputer atau perangkat yang telah menginstal agen Pembaruan Perangkat.

  2. Buka jendela Terminal, dan masukkan perintah di bawah ini.

    sudo systemctl restart deviceupdate-agent

  3. Anda dapat memeriksa status agen menggunakan perintah di bawah ini. Jika Anda melihat masalah, lihat panduan pemecahan masalah ini.

    sudo systemctl status deviceupdate-agent

    Anda akan melihat status OK.

  4. Di portal IoT Hub, buka perangkat IoT atau perangkat IoT Edge untuk menemukan perangkat yang Anda konfigurasikan dengan agen Pembaruan Perangkat. Di sana Anda akan melihat agen Pembaruan Perangkat berjalan sebagai modul. Contohnya:

    Diagram dari nama modul Pembaruan Perangkat.

Cara membuat dan menjalankan Agen Pembaruan Perangkat

Anda juga dapat membuat dan memodifikasi agen Pembaruan Perangkat pelanggan Anda sendiri. Ikuti petunjuk untuk membuat Agen Pembaruan Perangkat dari sumber.

Setelah agen berhasil membangun, saatnya untuk menjalankan agen. Sekarang, buat perubahan yang diperlukan untuk memasukkan agen ke dalam citra Anda. Lihat cara memodifikasi Agen Pembaruan Perangkat untuk panduan.

Panduan pemecahan masalah

Jika Anda mengalami masalah, tinjau Panduan Pemecahan Masalah Device Update for IoT Hub untuk membantu membuka blokir masalah yang mungkin terjadi dan mengumpulkan informasi yang diperlukan untuk diberikan ke Microsoft.

Langkah berikutnya

Anda dapat menggunakan tutorial berikut untuk demonstrasi sederhana Device Update for IoT Hub: