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

Azure IoT Hub için Cihaz Güncelleştirmesi'ni kullanarak bir IoT cihazına güncelleştirme dağıtmayı öğrenin.

Önkoşullar

• IoT Hub için Cihaz Güncelleştirmesi'nin etkinleştirildiği bir IoT Hub'a erişim. IoT Hub'ınız için bir S1 (Standart) katmanı veya üzerini kullanmanızı öneririz.
• Sağlanan cihaz için içeri aktarılan bir güncelleştirme.
• IoT Hub içinde Cihaz Güncelleştirmesi için sağlanan bir IoT cihazı (veya simülatörü).
• Cihaz, en az bir varsayılan grubun veya kullanıcı tarafından oluşturulan güncelleştirme grubunun bir parçasıdır.

Azure portalı

Desteklenen tarayıcılar:

• Microsoft Edge
• Google Chrome

Azure CLI

Azure CLI ortamı:

• Azure Cloud Shell'de Bash ortamını kullanın.

  

• Veya CLI başvuru komutlarını yerel olarak çalıştırmayı tercih ediyorsanız Azure CLI'yı yükleyin

  1. az login komutunu kullanarak Azure CLI'da oturum açın .
  2. Yüklü sürümü ve bağımlı kitaplıkları bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.
  3. İstendiğinde, azure CLI uzantılarını ilk kullanımda yükleyin. Bu makaledeki komutlar azure-iot uzantısını kullanır. 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 okunması 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ıyorsanız, her ters eğik çizgiyi ''' ters işaretiyle değiştirin veya tamamen kaldırın.

Güncelleştirmeyi dağıtma

Azure portalı

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

2. IoT Hub örneğinizin Cihaz Güncelleştirmesi sayfasını açmak için gezinti menüsünden Güncelleştirmeler seçin.

   

3. Sayfanın üst kısmındaki Gruplar ve Dağıtımlar sekmesini seçin. Daha fazla bilgi için bkz . Cihaz grupları.

   

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

5. Kullanılabilir bir veya daha fazla güncelleştirmenin yanındaki Dağıt'ı seçin ve içeri aktarırken eklediğiniz açıklayıcı etiketin mevcut olduğunu ve doğru göründüğünü onaylayın.

6. Hedef grup olarak doğru grubun seçildiğini onaylayın ve Dağıt'ı seçin.

7. Dağıtımı başlatmak için Geçerli dağıtım sekmesine gidin. Kullanılabilir güncelleştirmeler bölümünden istenen güncelleştirmenin yanındaki Dağıt bağlantısını seçin. Belirli bir grup için kullanılabilir en iyi güncelleştirme, En iyi vurguyla gösterilir.

   

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

   İpucu

   Varsayılan olarak, Başlangıç tarihi ve saati Hemen olarak ayarlanır. Dağıtımın daha sonra 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. Dağıtım ayrıntılarında Durum Etkin'e dönüşür. Dağıtılan güncelleştirme (dağıtım) ile işaretlenir.

    

11. Güncelleştirmenin devam ettiğini görmek için uyumluluk grafiğini görüntüleyin.

    

12. Cihazınız başarıyla güncelleştirildikten sonra uyumluluk grafiğinizin ve dağıtım ayrıntılarınızın da aynı şekilde güncelleştirildiğini görürsünüz.

    

Azure CLI

az iot du device group list grubunuz için en uygun güncelleştirmeyi doğrulamak için. 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: Bu dağıtımda hedeflediğiniz cihaz grubu kimliği. Bu kimlik, ADUGroup etiketinin veya $default etiketi olmayan cihazların değeridir.
• --best-updates: Bu bayrak, komutun cihaz grubu için kullanılabilir en iyi güncelleştirmeleri getirmesi gerektiğini ve her güncelleştirmeye kaç cihaz gerektiğini gösterir.
• '--resource-group -g': Cihaz Güncelleştirme hesabı kaynak grubu adı.
• '--update-compliance': Bu bayrak, komutun en son güncelleştirmesinde kaç cihaz olduğu, kaç yeni güncelleştirmeye ihtiyaç duyduğu ve yeni bir güncelleştirmeyi alırken devam eden kaç cihaz olduğu gibi cihaz grubu güncelleştirme uyumluluk bilgilerini getirmesi gerektiğini gösterir.

az iot du device group list \
    --account <Device Update account name> \
    --instance <Device Update instance name>\
    --gid <device group id>\
    --best-updates {false, true}

Bir cihaz grubu için dağıtım oluşturmak için az iot du device deployment create komutunu kullanın.

komutu device deployment create 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: Bu dağıtımda hedeflediğiniz cihaz grubu kimliği. Bu kimlik, ADUGroup etiketinin veya $default etiketi olmayan cihazların değeridir.
• --deployment-id: Bu dağıtımı tanımlamak için bir kimlik.
• --update-name, --update-providerve --update-version: Bu üç parametre, bu dağıtımda kullandığınız güncelleştirme için benzersiz bir tanımlayıcı olan updateId nesnesini tanımlar.

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şkenler, dağıtımı yapılandırmanıza olanak sağlar. Tam liste için bkz. İsteğe bağlı parametreler

Otomatik geri alma ilkesi oluşturmak istiyorsanız aşağıdaki parametreleri ekleyin:

• --failed-count: Dağıtımda geri alma işlemini tetikleyecek başarısız cihazların sayısı.
• --failed-percentage: Geri alma işlemini tetikleyecek 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 cihaz grubunun kullanacağı güncelleştirmenin updateID değeri.

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ın gelecekte başlatılmasını istiyorsanız, dağıtımın --start-time hedef tarih saatini sağlamak için parametresini kullanı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"

Güncelleştirme dağıtımlarını izleme

Azure portalı

1. Dağıttığınız grubu seçin ve dağıtımın devam ettiğini onaylamak için Geçerli güncelleştirmeler veya Dağıtım geçmişi sekmesine gidin

   

2. Oluşturduğunuz dağıtımın yanındaki Ayrıntılar'ı seçin. Burada 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üleyebilirsiniz. İsteğe bağlı olarak cihaz sınıfı için kolay bir ad ekleyebilirsiniz.

   

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

4. Belirli bir cihazın durumunu aramak için grup temel bilgileri görünümüne gidebilir veya dağıtımda başarısız olan cihazları görüntülemek için filtreleyebilirsiniz

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 bir nedenle 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>

Sonraki adımlar

Yerel kümenizde sorun giderme