Mengimpor pembaruan ke Azure Device Update for IoT Hub
Untuk menyebarkan pembaruan ke perangkat yang menggunakan Azure Device Update for IoT Hub, Anda terlebih dahulu mengimpor file pembaruan ke layanan Pembaruan Perangkat, yang menyimpan pembaruan yang diimpor untuk penyebaran ke perangkat. Dalam artikel ini, Anda mempelajari cara mengimpor pembaruan ke layanan Pembaruan Perangkat dengan menggunakan API portal Azure, Azure CLI, atau Pembaruan Perangkat.
Prasyarat
Akun dan instans Pembaruan Perangkat yang dikonfigurasi dengan hub IoT.
Perangkat atau simulator IoT yang disediakan untuk Pembaruan Perangkat dalam hub IoT.
Perbarui file untuk perangkat Anda, dan file manifes impor terkait yang dibuat dengan mengikuti instruksi di Menyiapkan pembaruan untuk diimpor ke Pembaruan Perangkat.
Akun dan kontainer Azure Storage untuk menyimpan file yang diimpor. Atau, Anda dapat membuat akun penyimpanan dan kontainer baru sebagai bagian dari proses impor berbasis portal Azure.
Penting
Pastikan akun penyimpanan yang Anda gunakan atau buat tidak mengaktifkan titik akhir privat. Untuk melihat apakah titik akhir privat diaktifkan, Anda dapat memeriksa nama akun Azure Storage Anda di bawah Titik akhir privat di Pusat Private Link.
- Browser yang didukung Microsoft Edge atau Google Chrome.
Mengimpor pembaruan
Bagian ini memperlihatkan cara mengimpor pembaruan menggunakan portal Azure atau Azure CLI. Anda juga dapat mengimpor pembaruan dengan menggunakan API Pembaruan Perangkat sebagai gantinya.
Untuk mengimpor pembaruan, Anda terlebih dahulu mengunggah file manifes pembaruan dan impor ke dalam kontainer Azure Storage. Kemudian, Anda mengimpor pembaruan dari Azure Storage ke Device Update for IoT Hub, yang menyimpannya untuk penyebaran ke perangkat.
Di portal Azure, pada halaman hub IoT untuk instans Pembaruan Perangkat Anda, pilih Pembaruan manajemen>perangkat dari navigasi kiri.
Pada halaman Pembaruan , pilih Impor pembaruan baru.
Pada halaman Impor pembaruan , pilih Pilih dari kontainer penyimpanan.
Pada halaman Akun penyimpanan , pilih akun penyimpanan yang sudah ada atau buat akun baru dengan memilih Akun penyimpanan. Anda menggunakan akun penyimpanan untuk kontainer untuk menahapkan file pembaruan.
Pada halaman Kontainer , pilih kontainer yang sudah ada atau buat kontainer baru dengan memilih Kontainer. Anda menggunakan kontainer untuk menahapkan file pembaruan untuk diimpor.
Tip
Menggunakan kontainer baru setiap kali Anda mengimpor pembaruan membantu mencegah impor file secara tidak sengaja dari pembaruan sebelumnya. Jika Anda tidak menggunakan kontainer baru, pastikan untuk menghapus file sebelumnya dari kontainer yang ada.
Pada halaman kontainer, pilih Unggah.
Pada layar Unggah blob, pilih ikon folder di samping File. Gunakan pemilih file untuk menavigasi ke lokasi file manifes pembaruan dan impor Anda, pilih file, lalu pilih Buka. Anda dapat menggunakan tombol Shift untuk memilih beberapa file.
Setelah Anda memilih semua file, pilih Unggah.
Setelah diunggah, file muncul di halaman kontainer. Pada halaman kontainer, tinjau dan pilih file yang akan diimpor, lalu pilih Pilih.
Pada layar Impor pembaruan, pilih Impor pembaruan.
Proses impor dimulai, dan layar beralih ke layar Pembaruan . Setelah impor berhasil, impor akan muncul di tab Pembaruan . Untuk mengatasi kesalahan apa pun, lihat Pemecahan masalah pembaruan proksi.
Mengimpor menggunakan API Pembaruan Perangkat
Anda juga dapat mengimpor pembaruan secara terprogram dengan menggunakan salah satu metode berikut:
- API Pembaruan Perangkat di Azure SDK untuk .NET, Java, JavaScript, atau Python
- REST API Pembaruan Impor Pembaruan Perangkat
- Sampel modul PowerShell (memerlukan PowerShell 5 atau yang lebih baru untuk Linux, macOS, atau Windows)
Catatan
Lihat Peran dan akses pengguna Pembaruan Perangkat untuk izin API yang diperlukan.
File pembaruan dan manifes impor harus diunggah ke kontainer Azure Storage Blob untuk penahapan. Untuk mengimpor file bertahap, berikan URL blob, atau tanda tangan akses bersama (SAS) untuk blob pribadi, ke API Pembaruan Perangkat. Jika menggunakan SAS, pastikan untuk memberikan jendela kedaluwarsa tiga jam atau lebih.
Tip
Untuk mengunggah file pembaruan besar ke kontainer Azure Storage Blob, Anda dapat menggunakan salah satu metode berikut untuk performa yang lebih baik: