Aracılığıyla paylaş

IoT Edge’i Güncelleştirme

  • Makale

Şunlar için geçerlidir: IoT Edge 1.5 onay işareti IoT Edge 1.5 IoT Edge 1.4 onay işareti IoT Edge 1.4

Önemli

IoT Edge 1.5 LTS ve IoT Edge 1.4 LTS desteklenen sürümlerdir. IoT Edge 1.4 LTS, 12 Kasım 2024'te kullanım ömrü sona erer.

IoT Edge hizmeti yeni sürümler yayınladığından, en son güncelleştirmeleri ve güvenlik iyileştirmelerini almak için IoT Edge cihazlarınızı güncelleştirin. Bu makalede, yeni bir sürüm kullanılabilir olduğunda IoT Edge cihazlarınızı güncelleştirme hakkında bilgi sağlanır.

Daha yeni bir sürüme geçmek istiyorsanız IoT Edge cihazının iki mantıksal bileşeninin güncelleştirilmiş olması gerekir.

  • Güvenlik alt sistemi - Cihazda çalışır, güvenlik tabanlı görevleri işler ve cihaz başlatıldığında modülleri başlatır. Güvenlik alt sistemi yalnızca cihazın kendisinden güncelleştirilebilir.

  • IoT Edge çalışma zamanı - IoT Edge çalışma zamanı, IoT Edge hub'ı (edgeHub) ve IoT Edge aracısı (edgeAgent) modüllerinden oluşur. Dağıtımınızı nasıl yapılandırdığınıza bağlı olarak, çalışma zamanı cihazdan veya uzaktan güncelleştirilebilir.

Nasıl güncelleştirilir?

Bir cihazdaki güvenlik alt sistemi ve çalışma zamanı kapsayıcılarını güncelleştirmek için bu makalenin bölümlerini kullanın.

Düzeltme eki sürümleri

