Hızlı Başlangıç: İlk IoT Edge modülünüzü bir Windows cihazına dağıtma

Şunlar için geçerlidir:evet simgesi IoT Edge 1.1

Önemli

IoT Edge 1.1 destek sonu tarihi 13 Aralık 2022. Bu ürünün, hizmetin, teknolojinin veya API’nin nasıl desteklendiği hakkında bilgi edinmek için Microsoft Ürün Yaşam Döngüsü’ne göz atın. IoT Edge'in en son sürümüne güncelleme hakkında daha fazla bilgi için IoT Edge'i Güncelleştirin bölümüne bakın.

Kapsayıcılı kodu Windows IoT Edge cihazında bir Linux'a dağıtarak bu hızlı başlangıçta Azure IoT Edge'i deneyin. IoT Edge, iş yüklerinizin daha fazlasını uçlara gönderebilmek için cihazlarınızdaki kodu uzaktan yönetmenize olanak tanır. Bu hızlı başlangıçta, Windows üzerinde Linux için Azure IoT Edge'i kullanmanın ne kadar kolay olduğunu görmek için kendi Windows İstemci cihazınızı kullanmanızı öneririz. Dağıtımınızı oluşturmak için Windows Server veya Azure VM kullanmak istiyorsanız, Bir Windows cihazına Linux için Azure IoT Edge'i yükleme ve sağlama ile ilgili nasıl yapılır kılavuzundaki adımları izleyin.

Bu hızlı başlangıçta şunları yapmayı öğreneceksiniz:

• Bir IoT hub'ı oluşturun.
• Bir IoT Edge cihazını IoT hub'ınıza kaydetme.
• Cihazınızda Windows çalışma zamanında Linux için IoT Edge'i yükleyin ve başlatın.
• IoT Edge cihazına uzaktan bir modül dağıtın ve telemetri gönderin.

Bu hızlı başlangıç, Windows cihazında Linux için Azure IoT Edge'inizi ayarlama konusunda size yol gösterir. Ardından Azure portalından cihazınıza bir modül dağıtacaksınız. Kullanacağınız modül sıcaklık, nem ve basınç verileri oluşturan bir simülasyon sensörüdür. Diğer Azure IoT Edge öğreticileri, burada yaptığınız çalışmayı temel alarak iş içgörüleri için simülasyon verilerini analiz eden modüller dağıtır.

Etkin bir Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

Önkoşullar

Ortamınızı Azure CLI için hazırlayın.

Bu hızlı başlangıçta kullanacağınız tüm kaynakları yönetmek için bir bulut kaynak grubu oluşturun.

az group create --name IoTEdgeResources --location westus2

IoT Edge cihazınızın aşağıdaki gereksinimleri karşıladığından emin olun:

• Sistem Gereksinimleri

  • Windows 10¹/11 (Pro, Enterprise, IoT Enterprise) _{¹ Windows 10 en düşük derleme 17763 ve tüm güncel toplu güncelleştirmeler yüklüdür.}

• Donanım gereksinimleri

  • Minimum Boş Bellek: 1 GB
  • En Az Boş Disk Alanı: 10 GB

Uyarı

Bu hızlı başlangıçta Windows üzerinde Linux için IoT Edge dağıtımı oluşturmak için PowerShell kullanılır. Windows Yönetim Merkezi'ni de kullanabilirsiniz. Dağıtımınızı oluşturmak için Windows Yönetim Merkezi'ni kullanmak istiyorsanız, Bir Windows cihazına Linux için Azure IoT Edge'i yükleme ve sağlama ile ilgili nasıl yapılır kılavuzundaki adımları izleyin.

IoT hub'ı oluşturma

Başlangıç olarak Azure CLI ile bir IoT hub'ı oluşturun.

Azure IoT Hub'ın ücretsiz düzeyi bu hızlı başlangıçta çalışır. Geçmişte IoT Hub kullandıysanız ve zaten bir hub'ını oluşturduysanız bu IoT hub'ını kullanabilirsiniz.

Aşağıdaki kod, kaynak grubunda ücretsiz IoTEdgeResources hub'ı oluşturur. {hub_name} ioT hub'ınız için benzersiz bir adla değiştirin. IoT hub'ı oluşturmak birkaç dakika sürebilir.

az iot hub create --resource-group IoTEdgeResources --name {hub_name} --sku F1 --partition-count 2

