IoT Hub için Azure Cihaz Güncelleştirmesi'ni kullanarak güncelleştirme dağıtma

Bu makalede, Azure portalında veya Azure CLI'da IoT Hub için Azure Cihaz Güncelleştirmesi'ni kullanarak IoT cihazlarına güncelleştirme dağıtmayı öğreneceksiniz.

Important

Planlanan emeklilik tarihlerinden önce Cihaz Güncellemesi veri düzlemi API sürümüne 2026-06-01 geçiş yapın: önizleme API sürümleri için 28 Şubat 2027, API sürümü 2022-10-01için ise 31 Ağustos 2029. Bu sürüm, her yeni dağıtım için cihazların güncelleme içeriğini HTTPS (varsayılan olan) veya HTTP üzerinden indirip indirmediğini seçme imkanı veren indirme güvenliği ekliyor. Daha fazla bilgi için, IoT Hub için Cihaz Güncellemesi bölümünde İndirme Güvenliğini (TLS) Anlama bölümünü inceleyebilirsiniz.

Önkoşullar

• IoT Hubiçin Cihaz Güncelleştirmesi'nin etkinleştirildiği Standart (S1) veya üzeri bir Azure IoT Hub örneği.
• IoT hub'ı içinde Cihaz Güncelleştirmesi için sağlanan bir IoT cihazı veya simülatörü. Sağlanan cihaz, kullanıcı tarafından oluşturulan bir cihaz grubunun veya varsayılan grubun üyesi olabilir.
• Sağlanan cihaz için içeri aktarılan bir güncelleştirme.

Güncelleştirmeyi dağıtma

Bu bölümde, Azure portalını veya Azure CLI'yi kullanarak güncelleştirmenin nasıl dağıtılacağı açıklanmaktadır.

Azure portalı

1. Azure portalında IoT hub'ınıza gidin.

2. Sol gezinti bölmesinde cihaz yönetimi'nin altında Güncelleştirmeler'i seçin.

   

3. Güncelleştirmeler sayfasında Gruplar ve Dağıtımlar sekmesini seçin ve güncelleştirme uyumluluk grafiğinive cihaz grubu listesini görüntüleyin. Cihaz grubunuz için en son içeri aktarılan güncelleştirmeleri görmek için görünümü yenilemeniz gerekebilir.

4. Grup listesindeki Durum'un altında, Bu grup için bir veya daha fazla yeni güncelleştirme kullanılabilir seçeneğinin yanındaki Dağıt'ı seçin.

   

5. Güncelleştirme uyumluluk grafiğini ve grup listesini görüntüleyin. Etiket tabanlı veya varsayılan grubunuz için yeni bir güncelleştirmenin kullanılabilir olduğunu görmeniz gerekir. Bir kez yenilemeniz gerekebilir. Daha fazla bilgi için bkz . Cihaz Güncelleştirmesi uyumluluğu.

6. Kullanılabilir bir veya daha fazla güncelleştirme durumunun yanındaki Dağıt'ı seçin.

7. Sağ taraftaki listeden dağıtmak istediğiniz güncelleştirmeyi seçin.

   

8. İndirme güvenliği için HTTPS (önerilir) veya HTTP seçin. Bu ayar, cihazların güncelleme içeriğini indirmek için kullandığı protokolü kontrol eder. HTTPS varsayılan olarak güncellenen içeriği şifreler.

   Bir protokol seçimi ve cihazlarınızı hazırlama konusunda rehberlik için, Device Update for IoT Hub'daki Download Security (TLS) anlayışına bakınız.

9. Dağıtımınızı hemen veya gelecekte başlayacak şekilde zamanlayın.

   İpucu

   Varsayılan olarak, Başlangıç tarihi ve saati geçerli saatinizden 24 saattir. Dağıtımın er ya da geç başlamasını istiyorsanız farklı bir tarih ve saat seçtiğinizden emin olun.

   

10. Gerekirse otomatik geri alma ilkesi oluşturun. Daha sonra, Oluştur'u seçin.

11. Geçerli güncelleştirmeler sekmesinde dağıtımınızın durumunu görüntüleyebilirsiniz.

    