Düzeltme eki sürümleri arasında yükseltme yaptığınızda (örneğin, 1.4.1'i 1.4.2'ye yükselttiğiniz zaman, güncelleştirme sırası önemli değildir. Güvenlik alt sistemini veya çalışma zamanı kapsayıcılarını diğerlerinden önce veya sonra yükseltebilirsiniz. Düzeltme eki sürümleri arasında güncelleştirme yapmak için:

  1. Güvenlik alt sistemini güncelleştirme
  2. Çalışma zamanı kapsayıcılarını güncelleştirme
  3. Sürümlerin eşleşerek eşleşmedığını doğrulama

Yükseltme işlemiyle ilgili sorunları istediğiniz zaman giderebilirsiniz.

Ana veya ikincil sürümler

Ana veya ikincil sürümler arasında yükseltme yaptığınızda (örneğin, 1.4'ten 1.5'e) hem güvenlik alt sistemini hem de çalışma zamanı kapsayıcılarını güncelleştirin. Bir yayından önce güvenlik alt sistemini ve çalışma zamanı kapsayıcısı sürüm bileşimini test edeceğiz. Ana veya ikincil ürün sürümleri arasında güncelleştirme yapmak için:

  1. Cihazda komutunu sudo systemctl stop iotedge kullanarak IoT Edge'i durdurun ve kaldırın.

  2. Cihazda Docker veya Moby kapsayıcı motorunuzu yükseltin.

  3. Cihazda IoT Edge'i yükleyin.

    kullanarak iotedge config importeski bir yapılandırmayı içeri aktarıyorsanız, oluşturulan /etc/aziot/config.toml dosyanın [agent.config] görüntüsünü edgeAgent için 1.4 görüntüsünü kullanacak şekilde değiştirin.

    Daha fazla bilgi için bkz . IoT Edge cihaz ayarlarını yapılandırma.

  4. IoT Hub'da, en yeni sistem modüllerine başvurmak için modül dağıtımını güncelleştirin.

  5. Cihazda kullanarak IoT Edge'i sudo iotedge config applybaşlatın.

Yükseltme işlemiyle ilgili sorunları istediğiniz zaman giderebilirsiniz.

Güvenlik alt sistemini güncelleştirme

IoT Edge güvenlik alt sistemi, IoT Edge cihazındaki paket yöneticisi kullanılarak güncelleştirilmiş olması gereken bir dizi yerel bileşen içerir.

komutunu iotedge versionkullanarak cihazınızda çalışan güvenlik alt sisteminin sürümünü denetleyin. Windows üzerinde Linux için IoT Edge kullanıyorsanız sürümü denetlemek için Linux sanal makinesinde SSH kullanmanız gerekir.

Linux x64 cihazlarında, güvenlik alt sistemini en son sürüme güncelleştirmek için veya uygun paket yöneticinizi kullanın apt-get .

Güncelleştirme apt:

sudo apt-get update

Not

Microsoft'tan en son depo yapılandırmasını alma yönergeleri için IoT Edge'i yüklemenin ön adımlarına bakın.

Hangi IoT Edge sürümlerinin kullanılabilir olduğunu denetleyin:

apt list -a aziot-edge

IoT Edge'i güncelleştirme:

sudo apt-get install aziot-edge defender-iot-micro-agent-edge

komutunu çalıştırmakapt-get install aziot-edge, güvenlik alt sistemini yükselterek kimlik hizmetiniaziot-identity-service gerekli bağımlılık olarak yükler.

Edge cihazlarınızın güvenlik izlemesini ve sağlamlaştırmasını sağlamak için mikro aracıyı Edge aracısıyla yüklemeniz önerilir. IoT için Microsoft Defender hakkında daha fazla bilgi edinmek için bkz . Cihaz oluşturucuları için IoT için Microsoft Defender nedir?

Ardından, sistemin tamamen güncelleştirildiğinden emin olmak için yapılandırmayı yeniden uygulayın.

sudo iotedge config apply

Çalışma zamanı kapsayıcılarını güncelleştirme

IoT Edge aracısını ve IoT Edge hub kapsayıcılarını güncelleştirme yönteminiz, dağıtımınızda sıralı etiketler (1.5 gibi) veya belirli etiketler (1.5.1 gibi) kullanmanıza bağlıdır.

veya iotedge logs edgeHubkomutlarını iotedge logs edgeAgent kullanarak cihazınızda şu anda IoT Edge aracısının ve IoT Edge hub modüllerinin sürümünü denetleyin. Windows üzerinde Linux için IoT Edge kullanıyorsanız, çalışma zamanı modülü sürümlerini denetlemek için Linux sanal makinesine SSH eklemeniz gerekir.

Konsol günlüklerinde kapsayıcı sürümünün nerede bulunacağı ekran görüntüsü.

IoT Edge etiketlerini anlama

IoT Edge aracısı ve IoT Edge hub görüntüleri, ilişkili oldukları IoT Edge sürümüyle etiketlenir. Çalışma zamanı görüntüleriyle etiketleri kullanmanın iki farklı yolu vardır:

  • Sıralı etiketler - Bu basamaklarla eşleşen en son görüntüyü almak için sürüm numarasının yalnızca ilk iki değerini kullanın. Örneğin, en son 1.5.x sürümüne işaret eden yeni bir sürüm olduğunda 1.5 güncelleştirilir. IoT Edge cihazınızdaki kapsayıcı çalışma zamanı görüntüyü yeniden çekerse, çalışma zamanı modülleri en son sürüme güncelleştirilir. Azure portalından gelen dağıtımlar varsayılan olarak sıralı etiketlere yapılır. Bu yaklaşım geliştirme amacıyla önerilir.

  • Belirli etiketler - Görüntü sürümünü açıkça ayarlamak için sürüm numarasının üç değerini de kullanın. Örneğin, 1.5.0 ilk sürümünden sonra değişmez. Güncelleştirmeye hazır olduğunuzda dağıtım bildiriminde yeni bir sürüm numarası bildirebilirsiniz. Bu yaklaşım üretim amacıyla önerilir.

Sıralı etiket görüntüsünü güncelleştirme

Dağıtımınızda sıralı etiketler kullanıyorsanız (örneğin, mcr.microsoft.com/azureiotedge-hub:1.5) cihazınızdaki kapsayıcı çalışma zamanını görüntünün en son sürümünü çekmeye zorlamanız gerekir.

Görüntünün yerel sürümünü IoT Edge cihazınızdan silin. Windows makinelerinde güvenlik alt sisteminin kaldırılması çalışma zamanı görüntülerini de kaldırır, bu nedenle bu adımı yeniden uygulamanız gerekmez.

docker rmi mcr.microsoft.com/azureiotedge-hub:1.5
docker rmi mcr.microsoft.com/azureiotedge-agent:1.5

Görüntüleri kaldırmak için zorlama -f bayrağını kullanmanız gerekebilir.

IoT Edge hizmeti, çalışma zamanı görüntülerinin en son sürümlerini çeker ve bunları cihazınızda otomatik olarak yeniden başlatır.

Belirli bir etiket görüntüsünü güncelleştirme

Dağıtımınızda belirli etiketler kullanıyorsanız (örneğin, mcr.microsoft.com/azureiotedge-hub:1.4) tek yapmanız gereken dağıtım bildiriminizdeki etiketi güncelleştirmek ve değişiklikleri cihazınıza uygulamaktır.

  1. Azure portalındaki IoT Hub'ında IoT Edge cihazınızı seçin ve Modülleri Ayarla'yı seçin.

  2. Modüller sekmesinde Çalışma Zamanı Ayarları'nı seçin.

  3. Çalışma Zamanı Ayarları'nda Edge Aracısı bölümündeki Görüntü URI değerini istediğiniz sürümle güncelleştirin. Örneğin, mcr.microsoft.com/azureiotedge-agent:1.5 Henüz Uygula'yı seçmeyin.

  4. Edge Hub sekmesini seçin ve Görüntü URI'sini istediğiniz sürümle güncelleştirin. Örneğin, mcr.microsoft.com/azureiotedge-hub:1.5.

  5. Değişiklikleri kaydetmek için Uygula'yı seçin.

  6. Gözden geçir ve oluştur'u seçin, JSON dosyasında görüldüğü gibi dağıtımı gözden geçirin ve Oluştur'u seçin.

İş ortağı modülü URI'lerini güncelleştirme

İş ortağı modülleri kullanıyorsanız, modül dağıtımlarınızı iş ortağı tarafından sağlanan görüntü URI'leriyle güncelleştirin. Güncelleştirilmiş kapsayıcı görüntüsü URI'sini almak için IoT Edge modülü yayımcısına başvurun. Cihaz yapılandırmalarınızı yayımcı tarafından sağlanan yeni görüntü URI'siyle güncelleştirin.

  1. Azure portalında oturum açın ve IoT Hub'ınıza gidin.
  2. Sol bölmede Cihaz yönetimi menüsünün altındaki Cihazlar'ı seçin.
  3. Listeden iş ortağı modülünü kullanan IoT Edge cihazını seçin.
  4. Üst çubukta Modülleri Ayarla'yı seçin.
  5. Yeni görüntü URI'si ile güncelleştirmek istediğiniz IoT Edge iş ortağı modülünü seçin.
  6. Görüntü URI değerini yayımcı tarafından sağlanan yeni görüntü URI'siyle güncelleştirin.
  7. Değişiklikleri kaydetmek için Uygula'yı seçin.
  8. Gözden geçir ve oluştur'u seçin, JSON dosyasında görüldüğü gibi dağıtımı gözden geçirin ve Oluştur'u seçin.

Sürümlerin eşleşerek eşleşmedığını doğrulama

  1. Cihazınızda güvenlik alt sistemi sürümünü denetlemek için kullanın iotedge version . Çıkış ana, ikincil ve düzeltme sürüm numaralarını içerir. Örneğin, iotedge 1.4.2.

  2. Cihaz dağıtım çalışma zamanı ayarlarınızda edgeHub ve edgeAgent görüntü URI sürümlerinin güvenlik alt sisteminin ana ve ikincil sürümüyle eşleşip eşleşmedığını doğrulayın. Güvenlik alt sistemi sürümü 1.4.2 ise, görüntü sürümleri 1.4 olacaktır. Örneğin, mcr.microsoft.com/azureiotedge-hub:1.4 ve mcr.microsoft.com/azureiotedge-agent:1.4.

Not

IoT Edge güvenlik alt sistemi ve çalışma zamanı kapsayıcılarını aynı desteklenen sürüme güncelleştirin. Eşleşmeyen sürümler desteklense de tüm sürüm birleşimleri test edilmemiştir.

Azure IoT Edge'in en son sürümünü bulmak için bkz . Azure IoT Edge sürümleri.

Sorun giderme

Cihazınızdan aşağıdaki komutları çalıştırarak sisteminizin günlüklerini istediğiniz zaman görüntüleyebilirsiniz.

  • Check komutunu kullanarak sorun gidermeye başlayın. Yaygın sorunlar için bir yapılandırma ve bağlantı testleri koleksiyonu çalıştırır.

    sudo iotedge check --verbose

  • IoT Edge sisteminin durumunu görüntülemek için şunu çalıştırın:

    sudo iotedge system status

  • Konak bileşen günlüklerini görüntülemek için şunu çalıştırın:

    sudo iotedge system logs

  • edgeAgent ve edgeHub ile bildirilen yinelenen sorunları denetlemek için şunu çalıştırın:

    değerini kendi modül adınızla değiştirmeyi <module> unutmayın. Sorun yoksa çıkış görmezsiniz.

    sudo iotedge logs <module>

Daha fazla bilgi için bkz . IoT Edge cihazınızda sorun giderme.

Sonraki adımlar

En son Azure IoT Edge sürümlerini görüntüleyin.

Nesnelerin İnterneti blogunda son güncelleştirmeler ve duyurular ile güncel kalın