Panduan Cepat: Menyiapkan Layanan Penyediaan Perangkat IoT Hub (DPS) dengan template ARM

Anda dapat menggunakan template Azure Resource Manager (template ARM) untuk menyiapkan sumber daya cloud Azure secara terprogram yang diperlukan untuk provisi perangkat Anda. Langkah-langkah ini menunjukkan cara membuat IoT hub dan IoT Hub Device Provisioning Service baru dengan template ARM. Hub IoT juga ditautkan ke sumber daya DPS menggunakan templat. Penautan ini mengizinkan sumber daya DPS untuk menetapkan perangkat ke hub berdasarkan kebijakan alokasi yang Anda konfigurasikan.

Templat Azure Resource Manager adalah file JavaScript Object Notation (JSON) yang menentukan infrastruktur dan konfigurasi untuk proyek Anda. Template tersebut menggunakan sintaksis deklaratif. Anda menjelaskan penyebaran yang Anda maksudkan tanpa menulis urutan perintah program untuk membuat penyebaran.

Mulai cepat ini menggunakan portal Azure dan Azure CLI untuk melakukan langkah-langkah terprogram yang diperlukan untuk membuat grup sumber daya dan menyebarkan templat. Namun, Anda juga dapat menggunakan PowerShell, .NET, Ruby, atau bahasa pemrograman lainnya untuk melakukan langkah-langkah ini dan menyebarkan templat Anda.

Jika lingkungan Anda memenuhi prasyarat, dan Anda sudah terbiasa menggunakan templat ARM, memilih tombol Sebarkan ke Azure akan membuka templat untuk penyebaran di portal Azure.

Jika Anda tidak memiliki akun Azure, buat akun gratis sebelum memulai.

Prasyarat

Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai menggunakan 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 Mengautentikasi ke Azure menggunakan Azure CLI.
- Saat Anda diminta, instal ekstensi Azure CLI pada penggunaan pertama. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan dan mengelola ekstensi dengan Azure CLI.
- Jalankan versi az untuk menemukan versi dan pustaka dependen yang diinstal. Untuk meningkatkan ke versi terbaru, jalankan az upgrade.

Meninjau templat

Templat yang digunakan dalam panduan cepat ini berasal dari Templat Panduan Cepat Azure.

Catatan

Saat ini tidak ada dukungan templat ARM untuk membuat pendaftaran dengan sumber daya DPS baru. Ini adalah permintaan umum dan dipahami yang sedang dipertimbangkan untuk implementasi.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.12.40.16777",
      "templateHash": "13184692430416822033"
    }
  },
  "parameters": {
    "iotHubName": {
      "type": "string",
      "metadata": {
        "description": "Specify the name of the Iot hub."
      }
    },
    "provisioningServiceName": {
      "type": "string",
      "metadata": {
        "description": "Specify the name of the provisioning service."
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Specify the location of the resources."
      }
    },
    "skuName": {
      "type": "string",
      "defaultValue": "S1",
      "metadata": {
        "description": "The SKU to use for the IoT Hub."
      }
    },
    "skuUnits": {
      "type": "int",
      "defaultValue": 1,
      "metadata": {
        "description": "The number of IoT Hub units."
      }
    }
  },
  "variables": {
    "iotHubKey": "iothubowner"
  },
  "resources": [
    {
      "type": "Microsoft.Devices/IotHubs",
      "apiVersion": "2021-07-02",
      "name": "[parameters('iotHubName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('skuName')]",
        "capacity": "[parameters('skuUnits')]"
      },
      "properties": {}
    },
    {
      "type": "Microsoft.Devices/provisioningServices",
      "apiVersion": "2022-02-05",
      "name": "[parameters('provisioningServiceName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('skuName')]",
        "capacity": "[parameters('skuUnits')]"
      },
      "properties": {
        "iotHubs": [
          {
            "connectionString": "[format('HostName={0};SharedAccessKeyName={1};SharedAccessKey={2}', reference(resourceId('Microsoft.Devices/IotHubs', parameters('iotHubName')), '2021-07-02').hostName, variables('iotHubKey'), listkeys(resourceId('Microsoft.Devices/IotHubs', parameters('iotHubName')), '2021-07-02').value[0].primaryKey)]",
            "location": "[parameters('location')]"
          }
        ]
      },
      "dependsOn": [
        "[resourceId('Microsoft.Devices/IotHubs', parameters('iotHubName'))]"
      ]
    }
  ]
}