12. Grup temel bilgileri görünümünde, uyumluluk grafiği güncelleştirmenin devam ettiğini gösterir.

    Cihazınız başarıyla güncelleştirildikten sonra uyumluluk grafiğiniz ve dağıtım ayrıntılarınız bu durumu yansıtacak şekilde güncelleştirilir.

Azure CLI

Aşağıdaki komutları çalıştırmak için Azure Cloud Shell'deki Bash ortamını kullanabilirsiniz. Cloud Shell'i başlatmak için Cloud Shell'i başlat'ı seçin veya Azure portalının üst araç çubuğundaKi Cloud Shell simgesini seçin.

İsterseniz Azure CLI komutlarını yerel olarak da çalıştırabilirsiniz:

1. Azure CLI’yı yükleyin. Yüklü Azure CLI sürümünü ve bağımlı kitaplıkları görmek için az version komutunu çalıştırın ve en son sürümü yüklemek için az upgrade komutunu çalıştırın.
2. az login komutunu çalıştırarak Azure'da oturum açın.
3. İlk kullanımda istendiğinde uzantıyı azure-iot yükleyin. Uzantının en son sürümünü kullandığınızdan emin olmak için komutunu çalıştırın az extension update --name azure-iot.

İpucu

Bu makaledeki Azure CLI komutları, komut bağımsız değişkenlerinin daha kolay okunabilmesi için satır devamı için ters eğik çizgi \ karakterini kullanır. Bu söz dizimi Bash ortamlarında çalışır. Bu komutları PowerShell'de çalıştırırsanız, her ters eğik çizgiyi bir ters eğik çizgi ile değiştirin veya tamamen kaldırın.

Güncelleştirme kullanılabilirliğini doğrulama

1. az iot du device group list Cihaz grubunuzu tanımlamak için komutunu kullanın.

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

2. Ardından grubunuz için en uygun güncelleştirmeyi göstermek için kullanın az iot du device group show . komutu aşağıdaki bağımsız değişkenleri alır:

   • --account: Cihaz Güncelleştirme hesabı adı.
   • --instance: Cihaz Güncelleştirmesi örneği adı.
   • --group-id: Etiketin değeri ADUGroup olan veya $default etiketi olmayan cihazlar için bu dağıtımla hedeflediğiniz cihaz grubu kimliği.
   • --resource-group: Cihaz Güncelleştirme hesabı kaynak grubu adı.
   • --best-updates: Cihaz grubu için kullanılabilir en iyi güncelleştirmeleri döndürür ve her bir güncelleştirmeye kaç cihazın ihtiyacı olduğunu gösterir.
   • --update-compliance: En son güncelleştirmesinde kaç cihazın bulunduğu, kaç yeni güncelleştirme gerektiği ve şu anda yeni bir güncelleştirme alan kaç cihaz olduğu gibi cihaz grubu güncelleştirme uyumluluk bilgilerini döndürür.

   Grubunuz için kullanılabilir en iyi güncelleştirmeyi doğrulamak için komutunu aşağıdaki gibi çalıştırın:

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

Dağıtımı oluşturma

Cihaz grubu için dağıtım oluşturmak için kullanın az iot du device deployment create . komutu aşağıdaki bağımsız değişkenleri alır:

• --account: Cihaz Güncelleştirme hesabı adı.
• --instance: Cihaz Güncelleştirmesi örneği adı.
• --group-id: Etiketin değeri ADUGroup olan veya $default etiketi olmayan cihazlar için bu dağıtımla hedeflediğiniz cihaz grubu kimliği.
• --deployment-id: Bu dağıtımı tanımlamak için bir kimlik.
• --update-name, --update-providerve --update-version: Nesneyi tanımlayan updateId parametreler, bu dağıtımdaki güncelleştirme için benzersiz bir tanımlayıcı.

Komutunu aşağıdaki gibi çalıştırın:

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>

Cihazlar varsayılan olarak HTTPS üzerinden güncelleme içeriğini indirir. HTTP kullanmak için, İstereğe bağlı argümanları kullan bölümünde tanımlanan isteğe --download-security bağlı parametreyi ekleyin.

İsteğe bağlı bağımsız değişkenleri kullanma

İsteğe bağlı bağımsız değişkenler, dağıtımı daha fazla yapılandırmanıza olanak sağlar. İsteğe bağlı bağımsız değişkenlerin tam listesi için bkz . İsteğe bağlı parametreler.

