Tutorial: Menyiapkan lingkungan Anda untuk panduan mulai cepat dan tutorial IoT Plug and Play
Sebelum Anda dapat menyelesaikan salah satu panduan mulai cepat dan tutorial IoT Plug and Play, Anda perlu mengonfigurasi hub IoT dan Device Provisioning Service (DPS) di langganan Azure Anda. Anda juga memerlukan salinan lokal file model yang digunakan oleh aplikasi contoh dan alat penjelajah Azure IoT.
Prasyarat
Jika Anda tidak memiliki langganan Azure, buat akun gratis sebelum Anda memulai.
Persiapkan lingkungan Anda untuk Azure CLI
Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai Cepat untuk Bash di Azure Cloud Shell.
Jika Anda lebih suka menjalankan perintah referensi CLI secara lokal, instal Azure CLI. Jika Anda menjalankan Windows atau macOS, pertimbangkan untuk menjalankan Azure CLI dalam kontainer Docker. Untuk informasi lebih lanjut, lihat Cara menjalankan Azure CLI di kontainer Docker.
Jika Anda menggunakan instalasi lokal, masuk ke Azure CLI dengan menggunakan perintah login az. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Masuk dengan Azure CLI.
Saat Anda diminta, instal ekstensi Azure CLI pada penggunaan pertama. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan ekstensi dengan Azure CLI.
Jalankan versi az untuk menemukan versi dan pustaka dependen yang diinstal. Untuk meningkatkan ke versi terbaru, jalankan peningkatan az.
Membuat sumber daya
Membuat grup sumber daya Azure untuk sumber daya:
az group create --name my-pnp-resourcegroup --location centralus
Membuat IoT Hub. Perintah berikut menggunakan nama my-pnp-hub sebagai contoh untuk nama hub IoT yang akan dibuat. Pilih nama unik untuk hub IoT Anda untuk digunakan sebagai ganti my-pnp-hub:
az iot hub create --name my-pnp-hub --resource-group my-pnp-resourcegroup --sku F1 --partition-count 2
Membuat instans DPS. Perintah berikut menggunakan nama my-pnp-dps sebagai contoh untuk nama instans DPS yang dibuat. Pilih nama unik untuk DPS Anda untuk digunakan sebagai ganti my-pnp-dps:
az iot dps create --name my-pnp-dps --resource-group my-pnp-resourcegroup
Untuk menautkan instans DPS ke hub IoT Anda, gunakan perintah berikut. Ganti my-pnp-dps dan my-pnp-hub dengan nama unik yang Anda pilih sebelumnya:
hubConnectionString=$(az iot hub connection-string show -n my-pnp-hub --key primary --query connectionString -o tsv)
az iot dps linked-hub create --dps-name my-pnp-dps --resource-group my-pnp-resourcegroup --location centralus --connection-string $hubConnectionString
Mengambil pengaturan
Beberapa panduan mulai cepat dan tutorial menggunakan string koneksi untuk hub IoT Anda. Anda juga memerlukan string koneksi saat menyiapkan alat penjelajah Azure IoT. Ambil string koneksi dan buat catatan sekarang. Ganti my-pnp-hub dengan nama unik yang Anda pilih untuk hub IoT Anda:
az iot hub connection-string show -n my-pnp-hub --key primary --query connectionString
Sebagian besar panduan mulai cepat dan tutorial menggunakan cakupan ID dari konfigurasi DPS Anda. Ambil cakupan ID dan catat sekarang. Ganti my-pnp-dps dengan nama unik yang Anda pilih untuk instans DPS Anda:
az iot dps show --name my-pnp-dps --query properties.idScope
Semua panduan mulai cepat dan tutorial menggunakan pendaftaran perangkat DPS. Gunakan perintah berikut untuk membuat my-pnp-devicependaftaran perangkat individual di instans DPS Anda. Ganti my-pnp-dps dengan nama unik yang Anda pilih untuk instans DPS Anda. Catat ID pendaftaran dan nilai kunci primer untuk digunakan dalam panduan mulai cepat dan tutorial:
az iot dps enrollment create --attestation-type symmetrickey --dps-name my-pnp-dps --resource-group my-pnp-resourcegroup --enrollment-id my-pnp-device --device-id my-pnp-device --query '{registrationID:registrationId,primaryKey:attestation.symmetricKey.primaryKey}'
Membuat variabel lingkungan
Buat lima variabel lingkungan untuk mengonfigurasi sampel di panduan mulai cepat dan tutorial untuk menggunakan Device Provisioning Service (DPS) untuk terhubung ke hub IoT Anda:
- IOTHUB_DEVICE_SECURITY_TYPE: nilai
DPS. - IOTHUB_DEVICE_DPS_ID_SCOPE: cakupan ID DPS yang Anda catat sebelumnya.
- IOTHUB_DEVICE_DPS_DEVICE_ID: nilai
my-pnp-device. - IOTHUB_DEVICE_DPS_DEVICE_KEY: kunci utama pendaftaran yang Anda buat sebelumnya.
- IOTHUB_DEVICE_DPS_ENDPOINT: nilai
global.azure-devices-provisioning.net
Sampel layanan memerlukan variabel lingkungan berikut untuk mengidentifikasi hub dan perangkat untuk terhubung ke:
- IOTHUB_CONNECTION_STRING: string koneksi IoT Hub yang Anda catat sebelumnya.
- IOTHUB_DEVICE_ID:
my-pnp-device.
Misalnya, dalam shell bash Linux:
export IOTHUB_DEVICE_SECURITY_TYPE="DPS"
export IOTHUB_DEVICE_DPS_ID_SCOPE="<Your ID scope>"
export IOTHUB_DEVICE_DPS_DEVICE_ID="my-pnp-device"
export IOTHUB_DEVICE_DPS_DEVICE_KEY="<Your enrolment primary key>"
export IOTHUB_DEVICE_DPS_ENDPOINT="global.azure-devices-provisioning.net"
export IOTHUB_CONNECTION_STRING="<Your IoT hub connection string>"
export IOTHUB_DEVICE_ID="my-pnp-device"
Misalnya, di baris perintah Windows:
set IOTHUB_DEVICE_SECURITY_TYPE=DPS
set IOTHUB_DEVICE_DPS_ID_SCOPE=<Your ID scope>
set IOTHUB_DEVICE_DPS_DEVICE_ID=my-pnp-device
set IOTHUB_DEVICE_DPS_DEVICE_KEY=<Your enrolment primary key>
set IOTHUB_DEVICE_DPS_ENDPOINT=global.azure-devices-provisioning.net
set IOTHUB_CONNECTION_STRING=<Your IoT hub connection string>
set IOTHUB_DEVICE_ID=my-pnp-device
Mengunduh file model
Panduan mulai cepat dan tutorial menggunakan sampel file model untuk pengontrol suhu dan perangkat termostat. Untuk mengunduh file model sampel:
Buat folder yang disebut model pada komputer lokal Anda.
Klik kanan TemperatureController.json dan simpan file JSON ke folder model.
Klik kanan Thermostat.json dan simpan file JSON ke folder model.
Memasang penjelajah Azure IoT
Panduan mulai cepat dan tutorial menggunakan alat penjelajah Azure IoT. Buka Rilis penjelajah Azure IoT dan perluas daftar aset untuk rilis terbaru. Unduh dan pasang versi terbaru aplikasi untuk sistem operasi Anda.
Pertama kali Anda menjalankan alat, Anda diminta untuk menyediakan string koneksi hub IoT. Gunakan string koneksi yang Anda catat sebelumnya.
Konfigurasikan alat untuk menggunakan file model yang Anda unduh sebelumnya. Dari beranda di alat, pilih IoT Plug and Play Pengaturan, lalu + Tambahkan > folder Lokal. Pilih folder model yang Anda buat sebelumnya. Pilih Simpan untuk menyimpan pengaturan.
Untuk mempelajari selengkapnya, lihat Memasang dan menggunakan penjelajah Azure IoT.
Membersihkan sumber daya
Anda dapat menggunakan hub IoT dan instans DPS untuk semua panduan mulai cepat dan tutorial IoT Plug and Play, jadi Anda hanya perlu menyelesaikan langkah-langkah dalam artikel ini sekali. Setelah selesai, Anda bisa menghapusnya dari langganan dengan perintah berikut:
az group delete --name my-pnp-resourcegroup
Langkah berikutnya
Sekarang setelah menyiapkan lingkungan, Anda dapat mencoba salah satu panduan mulai cepat atau tutorial seperti: