IoT Hub için Cihaz Güncelleştirmesi'ne güncelleştirme aktarma

Yeni bir güncelleştirmeyi nasıl edineceğinizi ve IoT Hub için Cihaz Güncelleştirmesi'ne nasıl aktaracağınızı öğrenin. Henüz yapmadıysanız, önemli içeri aktarma kavramlarını ve içeri aktarılacak güncelleştirmeyi nasıl hazırlayabileceğinizi gözden geçirmeyi unutmayın.

Önkoşullar

• IoT Hub için Cihaz Güncelleştirmesi'nin etkinleştirildiği bir IoT Hub'a erişim.
• IoT Hub içinde Cihaz Güncelleştirmesi için sağlanan bir IoT cihazı (veya simülatörü).
• Güncelleştirme dosyalarınız için içeri aktarma bildirimi oluşturmak üzere IoT Hub için Cihaz Güncelleştirmesi'ne aktarmak üzere güncelleştirme hazırlama makalesindeki adımları izleyin.

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 içeri aktarma

Bu bölümde, Azure portalını veya Azure CLI'yi kullanarak bir güncelleştirmeyi içeri aktarma işlemi gösterilmektedir. Bunun yerine bir güncelleştirmeyi içeri aktarmak için IoT Hub API'leri için Cihaz Güncelleştirmesi'ni de kullanabilirsiniz.

Bir güncelleştirmeyi içeri aktarmak için önce güncelleştirme dosyalarını karşıya yükler ve bildirimi bir Azure Depolama kapsayıcısına aktarırsınız. Ardından, güncelleştirmeyi Azure Depolama'dan IoT Hub için Cihaz Güncelleştirmesi'ne aktarırsınız ve burada cihazlara dağıtmanız için depolanır.

Azure portalı

1. Azure portalında Cihaz Güncelleştirmesi ile IoT Hub'ınıza gidin.

2. Sayfanın sol tarafında Cihaz Yönetimi altındaki Güncelleştirmeler seçin.

   

3. Ekranın üst kısmındaki sekmeler listesinden Güncelleştirmeler sekmesini seçin.

   

4. Kullanılabilir Güncelleştirmeler üst bilgisinin altında + Yeni güncelleştirmeyi içeri aktar'ı seçin.

   

5. Depolama kapsayıcısından + Seç'i seçin. Depolama hesapları kullanıcı arabirimi gösterilir. Var olan bir hesabı seçin veya + Depolama hesabı kullanarak bir hesap oluşturun. Bu hesap, kapsayıcının güncelleştirmelerinizi içeri aktarma için hazırlaması için kullanılır. Hesapta hem genel hem de özel uç noktaların aynı anda etkinleştirilmemesi gerekir.

   

6. bir Depolama hesabı seçtikten sonra Kapsayıcılar kullanıcı arabirimi gösterilir. Var olan bir kapsayıcıyı seçin veya + Kapsayıcı kullanarak bir kapsayıcı oluşturun. Bu kapsayıcı, güncelleştirme dosyalarınızı içeri aktarmaya hazırlamak için kullanılır

   Bir güncelleştirmeyi her içeri aktardığınızda yeni bir kapsayıcı kullanmanızı öneririz. Her zaman yeni kapsayıcılar kullanmak, önceki güncelleştirmelerden dosyaları yanlışlıkla içeri aktarmaktan kaçınmanıza yardımcı olur. Yeni bir kapsayıcı kullanmıyorsanız, bu adımı tamamlamadan önce var olan kapsayıcıdaki dosyaları sildiğinizden emin olun.

   

7. Kapsayıcınızda Karşıya Yükle'yi seçin. Karşıya Yükleme kullanıcı arabirimi gösterilir.

   

8. Blobu karşıya yükle üst bilgisinin altındaki Dosyalar bölümünün sağ tarafındaki klasör simgesini seçin. Dosya seçiciyi kullanarak güncelleştirme dosyalarınızın konumuna gidin ve bildirimi içeri aktarın, tüm dosyaları seçin ve ardından Aç'ı seçin. Shift tuşunu basılı tutarak çoklu seçim dosyalarına tıklayabilirsiniz.

   

9. Tüm güncelleştirme dosyalarınızı seçtiğinizde Karşıya Yükle'yi seçin.

   

10. Karşıya yüklenen dosyaları içeri aktarılacak şekilde ayarlamak için seçin. Ardından Seç düğmesini seçerek güncelleştirmeyi içeri aktar sayfasına dönün.

    

11. Güncelleştirmeyi içeri aktar sayfasında, içeri aktarılacak dosyaları gözden geçirin. Ardından içeri aktarma işlemini başlatmak için Güncelleştirmeyi içeri aktar'ı seçin. Hataları çözmek için bkz . Ara sunucu güncelleştirme sorunlarını giderme.

    

