Sdílet prostřednictvím

Rychlý start: Nastavení služby IoT Hub Device Provisioning Service (DPS) pomocí Bicep

  • Článek

Soubor Bicep můžete použít k programovému nastavení cloudových prostředků Azure nezbytných ke zřízení zařízení. Tyto kroky ukazují, jak vytvořit centrum IoT a novou instanci služby IoT Hub Device Provisioning se souborem Bicep. IoT Hub je také propojený s prostředkem DPS pomocí souboru Bicep. Toto propojení umožňuje prostředku DPS přiřadit zařízení k centru na základě nakonfigurovaných zásad přidělování.

Bicep je jazyk specifický pro doménu (DSL), který k nasazování prostředků Azure používá deklarativní syntaxi. Poskytuje stručnou syntaxi, spolehlivou bezpečnost typů a podporu pro opakované použití kódu. Bicep nabízí nejlepší prostředí pro vytváření obsahu pro řešení infrastruktury jako kódu v Azure.

Tento rychlý start používá Azure PowerShell a Azure CLI k provádění programových kroků nezbytných k vytvoření skupiny prostředků a nasazení souboru Bicep, ale k provedení těchto kroků a nasazení souboru Bicep můžete snadno použít .NET, Ruby nebo jiné programovací jazyky.

Požadavky

Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet Azure před tím, než začnete.

Kontrola souboru Bicep

Soubor Bicep použitý v tomto rychlém startu pochází ze šablon Azure Pro rychlý start.

Poznámka:

V současné době neexistuje podpora souborů Bicep pro vytváření registrací s novými prostředky DPS. Jedná se o běžný a srozumitelný požadavek, který se považuje za implementaci.

@description('Specify the name of the Iot hub.')
param iotHubName string

@description('Specify the name of the provisioning service.')
param provisioningServiceName string

@description('Specify the location of the resources.')
param location string = resourceGroup().location

@description('The SKU to use for the IoT Hub.')
param skuName string = 'S1'

@description('The number of IoT Hub units.')
param skuUnits int = 1

var iotHubKey = 'iothubowner'

resource iotHub 'Microsoft.Devices/IotHubs@2021-07-02' = {
  name: iotHubName
  location: location
  sku: {
    name: skuName
    capacity: skuUnits
  }
  properties: {}
}

resource provisioningService 'Microsoft.Devices/provisioningServices@2022-02-05' = {
  name: provisioningServiceName
  location: location
  sku: {
    name: skuName
    capacity: skuUnits
  }
  properties: {
    iotHubs: [
      {
        connectionString: 'HostName=${iotHub.properties.hostName};SharedAccessKeyName=${iotHubKey};SharedAccessKey=${iotHub.listkeys().value[0].primaryKey}'
        location: location
      }
    ]
  }
}

Ve výše uvedeném souboru Bicep jsou definovány dva prostředky Azure:

Uložte kopii souboru Bicep místně jako main.bicep.

Nasazení souboru Bicep

Přihlaste se ke svému účtu Azure a vyberte své předplatné.

  1. Přihlaste se k Azure na příkazovém řádku:

    az login

    Postupujte podle pokynů pro ověření pomocí kódu a přihlaste se ke svému účtu Azure ve webovém prohlížeči.

  2. Pokud máte více předplatných Azure, přihlášením k Azure získáte přístup ke všem účtům Azure přidruženým k vašim přihlašovacím údajům.

    az account list -o table

    Pomocí následujícího příkazu vyberte předplatné, které chcete použít ke spuštění příkazů k vytvoření prostředků IoT Hubu a DPS. Můžete použít název nebo ID předplatného z výstupu předchozího příkazu:

    az account set --subscription {your subscription name or id}

  3. Nasaďte soubor Bicep pomocí následujících příkazů.

    Tip

    Příkazy zobrazí výzvu k zadání umístění skupiny prostředků. Seznam dostupných umístění můžete zobrazit tak, že nejprve spustíte příkaz:

    az account list-locations -o table

    az group create --name exampleRG --location eastus
az deployment group create --resource-group exampleRG --template-file main.bicep --parameters iotHubName={IoT-Hub-name} provisioningServiceName={DPS-name}

    Položku {IoT-Hub-name} nahraďte globálně jedinečným názvem služby IoT Hub, nahraďte {DPS-name} globálně jedinečným názvem prostředku služby Device Provisioning Service (DPS).

    Vytvoření prostředků chvíli trvá.

Kontrola nasazených prostředků

  1. Pokud chcete ověřit nasazení, spusťte následující příkaz a ve výstupu vyhledejte novou službu zřizování a centrum IoT:

     az resource list -g exampleRg

  2. Spuštěním následujícího příkazu ověřte, že je centrum již propojené s prostředkem DPS.

    az iot dps show --name <Your provisioningServiceName>

Vyčištění prostředků

Další rychlé starty v této kolekci jsou postavené na tomto rychlém startu. Pokud chcete pokračovat v práci s dalšími rychlými starty nebo kurzy, nevyčišťujte prostředky vytvořené v tomto rychlém startu. Pokud pokračovat nechcete, můžete pomocí Azure PowerShellu nebo Azure CLI odstranit skupinu prostředků a všechny její prostředky.

Pokud chcete odstranit skupinu prostředků a všechny její prostředky z webu Azure Portal, stačí otevřít skupinu prostředků a vybrat Odstranit skupinu prostředků a nahoře.

Odstranění nasazené skupiny prostředků:

az group delete --name exampleRG

Skupiny prostředků a jednotlivé prostředky můžete také odstranit pomocí webu Azure Portal, PowerShellu nebo rozhraní REST API nebo podporovaných sad SDK platformy.

Další kroky

V tomto rychlém startu jste nasadili centrum IoT a instanci služby Device Provisioning a propojili dva prostředky. Pokud chcete zjistit, jak pomocí tohoto nastavení zřídit zařízení, pokračujte rychlým startem pro vytvoření zařízení.

Rychlý start: Zřízení simulovaného zařízení symetrického klíče