Aboneliğinizde zaten bir ücretsiz hub'ınız olduğu için hata alırsanız, SKU'yu olarak S1değiştirin. IoT hub adının kullanılamadığını belirten bir hata alırsanız, bu adı zaten başka biri kullanıyor demektir. Yeni bir ad deneyin.

IoT Edge cihazı kaydet

Yeni oluşturduğunuz IoT hub'ınıza bir IoT Edge cihazı kaydedin.

IoT hub'ınızla iletişim kurabilmesi amacıyla simülasyon cihazınız için bir cihaz kimliği oluşturun. Cihaz kimliği bulutta kalır ve fiziksel cihazla cihaz kimliği arasında bağlantı kurmak için benzersiz bir bağlantı dizesi kullanmanız gerekir.

IoT Edge cihazları normal IoT cihazlarından farklı davranır ve yönetilebilir. IoT Edge cihazı için olduğunu belirtmek amacıyla --edge-enabled bayrağını kullanın.

1. Azure Cloud Shell'de aşağıdaki komutu girerek hub'ınızda myEdgeDevice adlı bir cihaz oluşturun.

   az iot hub device-identity create --device-id myEdgeDevice --edge-enabled --hub-name {hub_name}
   

   İlke anahtarları hakkında iothubowner hata alırsanız Cloud Shell'in Azure IoT uzantısının en son sürümünü çalıştırdığından emin olun.

2. Fiziksel cihazınızı IoT Hub'daki kimliğine bağlayan cihazınızın bağlantı dizesini görüntüleyin. IoT hub'ınızın adını, cihazınızın adını ve ikisi arasındaki bağlantıların kimliğini doğrulayan paylaşılan anahtarı içerir.

   az iot hub device-identity connection-string show --device-id myEdgeDevice --hub-name {hub_name}
   

3. JSON çıkışından connectionString anahtarının değerini kopyalayın ve kaydedin. Bu değer cihaz bağlantı dizesidir. Sonraki bölümde IoT Edge çalışma zamanını yapılandırmak için kullanacaksınız.

   

IoT Edge çalışma zamanını yükleme ve başlatma

Cihazınıza Linux için IoT Edge'i yükleyin ve cihaz bağlantı dizesi ile yapılandırın.

Windows üzerinde Linux için Azure IoT Edge'i dağıtmak istediğiniz hedef cihazda aşağıdaki PowerShell komutlarını çalıştırın. PowerShell kullanarak uzak bir hedef cihaza dağıtmak için Uzak PowerShell'i kullanarak uzak bir cihaza bağlantı kurun ve bu komutları bu cihazda uzaktan çalıştırın.

1. Yükseltilmiş bir PowerShell oturumunda, Hyper-V'yi etkinleştirmek için aşağıdaki komutu çalıştırın. Daha fazla bilgi için Windows 10'da Hyper-V'ye bakın.

   Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All
   

2. Yükseltilmiş bir PowerShell oturumunda, Windows'da Linux için IoT Edge'i indirmek için aşağıdaki komutların her birini çalıştırın.

   $msiPath = $([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))
   $ProgressPreference = 'SilentlyContinue'
   ​Invoke-WebRequest "https://aka.ms/AzEflowMSI" -OutFile $msiPath
   

3. Cihazınıza Windows üzerinde Linux için IoT Edge'i yükleyin.

   Start-Process -Wait msiexec -ArgumentList "/i","$([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))","/qn"
   

4. Henüz yapmadıysanız hedef cihazdaki yürütme ilkesini olarak AllSigned ayarlayın. Yükseltilmiş bir PowerShell isteminde geçerli yürütme ilkesini denetlemek için şunları kullanabilirsiniz:

   Get-ExecutionPolicy -List
   

   yürütme ilkesi local machine değilse AllSigned, şunu kullanarak yürütme ilkesini ayarlayabilirsiniz:

   Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
   

5. Windows dağıtımında Linux için IoT Edge'i oluşturun.

   Deploy-Eflow
   

6. Lisans koşullarını kabul etmek için 'Y' girin.

7. Tercihinize bağlı olarak İsteğe bağlı tanılama verilerini açmak veya kapatmak için 'O' veya 'R' girin. Başarılı bir dağıtım aşağıda gösterilmektedir.

   

8. Önceki bölümde aldığınız cihaz bağlantı dizesini kullanarak cihazınızı yapılandırın. Yer tutucu metni kendi değerinizle değiştirin.

   Provision-EflowVm -provisioningType ManualConnectionString -devConnString "<CONNECTION_STRING_HERE>"​
   

