Útvonalak és végpontok létrehozása és törlése az Azure Resource Manager használatával
Ez a cikk bemutatja, hogyan exportálhatja az Azure IoT Hub-sablont, hogyan adhat hozzá útvonalat az IoT Hubhoz, majd hogyan helyezheti üzembe újra a sablont az IoT Hubon az Azure CLI vagy az Azure PowerShell használatával. Útvonalak és végpontok létrehozásához használjon Azure Resource Manager-sablont. Az IoT Hub végpontként az alábbi Azure-szolgáltatásokat támogatja:
- Tárolók
- Event Hubs
- Service Bus-üzenetsorok
- Service Bus-témakörök
- Cosmos DB
Az Azure Resource Manager-sablonok akkor hasznosak, ha JSON-fájl használatával szeretne erőforrásokat definiálni. Minden Azure-erőforráshoz tartozik egy sablon, amely meghatározza az adott erőforrásban használt összetevőket. Exportálhatja az összes Azure-erőforrássablont.
Fontos
Amikor Resource Manager-sablont használ egy erőforrás üzembe helyezéséhez, a sablon lecseréli az üzembe helyezni kívánt típusú meglévő erőforrásokat.
Új IoT Hub létrehozásakor nem kell felülírni egy meglévő üzembe helyezett erőforrást. Új IoT Hub létrehozásához használhat olyan alapszintű sablont , amely rendelkezik a szükséges tulajdonságokkal ahelyett, hogy egy már üzembe helyezett IoT Hubból exportálná a meglévő sablont.
Ha azonban útvonalat ad hozzá egy meglévő IoT Hubhoz, használjon egy olyan sablont, amelyet exportál az IoT Hubról annak biztosítására, hogy a frissített sablon üzembe helyezése után minden meglévő erőforrás és tulajdonság csatlakoztatva maradjon. A már üzembe helyezett erőforrások nem lesznek lecserélve. Például egy korábban üzembe helyezett exportált Resource Manager-sablon tartalmazhat tárolási információkat az IoT Hubhoz, ha csatlakoztatta azt a tárolóhoz.
Az IoT Hubban az útválasztás működésével kapcsolatos további információkért lásd : Az IoT Hub üzenet-útválasztás használata az eszközről a felhőbe irányuló üzenetek különböző végpontokra való küldéséhez. Az üzeneteket tároló, majd szimulált eszközön tesztelő útvonal beállításának lépéseit a következő oktatóanyagban tekintheti meg: Eszközadatok küldése az Azure Storage-ba az IoT Hub üzenet-útválasztásával.
Előfeltételek
Tekintse át a cikk előfeltételeit annak alapján, hogy milyen típusú végpontra szeretné irányítani az üzeneteket.
Azure-előfizetés. Ha nem rendelkezik Azure-előfizetéssel, mindössze néhány perc alatt létrehozhat egy ingyenes Azure-fiókot a virtuális gép létrehozásának megkezdése előtt.
Egy IoT Hub. Ha nem rendelkezik hubbal, kövesse az IoT Hub létrehozásához szükséges lépéseket.
Event Hubs-erőforrás (tárolóval). Ha új Event Hubs-erőforrást kell létrehoznia, olvassa el a rövid útmutatót: Eseményközpont létrehozása Resource Manager-sablonnal.
(Ajánlott) Felügyelt identitás szerepköralapú hozzáférés-vezérlési engedélyekkel az Event Hubs-névtérhez. További információ: Felügyelt identitás hitelesítése Microsoft Entra-azonosítóval az Event Hubs-erőforrások eléréséhez.
Azure Resource Manager-sablon
Ez a cikk egy Azure Resource Manager-sablont használ az Azure Portalon az IoT Hub és más Azure-szolgáltatások használatához. További információ a Resource Manager-sablonok használatáról: Mik azok az Azure Resource Manager-sablonok?
Útvonal létrehozása
Az IoT Hubban létrehozhat egy útvonalat, amellyel üzeneteket küldhet vagy eseményeket rögzíthet. Minden útvonal rendelkezik adatforrással és végpontokkal. Az adatforrás az, ahonnan üzenetek vagy eseménynaplók származnak. A végponton végződnek az üzenetek vagy az eseménynaplók. Amikor új útvonalat hoz létre az IoT Hubon, kiválaszthatja az adatforrás és a végpont helyét. Ezután útválasztási lekérdezésekkel szűrheti az üzeneteket vagy eseményeket, mielőtt azok a végpontra kerülnének.
Az IoT Hub-útvonal végpontjaként használhat eseményközpontot, Service Bus-üzenetsort vagy -témakört vagy Azure Storage-fiókot. A végpont létrehozásához használt szolgáltatásnak először az Azure-fiókjában kell lennie.
Az IoT Hub Resource Manager-sablonjának exportálása
Először exportáljon egy Resource Manager-sablont az IoT Hubról. Ha exportálja a sablont az IoT Hubról, hozzáadhat végpontokat és irányíthatja az erőforrásokat, és újra üzembe helyezheti anélkül, hogy elveszítené a meglévő beállítást.
Az Azure Portalon nyissa meg az IoT Hubot. Az Automation erőforrásmenüjében válassza az Exportálás sablon lehetőséget.
Az Exportálás sablonban a Sablon lapon hajtsa végre az alábbi lépéseket:
Tekintse meg az IoT Hubhoz létrehozott JSON-fájlt.
Törölje a jelet a Paraméterek belefoglalása jelölőnégyzetből .
Válassza a Letöltés lehetőséget a JSON-fájl helyi másolatának letöltéséhez.
A sablon számos helyőrzőt tartalmaz, amelyekkel szolgáltatásokat vagy szolgáltatásokat adhat hozzá az IoT Hubhoz. Ebben a cikkben csak azokhoz a tulajdonságokhoz adjon hozzá értékeket, amelyek a következőkben
routing
találhatók vagy vannak beágyazva.
Végpont hozzáadása a sablonhoz
Minden útvonal egy végpontra mutat, ahol az üzenetek vagy az eseménynaplók végződnek. Hozzon létre egy végpontot az IoT Hubon, amelyre az útvonal hivatkozhat. Az IoT Hub-útvonal végpontjaként használhat eseményközpontot, Service Bus-üzenetsort vagy -témakört, Azure-tárfiókot vagy Cosmos DB-tárolót. A végpont létrehozásához használt szolgáltatásnak először az Azure-fiókjában kell lennie.
Az IoT Hubnak hozzáférési engedélyekre van szüksége minden olyan végponterőforráshoz, amelybe üzeneteket vagy naplókat küld. Hozzáférést felügyelt identitásokkal és Microsoft Entra-azonosítóval vagy kapcsolati sztring használatával biztosíthat. A Microsoft azt javasolja, hogy az Entra-azonosítóval való hitelesítés a biztonságosabb megoldás.
Adjon hozzá egy Event Hubs-végpontot a Resource Manager-sablonhoz. További információ: Azure Resource Manager-sablon RoutingEventHubProperties.
A JSON-fájlban keresse meg az
"endpoints": []
alá"routing"
ágyazott tulajdonságot.Cserélje le a
"endpoints": []
sort a következő JSON-ra:"endpoints": { "serviceBusQueues": [], "serviceBusTopics": [], "eventHubs": [ { "endpointUri": "", "entityPath": "", "authenticationType": "identityBased", "identity": { "userAssignedIdentity": "" }, "name": "", "id": "", "subscriptionId": "", "resourceGroup": "" } ], "storageContainers": [], "cosmosDBSqlContainers": [] },
Frissítse a JSON-t a következő információkkal az Event Hubs-erőforrásról:
Tulajdonság Érték endpointUri (Ha a hitelesítési típus ; identityBased
egyéb esetben törölje.) Az Event Hubs-névtér gazdagépneve a formátumbansb://<eventhubs_namespace_name>.servicebus.windows.net
entityPath (Ha a hitelesítési típus ; identityBased
egyéb esetben törölje.) Az eseményközpont neve.authenticationType identityBased
vagykeyBased
. A Microsoft az identitásalapú hitelesítést javasolja biztonságosabb megoldásként.identitás (Ha a identityBased
hitelesítési típus .) Használhat felhasználó által hozzárendelt felügyelt identitást vagy rendszer által hozzárendelt felügyelt identitást, ha az IoT Hubon engedélyezve van a rendszer által hozzárendelt felügyelt identitás.
Felhasználó által hozzárendelt: A felügyelt identitás külső azonosítója, amely hozzáférési engedélyekkel rendelkezik az eseményközponthoz a formátumban/subscriptions/<subscription_id>/resourceGroups/<resource_group_name>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<identity_name>
.
Rendszer által hozzárendelt: Hagyja üres listaként az identitásparamétert. Például:"identity": {},
connectionString (Ha a keyBased
hitelesítési típus .) Az elsődleges kapcsolati sztring az eseményközpont egyik megosztott hozzáférési szabályzatából a következő formátumban<connection_string>;EntityPath=<event_hub_name>.
: Lekérheti a kapcsolati sztring értéket az Azure Portalról, majd hozzáfűzheti az entitás elérési útját.név Adjon meg egy egyedi értéket a végpont elnevezéséhez. id Hagyja üres sztringként. Az Azure szolgáltatás értéket biztosít a végpont létrehozásakor. subscriptionId Az eseményközpontot tartalmazó előfizetés azonosítója. resourceGroup Az eseményközpontot tartalmazó erőforráscsoport neve. Tipp.
Titkos kódok kezeléséhez létrehozhat egy paraméterfájlt, vagy az Azure Key Vault használatával biztonságos paraméterértékeket adhat át az üzembe helyezés során.
Útvonal hozzáadása a sablonhoz
Adjon hozzá útvonaldefiníciót a Resource Manager-sablonhoz. További információkért tekintse meg az Azure Resource Manager RouteProperties sablonját.
A JSON-fájlban keresse meg az
"routes": []
alá"routing"
ágyazott tulajdonságot, és adjon hozzá egy új útvonalat.Figyelemfelhívás
Ha a meglévő értékeket
"routes"
az alábbi kód példákban használt útvonalértékekre cseréli, a rendszer az üzembe helyezéskor eltávolítja a meglévő útvonalakat. A meglévő útvonalak megőrzéséhez adja hozzá az új útvonalobjektumot a"routes"
listához."routes": [ { "name": "", "source": "DeviceConnectionStateEvents", "condition": "true", "endpointNames": [ "" ], "isEnabled": true } ],
Frissítse a JSON-t az alábbi információkkal a Cosmos DB-erőforrásról:
Tulajdonság Érték név Adjon meg egy egyedi értéket az útvonal elnevezéséhez. forrás Válassza ki az üzenet vagy eseménynaplók forrását a végpontra való átirányításhoz. A forrásbeállítások listáját az az iot hub route című témakörben találja. feltétel A forrásadatok szűrésére szolgáló lekérdezés. Ha nincs szükség feltételre, mondjuk true
. További információ: IoT Hub üzenet-útválasztási lekérdezés szintaxisa.endpointNames Annak a meglévő végpontnak a neve, ahol az adatok átirányításra kerülnek. Jelenleg csak egy végpont engedélyezett. isEnabled true
Állítsa be az útvonal engedélyezésére vagyfalse
az útvonal letiltására.Mentse a JSON-fájlt.
A Resource Manager-sablon üzembe helyezése
A Resource Manager-sablonhoz hozzáadott új végpont és útvonal mostantól újra üzembe helyezheti a JSON-fájlt az IoT Hubon.
Helyi üzembe helyezés
az deployment group create \
--name my-iot-hub-template \
--resource-group my-resource-group \
--template-file "my\path\to\template.json"
Azure Cloud Shell üzembe helyezése
Mivel az Azure Cloud Shell webböngészőben fut, az üzembe helyezési parancs futtatása előtt feltöltheti a sablonfájlt. A feltöltött fájlhoz csak a sablonfájl nevét kell használnia template-file
(a teljes fájl elérési útja helyett).
az deployment group create \
--name my-iot-hub-template \
--resource-group my-resource-group \
--template-file "template.json"
Feljegyzés
Ha az üzembe helyezés sikertelen, a -verbose
kapcsolóval információkat kaphat a létrehozott erőforrásokról. A kapcsolóval -debug
további információt kaphat a hibakeresésről.
Az üzembe helyezés megerősítése
Annak ellenőrzéséhez, hogy a sablon sikeresen üzembe lett-e helyezve az Azure-ban, lépjen az erőforráscsoport erőforrására az Azure Portalon. A Beállítások csoport erőforrásmenüjében válassza a Központi telepítések lehetőséget a sablon megtekintéséhez az üzemelő példányok listájában.
Ha meg szeretné tekinteni az új útvonalat az Azure Portalon, nyissa meg az IoT Hub-erőforrást. Az Üzenet útválasztása panel Útvonalak lapján ellenőrizze, hogy az útvonal szerepel-e a listában.
Következő lépések
Ebben az útmutatócikkben megtanulta, hogyan hozhat létre útvonalat és végpontot az Event Hubshoz, a Service Bus-üzenetsorokhoz és -témakörökhöz, valamint az Azure Storage-hoz.
Az üzenet-útválasztással kapcsolatos további információkért tekintse meg az oktatóanyagot: Eszközadatok küldése az Azure Storage-ba az IoT Hub üzenet-útválasztásával. Az oktatóanyagban létrehoz egy tárolási útvonalat, és teszteli azt egy eszköz használatával az IoT Hubon.