Bagikan melalui

Mulai cepat: Menyebarkan modul IoT Edge pertama Anda ke perangkat Windows

Berlaku untuk:IoT Edge 1.5 dengan tanda centang IoT Edge 1.5

Penting

IoT Edge 1.5 LTS adalah rilis didukung. IoT Edge 1.4 LTS mencapai akhir masa pakai pada 12 November 2024. Jika Anda menggunakan rilis sebelumnya, lihat Update IoT Edge.

Cobalah Azure IoT Edge dalam mulai cepat ini dengan menyebarkan kode kontainer ke Linux di perangkat Windows IoT Edge. IoT Edge memungkinkan Anda mengelola kode dari jarak jauh di perangkat sehingga Anda dapat mengirim lebih banyak beban kerja ke tepi. Untuk mulai cepat ini, disarankan agar Anda menggunakan perangkat Klien Windows Anda sendiri untuk melihat betapa mudahnya menggunakan Azure IoT Edge untuk Linux di Windows. Jika Anda ingin menggunakan VM Windows Server atau Azure untuk membuat penyebaran, ikuti langkah-langkah dalam panduan cara menginstal dan menyediakan Azure IoT Edge untuk Linux pada perangkat Windows.

Dalam panduan cepat ini, Anda mempelajari cara untuk:

  • Membuat IoT Hub.
  • Daftarkan perangkat IoT Edge ke hub IoT Anda.
  • Instal dan mulai IoT Edge untuk Linux pada runtime Windows di perangkat Anda.
  • Sebarkan modul dari jarak jauh ke perangkat IoT Edge dan kirim telemetri.

Diagram yang menunjukkan arsitektur panduan memulai cepat ini untuk perangkat dan cloud Anda.

Panduan mulai cepat ini memandu Anda untuk menyiapkan Azure IoT Edge untuk Linux di perangkat Windows. Kemudian, Anda menyebarkan modul dari portal Azure ke perangkat Anda. Modul yang Anda gunakan adalah sensor simulasi yang menghasilkan data suhu, kelembaban, dan tekanan. Tutorial Azure IoT Edge lainnya dibangun berdasarkan pekerjaan yang Anda lakukan di sini dengan menyebarkan modul yang menganalisis data simulasi untuk wawasan bisnis.

Jika Anda tidak memiliki langganan Azure aktif, buat akun free sebelum Memulai.

Prasyarat

Siapkan lingkungan Anda untuk Azure CLI.

Buat grup sumber daya cloud untuk mengelola semua sumber daya yang Anda gunakan dalam panduan awal ini.

az group create --name IoTEdgeResources --location westus2

Pastikan perangkat IoT Edge Anda memenuhi persyaratan berikut:

  • Persyaratan sistem

    • Windows 101/11 (Pro, Enterprise, IoT Enterprise) 1 Windows 10 minimum build 17763 dengan semua pembaruan kumulatif saat ini yang terpasang.

  • Persyaratan perangkat keras

    • Memori bebas minimum: 1 GB
    • Ruang disk kosong minimum: 10 GB

Membuat IoT Hub

Mulailah dengan membuat hub IoT dengan menggunakan Azure CLI.

Diagram yang menunjukkan langkah untuk membuat hub I o T.

Tingkat gratis Azure IoT Hub berfungsi untuk panduan mulai cepat ini. Jika sebelumnya Anda menggunakan IoT Hub dan sudah memiliki hub, Anda dapat menggunakan IoT hub tersebut.

Kode berikut membuat hub F1 gratis di grup sumber daya IoTEdgeResources. Ganti {hub_name} dengan nama unik untuk hub IoT Anda. Mungkin perlu waktu beberapa menit untuk membuat hub IoT.

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

Jika Anda mendapatkan kesalahan karena Anda sudah memiliki satu hub gratis di langganan Anda, ubah SKU menjadi S1. Jika Anda mendapatkan kesalahan bahwa nama hub IoT tidak tersedia, orang lain sudah memiliki hub dengan nama itu. Coba nama baru.

Mendaftarkan perangkat IoT Edge

Daftarkan perangkat IoT Edge dengan hub IoT yang baru dibuat.