Artık IoT Edge cihazınız yapılandırıldı. Buluta dağıtılan modülleri çalıştırmaya hazırdır.

Modül dağıtın

IoT Hub'a telemetri verileri gönderen bir modül dağıtmak için Azure IoT Edge cihazınızı buluttan yönetin.

Azure IoT Edge'in önemli özelliklerinden biri, buluttan IoT Edge cihazlarınıza kod dağıtmaktır. IoT Edge modülleri , kapsayıcı olarak uygulanan yürütülebilir paketlerdir. Bu bölümde, Azure Market'in IoT Edge Modülleri bölümünden önceden oluşturulmuş bir modülü doğrudan Azure IoT Hub'dan dağıtacaksınız.

Bu bölümde dağıttığınız modül bir algılayıcının simülasyonunu oluşturur ve oluşturulan verileri gönderir. Bu modül, IoT Edge'i kullanmaya başlarken yararlı bir kod parçasıdır çünkü sanal verileri geliştirme ve test için kullanabilirsiniz. Bu modülün tam olarak ne yaptığını görmek istiyorsanız, simülasyon sıcaklık algılayıcısı kaynak kodunu görüntüleyebilirsiniz.

Azure Market'ten ilk modülünüzü dağıtmak için bu adımları izleyin.

1. Azure portalında oturum açın ve IoT hub'ınıza gidin.

2. Soldaki menüden Cihaz yönetimi menüsünün altındaki Cihazlar'ı seçin.

3. Cihaz listesinden hedef cihazın cihaz kimliğini seçin.

   Yeni bir IoT Edge cihazı oluşturduğunuzda, azure portalında durum kodu 417 -- The device's deployment configuration is not set görüntülenir. Bu durum normaldir ve cihazın modül dağıtımı almaya hazır olduğu anlamına gelir.

4. Üst çubukta Modülleri Ayarla'yı seçin.

   

5. IoT Edge Modülleri'nin altında Ekle açılan menüsünü açın ve Market Modülü'ne tıklayın.

   

6. IoT Edge Modülü Marketi'nde modülü arayın ve seçinSimulated Temperature Sensor.

   Modül IoT Edge Modülleri bölümüne istenen çalışma durumuyla eklenir.

7. Sihirbazın sonraki adımına devam etmek için İleri: Yollar'ı seçin.

   

8. Yollar sekmesinde varsayılan yolu, yolu kaldırın ve ardından sihirbazın sonraki adımına devam etmek için İleri: Gözden geçir + oluştur'u seçin.

   Uyarı

   Yollar ad ve değer çiftleri kullanılarak oluşturulur. Bu sayfada iki yol görmeniz gerekir. Varsayılan yol olan yol, tüm iletileri IoT Hub'a (olarak adlandırılır) $upstreamgönderir. Azure Market'ten modülü eklediğinizde SimulatedTemperatureSensorToIoTHub adlı ikinci bir yol otomatik olarak oluşturuldu. Bu yol, sanal sıcaklık modülündeki tüm iletileri IoT Hub'a gönderir. Bu durumda yedekli olduğundan varsayılan yolu silebilirsiniz.

   

9. JSON dosyasını gözden geçirin ve oluştur'u seçin. JSON dosyası, IoT Edge cihazınıza dağıttığınız tüm modülleri tanımlar. SimulatedTemperatureSensor modülünü ve edgeAgent ve edgeHub adlı iki çalışma zamanı modülünü göreceksiniz.

   Uyarı

   IoT Edge cihazına yeni bir dağıtım gönderdiğinizde cihazınıza herhangi bir şey gönderilmez. Bunun yerine cihaz, IoT Hub'ı düzenli olarak sorgulayarak yeni yönergeler olup olmadığını denetler. Güncelleştirilmiş bir dağıtım bildirimi bulması halinde cihaz yeni dağıtımla ilgili bilgileri kullanarak buluttaki modül görüntülerini çeker ve modülleri yerel ortamda çalıştırmaya başlar. Bu işlem birkaç dakika sürebilir.

