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.

Ö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. 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.

   

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

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

    

11. 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>

İ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"

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.

   

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>

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üncelleştirme aracısı tarafından bildirilen model kimliği ve uyumluluk özelliklerinden oluşturulan bağımsız değişkenini alır --class-id .

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