Diagram yang menunjukkan langkah untuk mendaftarkan perangkat dengan identitas hub I o T.

Buat identitas perangkat untuk perangkat yang disimulasikan Anda sehingga dapat berkomunikasi dengan hub IoT Anda. Identitas perangkat berada di cloud, dan Anda menggunakan string koneksi perangkat yang unik untuk mengaitkan perangkat fisik dengan identitas perangkat.

Perangkat IoT Edge berfungsi dan dapat dikelola secara berbeda dari perangkat IoT biasa. Gunakan bendera --edge-enabled untuk menyatakan bahwa identitas ini untuk perangkat IoT Edge.

  1. Di Azure Cloud Shell, masukkan perintah berikut untuk membuat perangkat bernama myEdgeDevice di hub Anda.

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

    Jika Anda mendapatkan kesalahan tentang kunci kebijakan iothubowner, pastikan Cloud Shell menjalankan versi terbaru ekstensi Azure IoT.

  2. Lihat connection string untuk perangkat Anda, yang menautkan perangkat fisik Anda dengan identitasnya di IoT Hub. Ini berisi nama hub IoT Anda, nama perangkat Anda, dan kunci bersama yang mengotentikasi koneksi di antara keduanya.

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

  3. Salin nilai kunci connectionString dari output JSON dan simpan. Nilai ini adalah string sambungan perangkat. Gunakan untuk mengonfigurasi runtime IoT Edge di bagian berikutnya.

    Misalnya, connection string Anda akan terlihat mirip dengan HostName=contoso-hub.azure-devices.net;DeviceId=myEdgeDevice;SharedAccessKey=<DEVICE_SHARED_ACCESS_KEY>.

Menginstal dan memulai runtime IoT Edge

Instal IoT Edge di Linux pada Windows di perangkat Anda dan konfigurasikan dengan string koneksi perangkat.

Diagram yang memperlihatkan langkah untuk memulai runtime I o T Edge.

Jalankan perintah PowerShell berikut pada perangkat target tempat Anda ingin menyebarkan Azure IoT Edge untuk Linux di Windows. Untuk menyebarkan ke perangkat target jarak jauh menggunakan PowerShell, Anda dapat menggunakan PowerShell Jarak jauh untuk membuat koneksi ke perangkat jarak jauh dan menjalankan perintah ini dari jarak jauh pada perangkat tersebut.

  1. Dalam sesi PowerShell yang ditingkatkan, jalankan perintah berikut untuk mengaktifkan Hyper-V. Untuk informasi selengkapnya, lihat Hyper-V di Windows 10.

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

  2. Dalam sesi PowerShell yang ditingkatkan, jalankan setiap perintah berikut untuk mengunduh IoT Edge untuk Linux di Windows.

    • X64/AMD64

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

    • ARM64

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

  3. Instal IoT Edge untuk Linux di Windows di perangkat Anda.

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

  4. Atur kebijakan eksekusi pada perangkat target ke AllSigned jika belum. Anda dapat memeriksa kebijakan eksekusi saat ini dalam prompt PowerShell yang ditingkatkan dengan menggunakan:

    Get-ExecutionPolicy -List

    Jika kebijakan local machine eksekusi tidak AllSigned, atur kebijakan eksekusi dengan menggunakan perintah berikut:

    Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force

  5. Buat penerapan IoT Edge untuk Linux pada platform Windows.

    Deploy-Eflow

  6. Masukkan Y untuk menerima persyaratan lisensi.

  7. Masukkan O atau R untuk mengaktifkan atau menonaktifkan data diagnostik Opsional , tergantung pada preferensi Anda. Penyebaran yang berhasil ditampilkan dalam gambar berikut.

    Cuplikan layar yang menunjukkan bahwa penyebaran yang berhasil akan mengatakan Penyebaran berhasil di akhir pesan di konsol.

  8. Provisikan perangkat Anda dengan menggunakan string koneksi perangkat yang Anda ambil di bagian sebelumnya. Ganti teks tempat penampung dengan nilai Anda sendiri.

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

Perangkat IoT Edge Anda sekarang dikonfigurasi. Perangkat siap untuk menjalankan modul yang diterapkan melalui cloud.

