Menyebarkan pembaruan dengan menggunakan Azure Device Update for IoT Hub

1. Di portal Azure, navigasi ke hub IoT Anda.

2. Pilih Pembaruan di bawah Manajemen perangkat di navigasi kiri.

   

3. Pada halaman Pembaruan , pilih tab Grup dan Penyebaran dan lihat bagan kepatuhan pembaruan dan daftar grup perangkat. Anda mungkin perlu menyegarkan tampilan untuk melihat pembaruan yang baru-baru ini diimpor yang tersedia untuk grup perangkat Anda.

4. Di bawah Status dalam daftar grup, pilih Sebarkan di samping Satu atau beberapa pembaruan baru tersedia untuk grup ini.

   

5. Lihat bagan kepatuhan pembaruan dan daftar grup. Anda akan melihat pembaruan baru yang tersedia untuk grup berbasis tag atau default Anda. Anda mungkin perlu refresh lagi. Untuk informasi selengkapnya, lihat Kepatuhan Pembaruan Perangkat.

6. Pilih Sebarkan di samping satu atau beberapa status pembaruan yang tersedia .

7. Dari daftar di sebelah kanan, pilih pembaruan yang diinginkan untuk disebarkan.

   

8. Jadwalkan penyebaran Anda untuk segera dimulai atau di masa mendatang.

   Tip

   Secara default, tanggal dan waktu Mulai adalah 24 jam dari waktu Anda saat ini. Pastikan untuk memilih tanggal dan waktu yang berbeda jika Anda ingin penyebaran dimulai cepat atau lambat.

   

9. Buat kebijakan putar kembali otomatis jika diperlukan. Lalu pilih Buat.

10. Di tab Pembaruan saat ini, Anda dapat melihat status penyebaran Anda.

    

11. Dalam tampilan Dasar-dasar grup, bagan kepatuhan menunjukkan bahwa pembaruan sekarang sedang berlangsung.

    Setelah perangkat Anda berhasil diperbarui, bagan kepatuhan dan pembaruan detail penyebaran Anda untuk mencerminkan status tersebut.

Anda dapat menggunakan lingkungan Bash di Azure Cloud Shell untuk menjalankan perintah berikut. Pilih Luncurkan Cloud Shell untuk membuka Cloud Shell, atau pilih ikon Cloud Shell di toolbar atas portal Azure.

Atau, jika mau, Anda dapat menjalankan perintah Azure CLI secara lokal:

1. Menginstal Azure CLI Jalankan versi az untuk melihat versi Azure CLI yang diinstal dan pustaka dependen, dan jalankan peningkatan az untuk menginstal versi terbaru.
2. Masuk ke Azure dengan menjalankan masuk az.
3. azure-iot Instal ekstensi saat diminta pada penggunaan pertama. Untuk memastikan Anda menggunakan versi terbaru ekstensi, jalankan az extension update --name azure-iot.

Memverifikasi ketersediaan pembaruan

1. az iot du device group list Gunakan perintah untuk mengidentifikasi grup perangkat Anda.

   az iot du device group list \
       --account <Device Update account name> \
       --instance <Device Update instance name>\
   

2. Kemudian gunakan az iot du device group show untuk menampilkan pembaruan terbaik yang tersedia untuk grup Anda. Perintah mengambil argumen berikut:

   • --account: Nama akun Pembaruan Perangkat.
   • --instance: Nama instans Pembaruan Perangkat.
   • --group-id: ID grup perangkat yang Anda targetkan dengan penyebaran ini, yang merupakan nilai ADUGroup tag, atau $default untuk perangkat tanpa tag.
   • --resource-group: Nama grup sumber daya akun Pembaruan Perangkat.
   • --best-updates: Mengembalikan pembaruan terbaik yang tersedia untuk grup perangkat, termasuk hitungan berapa banyak perangkat yang memerlukan setiap pembaruan.
   • --update-compliance: Mengembalikan informasi kepatuhan pembaruan grup perangkat, seperti berapa banyak perangkat pada pembaruan terbaru mereka, berapa banyak yang memerlukan pembaruan baru, dan berapa banyak yang saat ini menerima pembaruan baru.

   Untuk memverifikasi pembaruan terbaik yang tersedia untuk grup Anda, jalankan perintah sebagai berikut:

   az iot du device group show \
       --account <Device Update account name> \
       --instance <Device Update instance name>\
       --group-id <device group ID>\
       --best-updates
   

