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

IoT Hub için Azure Cihaz Güncelleştirmesi'ni kullanarak cihazlara güncelleştirme dağıtmak için, önce güncelleştirme dosyalarını cihazlara dağıtım için içeri aktarılan güncelleştirmeyi depolayan Cihaz Güncelleştirme hizmetine aktarırsınız. Bu makalede Azure portalı, Azure CLI veya Cihaz Güncelleştirmesi API'lerini kullanarak bir güncelleştirmeyi Cihaz Güncelleştirme hizmetine aktarmayı öğreneceksiniz.

Önkoşullar

• Bir IoT hub ile yapılandırılmış Device Update hesabı ve örneği.

• IoT hub'ı içinde Cihaz Güncelleştirmesi için sağlanan bir IoT cihazı veya simülatörü.

• Cihazınız için dosyaları ve Cihaz Güncelleştirmesi’ne aktarılacak bir güncelleştirme hazırlama bölümündeki yönergeler izlenerek oluşturulan ilgili içe aktarma bildirim dosyasını güncelleştirin.

• İçeri aktarılan dosyaları depolamak üzere bir Azure Depolama hesabı ve kapsayıcısı. Alternatif olarak, Azure portalı tabanlı içeri aktarma işleminin bir parçası olarak yeni bir depolama hesabı ve kapsayıcı oluşturabilirsiniz.

  Önemli

  Kullandığınız veya oluşturduğunuz depolama hesabında özel uç noktaların etkin olmadığından emin olun. Özel uç noktaların etkinleştirilip etkinleştirilmediğini görmek için, Özel Bağlantı Merkezi'ndeki Özel uç noktalar altında Azure Depolama hesabınızın adını de kontrol edebilirsiniz.

Azure portalı

• Desteklenen tarayıcılar Microsoft Edge veya Google Chrome.

Azure CLI

• Bash ortamı.

  Bu makaledeki 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ım sırasında istendiğinde azure-iot uzantısını 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 ters tırnak (`) ile 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 Cihaz Güncelleştirme API'lerini kullanarak da güncelleştirmeyi içeri aktarabilirsiniz.

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

Azure portalı

1. Azure portalında, Cihaz Güncelleştirmesi örneğinizin IoT hub sayfasında, sol gezintide >Güncelleştirmeler öğesini seçin.

   

2. Güncelleştirmeler sayfasında Yeni güncelleştirmeyi içeri aktar'ı seçin.

   

3. Güncelleştirme içeri aktar sayfasında Depolama kapsayıcısından seçin seçeneğini belirleyin.

4. Depolama hesapları sayfasında mevcut bir depolama hesabını seçin veya Depolama hesabı'nı seçerek yeni bir hesap oluşturun. Güncelleştirme dosyalarını hazırlamak için kapsayıcının depolama hesabını kullanırsınız.

5. Kapsayıcılar sayfasında mevcut bir kapsayıcıyı seçin veya Kapsayıcı'yı seçerek yeni bir kapsayıcı oluşturun. İçeri aktarma için güncelleştirme dosyalarını hazırlamak için kapsayıcıyı kullanırsınız.

   

   İpucu

   Bir güncelleştirmeyi her içeri aktardığınızda yeni bir kapsayıcı kullanmak, önceki güncelleştirmelerden dosyaların yanlışlıkla içeri aktarılmasını önlemeye yardımcı olur. Yeni bir kapsayıcı kullanmıyorsanız, var olan kapsayıcıdan önceki dosyaları sildiğinizden emin olun.

6. Kapsayıcı sayfasında, Yükle seçeneğini belirleyin.

   

7. Blob yükle ekranında, Dosyalar öğesinin yanındaki klasör simgesini seçin. Dosya seçiciyi kullanarak güncelleştirmenizin konumuna gidin ve bildirim dosyalarını içeri aktarın, dosyaları seçin ve ardından Aç'ı seçin. Dosyaları çoklu seçmek için Shift tuşunu kullanabilirsiniz.

   

8. Tüm dosyaları seçtikten sonra, Karşıya Yükle'yi seçin.

   

9. Yüklendikten sonra dosyalar kapsayıcı sayfasında görünür. Kapsayıcı sayfasında, içeri aktaracak dosyaları gözden geçirip seçin ve ardından Seç'i seçin.

   

10. Güncelleştirme içe aktar ekranında, Güncelleştirme içe aktar seçeneğini belirleyin.

    

İçeri aktarma işlemi başlar ve ekran Güncelleştirmeler ekranına geçer. İçeri aktarma işlemi başarılı olduktan sonra, Güncelleştirmeler sekmesinde görünür. Hataları gidermek için bkz. Proxy güncelleştirme sorunlarını giderme.

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 dosyaları hazırladıktan sonra otomatik olarak içeri aktarmasına da olanak tanır. Aksi takdirde, az iot du update import komutu işlemi tamamlar.

stage 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ı.
• --manifest-path: Hazırlanacak içe aktarma bildiriminin dosya yolu.
• --storage-account: Güncelleştirmenin hazır olduğu 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ırladı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

Tek bir komuta birden çok içeri aktarma bildirimi 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

--then-import bayrağını kullanmazsanız, stage komutunun çıktısı, önceden doldurulmuş argümanlarla az iot du update import komutunu çalıştırmanız için bir istem içerir.

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

Cihaz Güncelleştirme API'lerini kullanarak içeri aktarma

Ayrıca aşağıdaki yöntemlerden birini kullanarak bir güncelleştirmeyi program aracılığıyla içeri aktarabilirsiniz:

• .NET, Java, JavaScript veya Python için Azure SDK'larındaki Cihaz Güncelleştirme API'leri
• Aygıt Güncelleştirmesi İçe Aktarma Güncelleştirmesi REST API’si
• Örnek PowerShell modülleri (Linux, macOS veya Windows için PowerShell 5 veya üzerini gerektirir)

Not

Gerekli API izni için Cihaz Güncelleştirmesi kullanıcı rolleri ve erişim bölümüne bakın.

Güncelleştirme dosyaları ve içe aktarma bildirimi, hazırlık amacıyla bir Azure Depolama Blob kapsayıcısına yüklenmelidir. 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ı bir Azure Depolama Blob kapsayıcısına yüklemek için, daha iyi performans için aşağıdaki yöntemlerden birini kullanabilirsiniz:

• AzCopy
• Azure Depolama Gezgini

İlgili içerik

• Cihaz grupları
• Cihaz Güncelleştirmesi içe aktarma bildirim dosyası