Menyebarkan modul

Kelola perangkat Azure IoT Edge Anda dari cloud untuk menyebarkan modul yang mengirim data telemetri ke IoT Hub.

Diagram yang menunjukkan langkah untuk menyebarkan modul.

Salah satu kemampuan utama Azure IoT Edge adalah menyebarkan kode ke perangkat IoT Edge Anda dari cloud. IoT Edge modul adalah paket yang dapat dieksekusi yang diimplementasikan sebagai kontainer. Di bagian ini, Anda akan menyebarkan modul bawaan dari bagian Modul IoT Edge dari Microsoft Artifact Registry.

Modul yang Anda sebarkan di bagian ini mensimulasikan sensor dan mengirim data yang dihasilkan. Modul ini adalah bagian kode yang berguna saat Anda mulai menggunakan IoT Edge karena Anda dapat menggunakan data simulasi untuk pengembangan dan pengujian. Jika Anda ingin melihat dengan tepat apa yang dilakukan modul ini, Anda dapat melihat kode sumber sensor suhu yang disimulasikan.

Ikuti langkah-langkah ini untuk menyebarkan modul pertama Anda.

  1. Masuk ke portal Azure dan buka IoT Hub Anda.

  2. Dari menu di sebelah kiri, pilih Perangkat di bawah menu Manajemen perangkat .

  3. Pilih ID perangkat target dari daftar perangkat.

    Catatan

    Saat Anda membuat perangkat IoT Edge baru, perangkat tersebut menampilkan kode status 417 -- The device's deployment configuration is not set di portal Azure. Status ini normal, dan berarti perangkat siap untuk menerima penyebaran modul.

  4. Di bilah atas, pilih Atur Modul.

    Pilih modul mana yang ingin Anda jalankan di perangkat Anda. Anda dapat memilih dari modul yang sudah Anda buat, modul dari Microsoft Artifact Registry, atau modul yang Anda buat sendiri. Dalam panduan cepat ini, Anda menyebarkan modul dari Microsoft Artifact Registry.

  5. Di bagian IoT Edge modul, pilih Tambahkan lalu pilih Modul IoT Edge.

  6. Perbarui pengaturan modul berikut:

    Pengaturan Nilai
    Nama Modul IoT SimulatedTemperatureSensor
    URI gambar mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:latest
    Memulai ulang kebijakan selalu
    Status yang diinginkan menjalankan

  7. Pilih Berikutnya: Rute untuk terus mengonfigurasi rute.

  8. Tambahkan rute yang mengirim semua pesan dari modul suhu yang disimulasikan ke IoT Hub.

    Pengaturan Nilai
    Nama SimulatedTemperatureSensorToIoTHub
    Nilai FROM /messages/modules/SimulatedTemperatureSensor/* INTO $upstream

  9. Pilih Berikutnya: Tinjau + buat.

  10. Tinjau file JSON, lalu pilih Buat. File JSON menentukan semua modul yang Anda sebarkan ke perangkat IoT Edge Anda.

    Catatan

    Saat Anda mengirimkan penyebaran baru ke perangkat IoT Edge, tidak ada yang didorong ke perangkat Anda. Sebagai gantinya, perangkat meminta IoT Hub secara teratur untuk instruksi baru apa pun. Jika perangkat menemukan manifes penyebaran yang diperbarui, perangkat menggunakan informasi tentang penyebaran baru untuk menarik gambar modul dari cloud, lalu mulai menjalankan modul secara lokal. Proses ini memerlukan waktu beberapa menit.

Setelah Anda membuat detail penyebaran modul, wizard akan mengembalikan Anda ke halaman detail perangkat. Lihat status penyebaran pada tab Modul.

Anda akan melihat tiga modul: $edgeAgent, $edgeHub, dan SimulatedTemperatureSensor. Jika satu atau beberapa modul memiliki Yes di bawah Ditentukan dalam Penyebaran tetapi tidak di bawah Dilaporkan oleh Perangkat, perangkat IoT Edge Anda masih memulainya. Tunggu beberapa menit, lalu refresh halaman.

Cuplikan layar yang memperlihatkan SimulatedTemperatureSensor dalam daftar modul yang disebarkan.

Jika Anda mengalami masalah saat menyebarkan modul, lihat Troubleshoot IoT Edge device dari portal Azure.

Menampilkan data yang dihasilkan

Dalam panduan cepat ini, Anda telah membuat perangkat IoT Edge baru dan menginstal runtime IoT Edge pada perangkat tersebut. Kemudian Anda menggunakan portal Azure untuk menyebarkan modul IoT Edge untuk berjalan di perangkat tanpa harus membuat perubahan pada perangkat itu sendiri.

Modul yang Anda dorong menghasilkan data lingkungan sampel yang dapat Anda gunakan untuk pengujian nanti. Sensor yang disimulasikan memantau mesin dan lingkungan di sekitar mesin. Misalnya, sensor ini mungkin berada di ruang server, di lantai pabrik, atau di turbin angin. Pesan yang dikirimkannya mencakup suhu dan kelembapan sekitar, suhu dan tekanan mesin, serta tanda waktu. IoT Edge tutorial menggunakan data yang dibuat oleh modul ini sebagai data pengujian untuk analitik.

  1. Masuk ke IoT Edge Anda untuk Linux di komputer virtual Windows dengan menggunakan perintah berikut di sesi PowerShell Anda:

    Connect-EflowVm

    Catatan

    Satu-satunya akun yang diizinkan untuk SSH ke komputer virtual adalah pengguna yang membuatnya.

  2. Setelah Anda masuk, periksa daftar menjalankan modul IoT Edge dengan menggunakan perintah Linux berikut:

    sudo iotedge list

    Cuplikan layar yang menunjukkan tempat memverifikasi bahwa sensor suhu, agen, dan modul hub Anda berjalan.

  3. Lihat pesan yang dikirim dari modul sensor suhu ke cloud dengan menggunakan perintah Linux berikut:

    sudo iotedge logs SimulatedTemperatureSensor -f

    Cuplikan layar yang memperlihatkan log output modul Sensor Suhu Simulasi saat berjalan.

    Tips

    Perintah IoT Edge peka huruf besar/kecil saat merujuk ke nama modul.

Membersihkan sumber daya

Jika Anda ingin melanjutkan ke tutorial IoT Edge, lewati langkah ini. Anda dapat menggunakan perangkat yang Anda daftarkan dan siapkan dalam panduan cepat ini. Jika tidak, hapus sumber daya Azure yang Anda buat untuk menghindari biaya.

Jika Anda membuat komputer virtual dan hub IoT di grup sumber daya baru, hapus grup tersebut dan semua sumber daya terkait. Jika Anda tidak ingin menghapus seluruh grup, hapus sumber daya individual sebagai gantinya.

Penting

Periksa konten grup sumber daya untuk memastikan tidak ada yang ingin Anda simpan. Penghapusan grup sumber daya tidak bisa dipulihkan.

Gunakan perintah berikut untuk menghapus grup IoTEdgeResources. Penghapusan mungkin memerlukan waktu beberapa menit.

az group delete --name IoTEdgeResources

Anda bisa mengonfirmasi bahwa grup sumber daya dihapus menggunakan perintah ini untuk melihat daftar grup sumber daya.

az group list

Menghapus instalan IoT Edge untuk Linux di Windows

Untuk menghapus Azure IoT Edge untuk Linux pada penginstalan Windows dari perangkat Anda, gunakan langkah-langkah berikut.

  1. Buka Settings di Windows.
  2. Pilih Tambahkan atau Hapus Program.
  3. Pilih aplikasi Azure IoT Edge.
  4. Pilih Hapus instalan.

Langkah berikutnya

Dalam panduan memulai cepat ini, Anda membuat perangkat IoT Edge dan menggunakan antarmuka cloud Azure IoT Edge untuk menerapkan kode ke perangkat. Sekarang Anda memiliki perangkat uji yang menghasilkan data mentah tentang lingkungannya.

Dalam tutorial berikutnya, Anda mempelajari cara memantau aktivitas dan kesehatan perangkat Anda dari portal Azure.

Monitor perangkat IoT Edge

  • Last updated on