10. Modül dağıtım ayrıntılarını oluşturduktan sonra sihirbaz sizi cihaz ayrıntıları sayfasına döndürür. Modüller sekmesinde dağıtım durumunu görüntüleyin.

    Üç modül görmeniz gerekir: $edgeAgent, $edgeHub ve SimulatedTemperatureSensor. Modüllerden biri veya daha fazlası EVET'e DAĞITIMDA BELİRLENDİ altında sahipse ancak CİHAZ TARAFINDAN BİLDİRİLİYOR altında değilse, IoT Edge cihazınız bunları hala başlatıyor. Birkaç dakika bekleyin ve sayfayı yenileyin.

    

Oluşturulan verileri görüntüleme

Bu hızlı başlangıçta, yeni bir IoT Edge cihazı oluşturdunuz ve üzerine IoT Edge çalışma zamanını yüklediniz. Ardından, cihazda değişiklik yapmak zorunda kalmadan cihazda çalıştırılacak bir IoT Edge modülü dağıtmak için Azure portalını kullandınız.

Gönderdiğiniz modül, daha sonra test için kullanabileceğiniz örnek ortam verileri oluşturur. Simülasyon algılayıcısı hem makineyi hem de makinenin etrafındaki ortamı izler. Örneğin bu sensör bir sunucu odasında, fabrika sahasında veya rüzgar türbininde olabilir. Gönderdiği iletiler ortam sıcaklığı ve nem, makine sıcaklığı ve basınç ile zaman damgasını içerir. IoT Edge öğreticileri, analiz için test verileri olarak bu modül tarafından oluşturulan verileri kullanır.

1. PowerShell oturumunuzda aşağıdaki komutu kullanarak Windows sanal makinesinde Linux için IoT Edge'inizde oturum açın:

   Connect-EflowVm
   

   Uyarı

   Sanal makinede SSH'ye izin verilen tek hesap, bunu oluşturan kullanıcıdır.

2. Oturum açtıktan sonra aşağıdaki Linux komutunu kullanarak IoT Edge modüllerini çalıştırma listesini de kontrol edebilirsiniz:

   sudo iotedge list
   

   

3. Aşağıdaki Linux komutunu kullanarak sıcaklık sensörü modülünden buluta gönderilen iletileri görüntüleyin:

   sudo iotedge logs SimulatedTemperatureSensor -f
   

   Önemli

   IoT Edge komutları modül adlarına başvurduğunda büyük/küçük harfe duyarlıdır.

   

İletilerin IoT hub'ınıza ulaşmasını izlemek için Visual Studio Code için Azure IoT Hub uzantısını da kullanabilirsiniz.

Kaynakları temizle

IoT Edge öğreticilerine devam etmek istiyorsanız bu adımı atlayın. Bu hızlı başlangıçta kaydettiğiniz ve ayarladığınız cihazı kullanabilirsiniz. Aksi takdirde, ücretlerden kaçınmak için oluşturduğunuz Azure kaynaklarını silebilirsiniz.

Sanal makinenizi ve IoT hub’ınızı yeni bir kaynak grubunda oluşturduysanız, bu grubu ve ilişkili tüm kaynaklarını silebilirsiniz. Grubun tamamını silmek istemiyorsanız, bunun yerine tek tek kaynakları silebilirsiniz.

Önemli

Saklamak istediğiniz hiçbir şey olmadığından emin olmak için kaynak grubunun içeriğini denetleyin. Bir kaynak grubunu silmek geri alınamaz.

IoTEdgeResources grubunu kaldırmak için aşağıdaki komutu kullanın. Silme işlemi birkaç dakika sürebilir.

az group delete --name IoTEdgeResources

Kaynak gruplarının listesini görüntülemek için bu komutu kullanarak kaynak grubunun kaldırıldığını onaylayabilirsiniz.

az group list

Windows'da Linux için IoT Edge'i kaldırma

Cihazınızdan Windows üzerinde Linux için Azure IoT Edge yüklemesini kaldırmak istiyorsanız aşağıdaki komutları kullanın.

1. Windows'da Ayarlar'ı açma
2. Program Ekle veya Kaldır'ı seçin
3. Azure IoT Edge LTS uygulamasını seçin
4. Kaldır'ı seçin

Sonraki Adımlar

Bu hızlı başlangıçta bir IoT Edge cihazı oluşturdunuz ve cihaza kod dağıtmak için Azure IoT Edge bulut arabirimini kullandınız. Artık ortamı hakkında ham veri oluşturan bir test cihazınız var.

Sonraki öğreticide Azure portalından cihazınızın etkinliğini ve durumunu izlemeyi öğreneceksiniz.

IoT Edge cihazlarını izleme