Otomatik geri alma ilkesi oluşturmak için aşağıdaki parametreleri ekleyin:

• --failed-count: Geri alma işlemini tetikleyen bir dağıtımdaki başarısız cihazların sayısı.
• --failed-percentage: Geri alma işlemini tetikleyen bir dağıtımdaki başarısız cihazların yüzdesi.
• --rollback-update-name, --rollback-update-provider, --rollback-update-version: Geri alma başlatılırsa kullanılacak güncelleştirme parametreleri.

Komutunu aşağıdaki gibi çalıştırın:

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>

Dağıtım başlangıç saatini ayarlamak için parametresini --start-time kullanarak dağıtımın hedef tarihini ve saatini aşağıdaki gibi sağlayın:

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"

Cihazların güncelleme içeriğini indirmek için kullandığı protokolü seçmek için isteğe --download-security bağlı parametreyi ekleyin. Kabul edilen değerler HTTPS (önerilir) ve HTTP. Parametreyi atlarsanız, dağıtım varsayılan HTTPS. Bir protokol seçimi ve cihazlarınızı hazırlama konusunda rehberlik için, Device Update for IoT Hub'daki Download Security (TLS) anlayışına bakınız.

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> \
    --download-security <HTTPS or HTTP>

Dağıtım durumunu izleme

Azure portalı

1. Güncelleştirmeler sayfasının Gruplar ve Dağıtımlar sekmesinde dağıtılan grubu seçin.

2. Bir dağıtımın devam ettiğini onaylamak için Grup ayrıntıları sayfasında Geçerli dağıtım veya Dağıtım geçmişi sekmesine gidin.

   

3. Dağıtım ayrıntılarını, güncelleştirme ayrıntılarını ve hedef cihaz sınıfı ayrıntılarını görüntülemek için dağıtımın yanındaki Ayrıntılar'ı seçin. İsteğe bağlı olarak cihaz sınıfı için kolay bir ad ekleyebilirsiniz.

4. En son durum ayrıntılarını görüntülemek için Yenile'yi seçin.

   

Note

Dağıtım detayları, indirme güvenlik ayarını gösteriyor. Dağıtım detaylarını Mevcut dağıtım ve Dağıtım geçmişi sekmelerinden açabilirsiniz. Dağıtımı oluşturduktan sonra bu ayarı değiştiremezsiniz. Farklı bir protokol kullanmak için yeni bir dağıtım oluşturun.

Belirli bir cihazın durumunu aramak için Grup ayrıntıları sayfasının Grup temel bilgileri sekmesine gidin veya dağıtımı başarısız olan cihazları görüntülemek için filtreleyin.

Azure CLI

Bir cihaz grubunun tüm dağıtımlarını görüntülemek için az iot du device deployment list komutunu kullanın.

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

Belirli bir dağıtımın ayrıntılarını görüntülemek için az iot du device deployment show komutunu kullanın.

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>

Note

Komut çıktısı az iot du device deployment show , dağıtım için seçtiğiniz protokolü gösteren özelliği downloadSecurity içerir. Dağıtımı oluşturduktan sonra bu ayarı değiştiremezsiniz. Farklı bir protokol kullanmak için yeni bir dağıtım oluşturun.

Dağıtımda --status devam eden, tamamlanan veya başarısız olan cihaz sayısı hakkında bilgi döndürmek için bayrağını ekleyin.

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

Güncelleştirme dağıtımlarını yeniden deneme

Dağıtımınız başarısız olursa, başarısız cihazlar için dağıtımı yeniden deneyebilirsiniz.

Azure portalı

1. Grup ayrıntıları ekranında Geçerli dağıtım sekmesine gidin.

2. Başarısız cihazları yeniden dene'yi seçin ve onay bildirimini kabul edin.

Azure CLI

Hedef bir cihaz alt grubu için dağıtımı yeniden denemek için az iot du device deployment retry komutunu kullanın.

Bu komut, cihaz güncelleme ajanı tarafından bildirilen model kimliği ve uyumluluk özelliklerinden oluşturulan argümanı --class-id alır:

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>

İlgili içerik

• Cihaz Güncelleştirmesi dağıtımları
• Cihaz Güncelleştirmesi Sorun Giderme Kılavuzu