12. İçeri aktarma işlemi başlar ve ekran İçeri Aktarma Geçmişi bölümüne geçer. İçeri aktarma işlemi tamamlanana kadar ilerleme durumunu görüntülemek için Yenile'yi seçin (güncelleştirmenin boyutuna bağlı olarak işlem birkaç dakika içinde tamamlanabilir ancak daha uzun sürebilir).

    

13. Durum sütunu içeri aktarma işleminin başarılı olduğunu gösterdiğinde Kullanılabilir Güncelleştirmeler üst bilgisini seçin. İçeri aktarılan güncelleştirmenizi şimdi listede görmeniz gerekir.

    

Azure CLI

az iot du update stage komutu, güncelleştirme dosyalarını hedef depolama kapsayıcısına yükleme dahil olmak üzere bir güncelleştirmeyi içeri aktarmanın önkoşul adımlarını işler. İsteğe bağlı bir bayrak, bu komutun hazırlandıktan sonra dosyaları otomatik olarak içeri aktarmasına da olanak tanır. Aksi takdirde az iot du update import komutu işlemi tamamlar.

komutu stage 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ı.
• --manifest-path: Hazırlaması gereken içeri aktarma bildiriminin dosya yolu.
• --storage-account: Güncelleştirmeyi hazırlamak için depolama hesabının adı.
• --storage-container: Güncelleştirmeyi hazırlamak için seçilen depolama hesabı içindeki kapsayıcının adı.
• --overwrite: Çakışma olması durumunda depolama kapsayıcısında var olan blobların üzerine yazıp yazılmayacağını gösteren isteğe bağlı bayrak.
• --then-import: Güncelleştirmenin hazırlandıktan sonra Cihaz Güncelleştirmesi'ne içeri aktarılıp aktarılmayacağını gösteren isteğe bağlı bayrak.

az iot du update stage \
    --account <Replace with your Device Update account name> \
    --instance <Replace with your Device Update instance name> \
    --manifest-path <Replace with the full path to your import manifest> \
    --storage-account <Replace with your Storage account name> \
    --storage-container <Replace with your container name> \
    --overwrite --then-import

Örneğin:

az iot du update stage \
    --account deviceUpdate001 \
    --instance myInstance \
    --manifest-path /my/apt/manifest/file.importmanifest.json \
    --storage-account deviceUpdateStorage \
    --storage-container deviceUpdateDemo \
    --overwrite --then-import

Birden çok içeri aktarma bildiriminiz varsa, bunların tümünü tek bir komuta ekleyebilirsiniz. Örneğin:

az iot du update stage \
    --account deviceUpdate001 \
    --instance myInstance \
    --manifest-path /my/apt/manifest/parent.importmanifest.json \
    --manifest-path /my/apt/manifest/child1.importmanifest.json \
    --manifest-path /my/apt/manifest/child2.importmanifest.json \
    --storage-account deviceUpdateStorage \
    --storage-container deviceUpdateDemo \
    --overwrite --then-import

bayrağını --then-import kullanmazsanız, komutun çıktısı stage önceden doldurulmuş bağımsız değişkenler de dahil olmak üzere az iot du update import komutunu çalıştırma istemi içerir.

Güncelleştirmenizin veya güncelleştirmelerinizin başarıyla içeri aktarıldığını doğrulamak için az iot du update list komutunu kullanın.

az iot du update list \
    --account <Replace with your Device Update account name> \
    --instance <Replace with your Device Update instance name> \
    -o table

Bunun yerine API'leri kullanarak içeri aktarıyorsanız

Ayrıca bir güncelleştirmeyi şu yollarla program aracılığıyla içeri aktarabilirsiniz:

• .NET, Java, JavaScript veya Python için kullanma Azure SDK
• İçeri Aktarma Güncelleştirmesi REST API'sini kullanma
• Örnek PowerShell modüllerini kullanma
  • PowerShell 5 veya üzerini gerektirir (Linux, macOS ve Windows yüklemelerini içerir)

Not

Gerekli API izni için Cihaz güncelleştirme kullanıcı rolleri ve erişimine bakın.

Dosyaları güncelleştirme ve içeri aktarma bildiriminin hazırlama için bir Azure Depolama Blob kapsayıcısına yüklenmesi gerekir. Hazırlanan dosyaları içeri aktarmak için Blob URL'sini veya özel bloblar için paylaşılan erişim imzasını (SAS) Cihaz Güncelleştirme API'sine sağlayın. SAS kullanıyorsanız üç saat veya daha fazla süre sonu penceresi sağladığından emin olun

İpucu

Büyük güncelleştirme dosyalarını Azure Depolama Blob kapsayıcısına yüklemek için daha iyi performans için aşağıdakilerden birini kullanabilirsiniz:

• AzCopy
• Azure Depolama Gezgini

Sonraki Adımlar

• Grup Oluştur
• İçeri aktarma kavramları hakkında bilgi edinin