Membuat penyebaran

Gunakan az iot du device deployment create untuk membuat penyebaran untuk grup perangkat. Perintah mengambil argumen berikut:

• --account: Nama akun Pembaruan Perangkat.
• --instance: Nama instans Pembaruan Perangkat.
• --group-id: ID grup perangkat yang Anda targetkan dengan penyebaran ini, yang merupakan nilai ADUGroup tag, atau $default untuk perangkat tanpa tag.
• --deployment-id: ID untuk mengidentifikasi penyebaran ini.
• --update-name, , --update-providerdan --update-version: Parameter yang menentukan updateId objek, pengidentifikasi unik untuk pembaruan dalam penyebaran ini.

Jalankan perintah sebagai berikut:

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version>

Menggunakan argumen opsional

Argumen opsional memungkinkan Anda untuk mengonfigurasi penyebaran lebih lanjut. Untuk daftar lengkap argumen opsional, lihat Parameter opsional.

Untuk membuat kebijakan putar kembali otomatis, tambahkan parameter berikut:

• --failed-count: Jumlah perangkat yang gagal dalam penyebaran yang memicu pemutaran kembali.
• --failed-percentage: Persentase perangkat yang gagal dalam penyebaran yang memicu pembatalan.
• --rollback-update-name, , --rollback-update-provider--rollback-update-version: Parameter untuk pembaruan yang akan digunakan jika pembatalan dimulai.

Jalankan perintah sebagai berikut:

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version> \
    --failed-count 10 \
    --failed-percentage 5 \
    --rollback-update-name <rollback update name> \
    --rollback-update-provider <rollback update provider> \
    --rollback-update-version <rollback update version>

Untuk mengatur waktu mulai penyebaran, gunakan --start-time parameter untuk memberikan tanggal dan waktu target untuk penyebaran, sebagai berikut:

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id> \
    --deployment-id <deployment id> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version> \
    --start-time "2022-12-20T01:00:00"

1. Pada tab Grup dan Penyebaran di halaman Pembaruan , pilih grup yang Anda sebarkan.

2. Pada halaman Detail grup, buka tab Penyebaran atau Riwayat penyebaran saat ini untuk mengonfirmasi bahwa penyebaran sedang berlangsung.

   

3. Pilih Detail di samping penyebaran untuk melihat detail penyebaran, detail pembaruan, dan detail kelas perangkat target. Anda dapat secara opsional menambahkan nama yang mudah diingat untuk kelas perangkat.

4. Pilih Refresh untuk melihat detail status terbaru.

   

Buka tab Dasar grup dari halaman Detail grup untuk mencari status perangkat tertentu, atau filter untuk melihat perangkat yang gagal dalam penyebaran.

Gunakan daftar penyebaran perangkat az iot du untuk melihat semua penyebaran untuk grup perangkat.

az iot du device deployment list \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id>

Gunakan az iot du device deployment show untuk melihat detail penyebaran tertentu.

az iot du device deployment show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID>

--status Tambahkan bendera untuk mengembalikan informasi tentang berapa banyak perangkat dalam penyebaran yang sedang berlangsung, selesai, atau gagal.

az iot du device deployment show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID> \
    --status

1. Buka tab Penyebaran saat ini pada layar Detail grup.

2. Pilih Coba lagi perangkat yang gagal dan terima pemberitahuan konfirmasi.

Gunakan coba lagi penyebaran perangkat az iot du untuk mencoba kembali penyebaran untuk subgrup target perangkat.

Perintah ini mengambil --class-id argumen, yang dihasilkan dari ID model dan properti kompatibilitas yang dilaporkan oleh agen pembaruan perangkat.

az iot du device deployment retry \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --deployment-id <deployment ID> \
    --group-id <device group ID> \
    --class-id <device class ID>