Megosztás a következőn keresztül:

Rövid útmutató: Az IoT Hub Device Provisioning Service (DPS) beállítása a Bicep használatával

  • Cikk

Egy Bicep-fájl használatával programozott módon állíthatja be az eszközök kiépítéséhez szükséges Azure-felhőerőforrásokat. Ezek a lépések bemutatják, hogyan hozhat létre egy IoT Hubot és egy új IoT Hub Device Provisioning Service-példányt egy Bicep-fájllal. Az IoT Hub a Bicep-fájllal is kapcsolódik a DPS-erőforráshoz. Ez a csatolás lehetővé teszi, hogy a DPS-erőforrás az Ön által konfigurált foglalási szabályzatok alapján rendeljen eszközöket a központhoz.

A Bicep tartományspecifikus nyelv (DSL), amely deklaratív szintaxist használ az Azure-erőforrások üzembe helyezéséhez. Tömör szintaxist és megbízható típusbiztonságot kínál, valamint biztosítja a kódok újrafelhasználhatóságát. A Bicep a legjobb szerzői élményt nyújtja az Azure-beli infrastruktúra-kódmegoldásokhoz.

Ez a rövid útmutató az Azure PowerShellt és az Azure CLI-t használja az erőforráscsoport létrehozásához és a Bicep-fájl üzembe helyezéséhez szükséges programozott lépések végrehajtásához, de a .NET, Ruby vagy más programozási nyelvek használatával egyszerűen végrehajthatja ezeket a lépéseket, és üzembe helyezheti a Bicep-fájlt.

Előfeltételek

Ha nem rendelkezik Azure-előfizetéssel, első lépésként hozzon létre egy ingyenes Azure-fiókot.

A Bicep-fájl áttekintése

Az ebben a rövid útmutatóban használt Bicep-fájl az Azure Gyorsindítási sablonokból származik.

Feljegyzés

Jelenleg nincs Bicep-fájltámogatás az új DPS-erőforrásokkal rendelkező regisztrációk létrehozásához. Ez egy gyakori és érthető kérés, amelyet a végrehajtás során figyelembe kell venni.

@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
      }
    ]
  }
}

A fenti Bicep-fájlban két Azure-erőforrás van definiálva:

Mentse a Bicep-fájl másolatát helyileg main.bicep néven.

A Bicep-fájl üzembe helyezése

Jelentkezzen be Azure-fiókjába, és válassza ki előfizetését.

  1. Jelentkezzen be az Azure-ba a parancssorban:

    az login

    Kövesse az utasításokat a kóddal történő hitelesítéshez, és jelentkezzen be az Azure-fiókjába webböngészőből.

  2. Ha több Azure-előfizetéssel rendelkezik, az Azure-ba történő bejelentkezéssel hozzáfér a hitelesítő adatokhoz tartozó összes Azure-fiókhoz.

    az account list -o table

    Az alábbi paranccsal válassza ki azt az előfizetést, amellyel futtatni szeretné a parancsokat az IoT Hub és a DPS-erőforrások létrehozásához. Használhatja az előző parancs kimenetéből származó előfizetésnevet vagy -azonosítót:

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

  3. Telepítse a Bicep-fájlt az alábbi parancsokkal.

    Tipp.

    A parancsok egy erőforráscsoport helyét kérik. Az elérhető helyek listáját a parancs első futtatásával tekintheti meg:

    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}

    Cserélje le a(z) {IoT-Hub-name} nevet egy globálisan egyedi IoT Hub-névre, a {DPS-name} helyére pedig egy globálisan egyedi eszközkiépítési szolgáltatás (DPS) erőforrásnevet.

    Az erőforrások létrehozása néhány percet vesz igénybe.

Üzembe helyezett erőforrások áttekintése

  1. Az üzembe helyezés ellenőrzéséhez futtassa a következő parancsot, és keresse meg az új kiépítési szolgáltatást és az IoT Hubot a kimenetben:

     az resource list -g exampleRg

  2. Annak ellenőrzéséhez, hogy a központ már kapcsolódik-e a DPS-erőforráshoz, futtassa a következő parancsot.

    az iot dps show --name <Your provisioningServiceName>

Az erőforrások eltávolítása

Az ebben a gyűjteményben lévő többi rövid útmutató erre a rövid útmutatóra épül. Ha folytatni szeretné a munkát az ezt követő rövid útmutatókkal vagy az oktatóanyagokkal, ne törölje az ebben a rövid útmutatóban létrehozott erőforrásokat. Ha nem tervezi a folytatást, az Azure PowerShell vagy az Azure CLI használatával törölheti az erőforráscsoportot és annak összes erőforrását.

Ha törölni szeretne egy erőforráscsoportot és annak összes erőforrását az Azure Portalról, csak nyissa meg az erőforráscsoportot, és válassza az Erőforráscsoport törlése és a felső lehetőséget.

Az üzembe helyezett erőforráscsoport törlése:

az group delete --name exampleRG

Az erőforráscsoportokat és az egyes erőforrásokat az Azure Portal, a PowerShell vagy a REST API-k, illetve a támogatott platform SDK-k használatával is törölheti.

Következő lépések

Ebben a rövid útmutatóban üzembe helyezett egy IoT Hubot és egy Device Provisioning Service-példányt, és összekapcsolta a két erőforrást. Ha szeretné megtudni, hogyan használhatja ezt a beállítást egy eszköz kiépítéséhez, folytassa az eszköz létrehozásának rövid útmutatójával.

Rövid útmutató: Szimulált szimmetrikus kulcsú eszköz kiépítése