Rövid útmutató: Az IoT Hub Device Provisioning Service beállítása az Azure CLI-vel
Az Azure CLI az Azure-erőforrások parancssorból vagy szkriptekkel történő létrehozására és kezelésére használható. Ez a rövid útmutató részletesen ismerteti az Azure CLI használatával egy IoT Hub és egy IoT Hub Device Provisioning Service-példány létrehozását, valamint a két szolgáltatás összekapcsolását.
Ha nem rendelkezik Azure-előfizetéssel, első lépésként hozzon létre egy ingyenes Azure-fiókot.
Fontos
Mind az IoT Hub, mind az ebben a rövid útmutatóban létrehozott kiépítési szolgáltatás nyilvánosan felderíthető LESZ DNS-végpontként. Ha úgy dönt, hogy megváltoztatja ezen erőforrások nevét, ügyeljen arra, hogy ne adjon meg bizalmas adatokat.
Előfeltételek
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.
Erőforráscsoport létrehozása
Hozzon létre egy erőforráscsoportot az az group create paranccsal. Az Azure-erőforráscsoport olyan logikai tároló, amelybe a rendszer üzembe helyezi és kezeli az Azure-erőforrásokat.
A következő példában létrehozunk egy my-sample-resource-group nevű erőforráscsoportot a westus helyen.
az group create --name my-sample-resource-group --location westus
Tipp.
Ebben a példában az erőforráscsoport az USA nyugati régiójában jön létre. Az az account list-locations -o table parancs futtatásával megtekintheti az elérhető helyek listáját.
IoT Hub létrehozása
Egy IoT Hubot az az iot hub create paranccsal hozhat létre.
A következő példában létrehozunk egy my-sample-hub nevű IoT Hubot a westus helyen. Az IoT Hub nevének globálisan egyedinek kell lennie az Azure-ban, ezért adjon hozzá egy egyedi előtagot vagy utótagot a példanévhez, vagy válasszon teljesen új nevet. Győződjön meg arról, hogy a neve megfelel az IoT Hub megfelelő elnevezési konvencióinak: 3–50 karakter hosszúságúnak kell lennie, és csak kis- vagy nagybetűs alfanumerikus karaktereket vagy kötőjeleket ('-' ) tartalmazhat.
az iot hub create --name my-sample-hub --resource-group my-sample-resource-group --location westus
Device Provisioning Service-példány létrehozása
Hozzon létre egy Device Provisioning Service-példányt az az iot dps create paranccsal.
Az alábbi példa létrehoz egy Device Provisioning Service-példányt my-sample-dps néven a Westus-helyen. Globálisan egyedi nevet is ki kell választania a saját példányához. Győződjön meg arról, hogy megfelel az IoT Hub Device Provisioning Service megfelelő elnevezési konvencióinak: 3–64 karakter hosszúságúnak kell lennie, és csak kis- vagy nagybetűs alfanumerikus karaktereket vagy kötőjeleket ('-' ) tartalmazhat.
az iot dps create --name my-sample-dps --resource-group my-sample-resource-group --location westus
Tipp.
Ebben a példában az eszközkiépítési szolgáltatás az USA nyugati régiójában jön létre. Az elérhető helyek listáját az az provider show --namespace Microsoft.Devices --query "resourceTypes[?resourceType=='ProvisioningServices'].locations | [0]" --out table parancs futtatásával vagy az Azure állapotlapjának megnyitásával, majd a „Device Provisioning Service” kifejezésre való kereséssel tekintheti meg. A parancsokban a helyek egy vagy többszavas formátumban is megadhatóak; például: westus, USA nyugati régiója, USA nyugati régiója stb. Az érték nem megkülönbözteti a kis- és nagybetűk értékét. Ha többszavas formátumot használ a hely megadásához, tegye idézőjelek közé az értéket, például: --location "West US".
A rugalmasság és a megbízhatóság érdekében javasoljuk, hogy a rendelkezésre állási zónákat támogató régiók egyikében telepítsen.
Az IoT Hub kapcsolati sztringjének lekérése
Szükség van az IoT Hub kapcsolati sztringjére a Device Provisioning Service-szel való összekapcsoláshoz. Az az iot hub connection-string show parancsával kérje le a kapcsolati sztring, és a kimenetével állítson be egy később használt változót, amikor összekapcsolja a két erőforrást.
Az alábbi példa a hub Csatlakozás ionString változót a hub iothubowner-szabályzatának elsődleges kulcsához tartozó kapcsolati sztring értékére állítja (a --policy-name paraméter egy másik szabályzat megadására használható). A korábban kiválasztott egyedi IoT Hub-névhez adja meg a saját mintaközpontot . A parancs az Azure CLI lekérdezés és kimenet lehetőségeinek használatával nyeri ki a kapcsolati sztringet a parancskimenetből.
hubConnectionString=$(az iot hub connection-string show --name my-sample-hub --key primary --query connectionString -o tsv)
A echo paranccsal megtekintheti a kapcsolati sztringet:
echo $hubConnectionString
Feljegyzés
Ez a két parancs a Bash alatt futó gazdagépek esetében érvényesek.
Ha helyi Windows/CMD-rendszerhéjat vagy PowerShell-gazdagépet használ, módosítsa a parancsokat az adott környezet megfelelő szintaxisának használatára.
Ha Azure Cloud Shellt használ, ellenőrizze, hogy a rendszerhéj ablakának bal oldalán található környezet legördülő menüben a Bash látható-e.
Az IoT Hub és az eszközkiépítési szolgáltatás csatolása
Az IoT Hub és az eszközkiépítési szolgáltatás csatolása az az iot dps linked-hub create paranccsal.
Az alábbi példa egy my-sample-hub nevű IoT Hubot kapcsol össze a Westus-helyen, és egy Device Provisioning Service-t a my-sample-dps néven. Ezeket a neveket a korábban kiválasztott egyedi IoT Hub- és Device Provisioning Service-nevekre cserélheti. A parancs a kapcsolati sztring használja a hubban tárolt IoT Hub Csatlakozás ionString változóhoz az előző lépésben.
az iot dps linked-hub create --dps-name my-sample-dps --resource-group my-sample-resource-group --connection-string $hubConnectionString --location westus
A parancs végrehajtása eltarthat néhány percig.
Eszközkiépítési szolgáltatás ellenőrzése
Eszközkiépítési szolgáltatás adatainak lekérése az az iot dps show paranccsal.
Az alábbi példa lekéri a my-sample-dps nevű eszközkiépítési szolgáltatás adatait. Adja meg ezt a nevet a saját Device Provisioning Service-nevének.
az iot dps show --name my-sample-dps
A csatolt IoT Hub a properties.iotHubs gyűjteményben jelenik meg.
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 alábbi parancsokkal törölheti a kiépítési szolgáltatást, az IoT Hubot vagy az erőforráscsoportot és annak összes erőforrását. Cserélje le a következő parancsokban szereplő erőforrások nevét a saját erőforrásai nevére.
Az eszközkiépítési szolgáltatás törléséhez futtassa az az iot dps delete parancsot:
az iot dps delete --name my-sample-dps --resource-group my-sample-resource-group
Az IoT Hub törléséhez futtassa az az iot hub delete parancsot:
az iot hub delete --name my-sample-hub --resource-group my-sample-resource-group
Erőforráscsoport és az ahhoz tartozó összes erőforrás törléséhez futtassa az az group delete parancsot:
az group delete --name my-sample-resource-group
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.