Dua sumber daya Azure didefinisikan dalam templat sebelumnya:

Microsoft.Devices/IotHubs: Membuat hub Azure IoT baru.
Microsoft.Devices/provisioningServices: Membuat instans Azure IoT Hub Device Provisioning Service baru dengan hub IoT baru yang sudah ditautkan ke instans tersebut.

Menyebarkan templat

Menerapkan menggunakan Portal

Pilih gambar berikut untuk masuk ke Azure dan buka template untuk penyebaran. Templat membuat hub IoT dan sumber daya DPS baru. Hub IoT baru ditautkan ke sumber daya DPS.

Pilih atau masukkan nilai berikut dan pilih Tinjau + Buat.

Cuplikan layar memperlihatkan parameter penyebaran templat ARM di portal Microsoft Azure.

Kecuali ditentukan lain untuk bidang berikut, gunakan nilai default untuk membuat hub IoT dan sumber daya DPS.

Bidang	Deskripsi
Langganan	Pilih langganan Azure Anda.
Grup sumber daya	Pilih Buat baru, dan masukkan nama unik untuk grup sumber daya, lalu pilih OK.
Wilayah	Pilih wilayah untuk sumber daya Anda. Misalnya, US Timur. Untuk ketahanan dan keandalan, sebaiknya sebarkan ke salah satu wilayah yang mendukung Zona Ketersediaan.
Nama IoT Hub	Masukkan nama untuk hub IoT yang harus unik secara global dalam namespace .azure-devices.net . Anda memerlukan nama hub di bagian berikutnya ketika memvalidasi proses penyebaran.
Nama Layanan Provisi	Masukkan nama untuk sumber daya Device Provisioning Service (DPS) baru. Nama harus unik secara global dalam namespace .azure-devices-provisioning.net. Anda memerlukan nama DPS di bagian selanjutnya ketika memvalidasi penyebaran.

Pada layar berikutnya, baca ketentuan. Jika Anda menyetujui semua persyaratan, pilih Buat.

Proses penyebaran membutuhkan waktu beberapa saat untuk selesai.

Selain portal Microsoft Azure, Anda juga dapat menggunakan Azure PowerShell, Azure CLI, dan REST API. Untuk mempelajari metode penyebaran lainnya, lihat Menyebarkan sumber daya dengan templat ARM dan Azure PowerShell.

Menyebarkan dengan Azure CLI

Pengunaan Azure CLI memerlukan versi 2.6 atau yang lebih baru. Jika Anda menjalankan Azure CLI secara lokal, verifikasi versi Anda dengan menjalankan: az --version

Masuklah ke akun Azure Anda dan pilih langganan Anda.

Jika Anda menjalankan Azure CLI secara lokal alih-alih menjalankannya di portal, Anda perlu masuk. Untuk masuk di prompt perintah, jalankan perintah az login :
```
az login
```
Ikuti instruksinya untuk mengautentikasi menggunakan kode dan masuk ke akun Azure Anda melalui browser web.
Jika Anda memiliki beberapa langganan Azure, maka masuk ke Azure akan memberi Anda akses ke semua akun Azure yang terkait dengan informasi masuk Anda. Gunakan perintah az account list berikut untuk mencantumkan akun Azure yang tersedia untuk Anda gunakan:
```
az account list -o table
```
Gunakan perintah az account set berikut untuk memilih langganan yang ingin Anda gunakan untuk menjalankan perintah untuk membuat hub IoT dan sumber daya DPS Anda. Anda dapat menggunakan nama atau ID langganan dari output perintah sebelumnya:
```
az account set --subscription {your subscription name or id}
```

Salin dan tempel perintah berikut ke dalam prompt CLI Anda. Kemudian jalankan perintah dengan memilih tombol Enter.

