Latihan - Membuat aplikasi IoT Central

  • 8 menit

Buat aplikasi IoT Central untuk perangkat IoT Edge Anda untuk terhubung dan dikelola.

Ingat bahwa Anda berencana untuk menyebarkan perangkat IoT Edge di setiap penyimpanan untuk mengelola sensor lokal dan memfilter data yang dikirim ke IoT Central.

Di sini, Anda akan menggunakan Azure CLI untuk membuat aplikasi IoT Central dari templat Aplikasi kustom. Anda akan menjalankan perintah CLI di kotak pasir Azure lalu membuka antarmuka pengguna web aplikasi. Di antarmuka pengguna web, Anda menyelesaikan penyiapan dengan menambahkan templat perangkat untuk perangkat IoT Edge Anda.

Catatan

Latihan ini bersifat opsional. Jika Anda ingin menyelesaikan latihan ini, Anda harus membuat langganan Azure sebelum memulai. Jika Anda tidak memiliki akun Azure atau tidak ingin membuatnya sekarang, Anda dapat membaca petunjuk agar Anda memahami informasi yang sedang diberikan.

Mengunduh manifes penyebaran

Saat Anda membuat templat perangkat untuk perangkat IoT Edge, Anda memerlukan manifes penyebaran dan definisi antarmuka di komputer lokal Anda. Anda dapat mengunduh file ini dengan mengeklik kanan tautan berikut dan memilih Simpan sebagai:

Ingat di mana Anda menyimpan file-file ini, Anda akan menggunakannya nanti.

Membuat dan mengonfigurasi aplikasi IoT Central

Langkah-langkah berikut membuat aplikasi IoT Central dan menghasilkan token API untuk digunakan nanti dalam modul ini.

  1. Jalankan perintah berikut di Cloud Shell untuk menghasilkan nama unik untuk aplikasi IoT Central Anda dan simpan dalam variabel lingkungan untuk digunakan nanti:

    APP_NAME="store-manager-$RANDOM"
echo "Your application name is: $APP_NAME"

    Catat nama aplikasi untuk berjaga-jaga jika shell kali keluar dan kehilangan variabel lingkungan.

  2. Jalankan perintah berikut di Cloud Shell untuk membuat aplikasi IoT Central di kotak pasir:

    az iot central app create \
--resource-group <rgn>[sandbox resource group name]</rgn> \
--name $APP_NAME --sku ST2 --location centralus \
--subdomain $APP_NAME --template iotc-pnp-preview \
--display-name 'Store Management'
echo "You can now navigate to: https://$APP_NAME.azureiotcentral.com/edge-manifests"

    Berharap perintah ini mengambil satu atau dua menit untuk menjalankan.

  3. Di tab atau jendela browser lain, buka URL yang ditampilkan di output dari perintah sebelumnya. Halaman ini di antarmuka pengguna web adalah tempat Anda mengunggah manifes penyebaran IoT Edge:

    Screenshot showing the deployment manifests page where you manage the IoT Edge deployment manifests in your IoT Central application.

  4. Pilih Buat manifes edge, masukkan nama Sensor Lingkungan, pilih Unggah file, lalu telusuri untuk memilih file EnvironmentalSensorManifest-1-4.json yang Anda unduh sebelumnya.

  5. Pilih Berikutnya lalu Buat untuk mengunggah manifes. Manifes mengonfigurasi tiga modul IoT Edge: edgeAgent, edgeHub, dan SimulatedTemperatureSensor.

  6. Selanjutnya pilih Templat perangkat. Halaman di antarmuka pengguna web ini adalah tempat Anda membuat templat perangkat:

    The device templates page where you manage the templates in your IoT Central application.

  7. Pilih Buat templat perangkat, pilih petak peta Azure IoT Edge, lalu pilih Berikutnya: Sesuaikan.

  8. Masukkan Perangkat Edge Sensor Lingkungan sebagai nama templat perangkat. Kemudian, pilih Berikutnya: Tinjau.

  9. Pilih Buat untuk membuat templat perangkat. Lalu pilih Model kustom untuk memulai dengan model kosong.

Manifes penyebaran yang Anda unggah memiliki modul yang disebut SimulatedTemperatureSensor dengan antarmuka yang disebut manajemen. Antarmuka manajemen menyertakan properti yang dapat ditulis SendData dan SendInterval. Untuk menambahkan informasi ini ke templat perangkat baru Anda:

  1. Pada halaman templat perangkat, pilih Modul di bagian Model .

  2. Pilih Impor modul dari manifes:

    Screenshot showing the device templates page where you import the module definitions from the deployment manifest.

  3. Pilih manifes penyebaran Sensor Lingkungan untuk mengimpor modul.

