Rövid útmutató: Az IoT Hub Device Provisioning Service (DPS) beállítása a Bicep használatával
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.
Használja a Bash-környezetet az Azure Cloud Shellben. További információ: A Bash rövid útmutatója az Azure Cloud Shellben.
Ha inkább helyi cli-referenciaparancsokat szeretne futtatni, telepítse az Azure CLI-t. Ha Windows vagy macOS rendszert használ, fontolja meg az Azure CLI Docker-tárolóban való futtatását. További információ: Az Azure CLI futtatása Docker-tárolóban.
Ha helyi telepítést használ, jelentkezzen be az Azure CLI-be az az login parancs futtatásával. A hitelesítési folyamat befejezéséhez kövesse a terminálon megjelenő lépéseket. További bejelentkezési lehetőségekért lásd : Bejelentkezés az Azure CLI-vel.
Amikor a rendszer kéri, először telepítse az Azure CLI-bővítményt. További információ a bővítményekről: Bővítmények használata az Azure CLI-vel.
Futtassa az az version parancsot a telepített verzió és a függő kódtárak megkereséséhez. A legújabb verzióra az az upgrade paranccsal frissíthet.
- Ha az Azure PowerShell helyi használatát választja:
- Telepítse az Az PowerShell-modul legújabb verzióját.
- Csatlakozzon az Azure-fiókjához a Connect-AzAccount parancsmag használatával.
- Ha az Azure Cloud Shell használata mellett dönt:
- További információkért tekintse meg az Azure Cloud Shell áttekintését.
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:
- Microsoft.Devices/iotHubs: Létrehoz egy új Azure IoT Hubot.
- Microsoft.Devices/provisioningservices: Létrehoz egy új Azure IoT Hub-eszközkiépítési szolgáltatást, amelyhez az új IoT Hub már kapcsolódik.
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.
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.
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}
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
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
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.