Petunjuk

Perintah meminta Anda untuk memasukkan lokasi grup sumber daya. Anda dapat melihat daftar lokasi yang tersedia dengan terlebih dahulu menjalankan perintah berikut:

az account list-locations -o table

read -p "Enter a project name that is used for generating resource names:" projectName &&
read -p "Enter the location (i.e. centralus):" location &&
templateUri="https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.devices/iothub-device-provisioning/azuredeploy.json" &&
resourceGroupName="${projectName}rg" &&
az group create --name $resourceGroupName --location "$location" &&
az deployment group create --resource-group $resourceGroupName --template-uri  $templateUri &&
echo "Press [ENTER] to continue ..." &&
read

Perintah mengarahkan Anda untuk memberikan informasi berikut. Berikan setiap nilai dan pilih tombol Enter.

Pengaturan	Deskripsi
Nama proyek	Nilai parameter ini digunakan untuk membuat grup sumber daya untuk menyimpan semua sumber daya. String `rg` ditambahkan ke akhir nilai untuk nama grup sumber daya Anda.
Lokasi	Nilai ini adalah wilayah tempat semua sumber daya dibuat.
iotHubName	Masukkan nama untuk hub IoT yang harus unik secara global dalam namespace .azure-devices.net . Anda memerlukan nama hub di bagian berikutnya ketika memvalidasi proses penyebaran.
provisioningServiceName	Masukkan nama untuk sumber daya Device Provisioning Service (DPS) baru. Nama harus unik secara global dalam namespace .azure-devices-provisioning.net. Anda memerlukan nama DPS di bagian selanjutnya ketika memvalidasi penyebaran.

Azure CLI digunakan untuk menyebarkan templat. Selain Azure CLI, Anda juga dapat menggunakan Azure PowerShell, portal Microsoft Azure, dan REST API. Untuk mempelajari metode penyebaran lainnya, lihat Menyebarkan templat.

Meninjau sumber daya yang disebarkan

Untuk memverifikasi penyebaran, jalankan perintah daftar sumber daya az berikut untuk mencantumkan sumber daya dan cari layanan provisi baru dan hub IoT dalam output:
```
 az resource list -g "${projectName}rg"
```
Untuk memverifikasi bahwa hub sudah ditautkan ke sumber daya DPS, jalankan perintah az iot dps show berikut.
```
 az iot dps show --name <Your provisioningServiceName>
```
Perhatikan hub yang ditautkan pada anggota iotHubs.

Membersihkan sumber daya

Panduan mulai cepat yang lain dalam koleksi ini dibangun berdasarkan panduan mulai cepat ini. Jika Anda berencana untuk melanjutkan dengan quickstart berikutnya atau dengan tutorial, jangan hapus sumber daya yang dibuat dalam quickstart ini. Jika Anda tidak berencana untuk melanjutkan, Anda dapat menggunakan portal Azure atau Azure CLI untuk menghapus grup sumber daya dan semua sumber dayanya.

Untuk menghapus grup sumber daya dan semua sumber dayanya dari portal Microsoft Azure, cukup buka grup sumber daya dan pilih Hapus grup sumber daya di bagian atas.

Untuk menghapus grup sumber daya yang disebarkan menggunakan Azure CLI:

az group delete --name "${projectName}rg"

Anda juga dapat menghapus grup sumber daya dan sumber daya individual menggunakan salah satu opsi berikut:

portal Azure
PowerShell
REST API
SDK platform yang didukung diterbitkan untuk Azure Resource Manager atau IoT Hub Device Provisioning Service

Langkah berikutnya

Dalam panduan memulai cepat ini, Anda menyebarkan hub IoT dan instans Device Provisioning Service, dan menghubungkan kedua sumber daya tersebut. Untuk mempelajari cara menggunakan pengaturan ini untuk mengonfigurasi perangkat, lanjutkan ke panduan memulai cepat untuk membuat perangkat.

Panduan cepat: Menyediakan perangkat kunci simetris yang tersimulasi

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2025-11-22