Cihazları ve grupları en son IoT Hub için Cihaz Güncelleştirmesi sürümüne geçirme

Makale
11/08/2023

IoT Hub için Cihaz Güncelleştirmesi hizmeti yeni sürümler yayımladıkça en son özellikler ve güvenlik geliştirmeleri için cihazlarınızı güncelleştirmek isteyeceksiniz. Bu makalede [Genel Önizleme Yenilemesi(PPR) sürümünden geçerli GA sürümüne geçiş hakkında bilgi sağlanır. Bu makalede, bu sürümlerdeki grup ve UX davranışı da açıklanmaktadır. Genel Önizleme Yenileme sürümünü kullanan cihazlarınız, gruplarınız ve dağıtımlarınız yoksa, bu sayfayı yoksayabilirsiniz.

Geçişi başarıyla yapmak için cihazlarınızda çalışan DU aracısını yükseltmeniz gerekir. GA sürümünde önemli değişiklikler olduğundan, hataları önlemek için yönergeleri yakından izlemenizi öneririz.

Dekont

Oluşturulan tüm PPR cihaz grupları otomatik olarak GA gruplarına değiştirilir. Gruplar ve cihazlar geçiş sonrasında kullanılabilir olacaktır. Dağıtım geçmişi güncelleştirilmiş GA gruplarına taşınmayacak.

Cihaz Güncelleştirme aracısını güncelleştirme

GA sürümü için, Cihaz Güncelleştirme aracısı el ile veya apt bildirimi veya görüntü güncelleştirmeleri kullanılarak Cihaz Güncelleştirme Hizmeti kullanılarak güncelleştirilebilir. Görüntü güncelleştirmelerini kullanıyorsanız ga cihaz güncelleştirme aracısını güncelleştirmenize ekleyebilirsiniz.

El ile DU Aracısı Yükseltmesi

Cihazınızı güncelleştirmeden önce cihaz öznitelikleri PPR PnP modeli ayrıntılarını içerir. Sözleşme Modeli Adı Cihaz Güncelleştirme Modeli V1'i, Sözleşme Modeli Kimliği ise dtmi:azure:iot:deviceUpdateContractModel; 1.

Cihazınıza SSH gönderin ve Cihaz Güncelleştirmesi aracısını güncelleştirin.

sudo apt install deviceupdate-agent
sudo systemctl restart deviceupdate-agent
sudo systemctl status deviceupdate-agent

DU aracısının doğru çalıştığını onaylayın. 'HealthCheck başarılı oldu' araması
```
sudo -u adu /usr/bin/AducIotAgent -h  
```
Cihaz Güncelleştirme portalında güncelleştirilmiş cihaza bakın. Cihaz öznitelikleri artık güncelleştirilmiş PnP modeli ayrıntılarını gösterir. Sözleşme Modeli Adı Cihaz Güncelleştirme Modeli V2'yi, Sözleşme Modeli Kimliği ise dtmi:azure:iot:deviceUpdateContractModel; 2.

OTA DU Aracı Yükseltmesi ancak APT bildirimi

Cihazlarınızı güncelleştirmeden önce cihaz öznitelikleri PPR PnP modeli ayrıntılarını içerir. Sözleşme Modeli Adı Cihaz Güncelleştirme Modeli V1'i, Sözleşme Modeli Kimliği ise dtmi:azure:iot:deviceUpdateContractModel; 1.

Cihaz güncelleştirme aracısı yükseltmesini güncelleştirmenizin son adımı olarak ekleyin. doğru cihazlara hedeflendiğinden emin olmak için içeri aktarma bildirimi sürümü "4.0" olmalıdır. Aşağıdaki örnek içeri aktarma bildirimine ve APT bildirimine bakın:

Örnek İçeri Aktarma Bildirimi

{
   "manifestVersion": "4",
   "updateId": {
     "provider": "Contoso",
     "name": "Sensor",
     "version": "1.0"
   },
   "compatibility": [
     {
       "manufacturer": "Contoso",
       "model": "Sensor"
     }
   ],
   "instructions": {
     "steps": [
       {
     "handler": "microsoft/apt:1",
     "handlerProperties": {
       "installedCriteria": "1.0"
     },
     "files": [
       "fileId0"
     ]
       }
     ]
   },
   "files": {
     "fileId0": {
       "filename": "sample-upgrade-apt-manifest.json",
       "sizeInBytes": 210,
       "hashes": {
     "sha256": "mcB5SexMU4JOOzqmlJqKbue9qMskWY3EI/iVjJxCtAs="
       }
     }
   },
   "createdDateTime": "2022-08-20T18:32:01.8404544Z"
 }

Örnek APT bildirimi

  {
    "name": "Sample DU agent upgrade update",
    "version": "1.0.0",
    "packages": [
    {
        "name": "deviceupdate-agent"
    }
    ]
}

Dekont

Aracı yükseltmesinin son adım olması gerekir. Aracı yükseltmeden önce başka adımlarınız olabilir. Aracı yükseltmesi sonrasında eklenen adımlar yürütülmeyecek ve cihaz DU hizmetine yeniden bağlandığında doğru şekilde bildirilecektir.

Güncelleştirmeyi dağıtın.
Güncelleştirme başarıyla dağıtıldıktan sonra cihaz öznitelikleri artık güncelleştirilmiş PnP modeli ayrıntılarını gösterecektir. Sözleşme Modeli Adı Cihaz Güncelleştirme Modeli V2'yi, Sözleşme Modeli Kimliği ise dtmi:azure:iot:deviceUpdateContractModel; 2.

Sürümler arasında grup ve dağıtım davranışı

Genel Önizleme Yenileme DU aracısı (0.8.x) ve GA DU aracısı (1.0.x) olan cihaz, Cihaz Güncelleştirme portalı üzerinden yönetilebilir.
Eski aracıları (0.7.0/0.6.0) olan cihazlar bu gruplara eklenemez.

Sonraki adımlar

Cihaz Güncelleştirmesi aracı yapılandırma dosyasını anlama

IoT Hub için Cihaz Güncelleştirmesi'nin basit bir tanıtımı için aşağıdaki öğreticileri kullanabilirsiniz:

Aracılığıyla paylaş