Templat perangkat Anda sekarang menyertakan modul SimulatedTemperatureSensor dengan antarmuka manajemen . Antarmuka menentukan properti bisa-tulis SendData dan SendInterval .

Manifes penyebaran tidak menyertakan informasi tentang telemetri yang dikirim modul perangkat. Agar IoT Central dapat membuat visualisasi untuk telemetri, tambahkan antarmuka dengan definisi yang diperlukan:

  1. Pilih modul SimulatedTemperatureSensor lalu pilih + Tambahkan antarmuka yang diwarisi. Anda mungkin perlu memilih ... untuk melihat opsi ini.

  2. Pilih petak peta Impor antarmuka. Pilih file TelemetryInterface.json yang Anda unduh sebelumnya.

  3. Antarmuka Telemetri menentukan jenis telemetri komputer dan ambien sebagai objek. Objek komputer meliputi telemetri suhu dan tekanan. Obyek ambien meliputi telemetri suhu dan kelembaban. Antarmuka juga menyertakan timeCreated sebagai jenis telemetri DateTime.

    Screenshot that shows the telemetry interface in the device template.

Untuk mengaktifkan operator merekam informasi tentang setiap perangkat IoT Edge, tambahkan properti Cloud berikut ke model Perangkat Edge Sensor Lingkungan:

Nama tampilan Nama Jenis kapabilitas Skema
Nama Penyimpanan StoreName Properti Cloud String
Tanggal Layanan ServiceDate Properti Cloud Date

Screenshot that shows the cloud properties in the device template.

Tip

Anda perlu meluaskan properti cloud untuk melihat pengaturan skema.

Pilih Simpan untuk menyimpan perubahan.

Untuk memungkinkan operator melihat data lingkungan dari penyimpanan Anda, tambahkan tampilan berikut ke templat perangkat:

  1. Untuk menambahkan tampilan baru, pilih Tampilan di templat perangkat. Lalu pilih petak peta Memvisualisasikan perangkat.

  2. Ubah nama tampilan menjadi Lihat telemetri perangkat IoT Edge.

  3. Pilih Mulai dengan perangkat.

  4. Tambahkan jenis telemetri ambien/suhu, kelembaban, komputer/suhu, dan tekanan, lalu pilih Tambahkan petak peta.

  5. Pilih Simpan.

    Screenshot that shows telemetry view definition.

Untuk memungkinkan operator merekam informasi tentang setiap penyimpanan dan mengelola perangkat, tambahkan tampilan berikut ke templat perangkat:

  1. Untuk menambahkan tampilan baru, pilih Tampilan di templat perangkat. Lalu pilih petak peta Mengedit perangkat dan data cloud.

  2. Ubah nama formulir menjadi Simpan informasi.

  3. Pilih properti cloud Nama Penyimpanan dan Tanggal Layanan. Kemudian pilih Tambahkan bagian.

  4. Pilih Simpan.

    Screenshot that shows cloud property form definition.

Anda sekarang siap untuk menerbitkan templat dan menambahkan perangkat:

  1. Pilih Terbitkan, lalu di dialog Terbitkan templat perangkat ini ke aplikasi, pilih Terbitkan.

  2. Buka halaman Perangkat di aplikasi IoT Central Anda.

  3. Pilih templat perangkat Environmental Sensor Edge lalu pilih + Baru.

  4. Dalam dialog Buat perangkat baru, masukkan store-001 sebagai ID perangkat. Pastikan bahwa templat perangkat adalah Perangkat Edge Sensor Lingkungan. Perangkat Azure IoT Edge? sudah diatur ke Ya. Lalu pilih Sensor Lingkungan sebagai manifes tepi. Pilih Buat.

  5. Perangkat store-001 muncul dalam daftar perangkat dengan status Terdaftar.

    Screenshot that shows the registered device in the device list.

Periksa pekerjaan Anda

  1. Dalam daftar perangkat, klik nama perangkat Perangkat Edge Sensor Lingkungan - store-001. Anda dapat melihat tampilan yang tersedia untuk perangkat, termasuk Simpan informasi dan Lihat telemetri perangkat IoT Edge.

  2. Pilih Sambungkan. Catat Cakupan ID dan Kunci utama. Anda akan menggunakan nilai ini nanti untuk mengonfigurasi perangkat IoT Edge Anda agar terhubung ke aplikasi Anda.

Biarkan halaman ini tetap terbuka di browser web Anda - Anda akan kembali ke aplikasi IoT Central ini nanti.

Anda sekarang telah membuat aplikasi untuk mengelola penyimpanan Anda, membuat templat perangkat yang menyertakan manifes penyebaran IoT Edge untuk perangkat yang Anda rencanakan untuk diinstal di penyimpanan Anda. Templat menyertakan tampilan yang memungkinkan operator memantau kondisi lingkungan di penyimpanan dan mengelola perangkat dari jarak jauh.