Distribuera Azure IoT Edge-moduler från Azure-portalen

Gäller för: IoT Edge 1.4

Viktigt!

IoT Edge 1.4 är den version som stöds. Om du har en tidigare version läser du Uppdatera IoT Edge.

När du har skapat IoT Edge-moduler med din affärslogik vill du distribuera dem till dina enheter för att arbeta vid gränsen. Om du har flera moduler som fungerar tillsammans för att samla in och bearbeta data kan du distribuera dem alla samtidigt och deklarera de routningsregler som ansluter dem.

Den här artikeln visar hur Azure-portalen vägleder dig genom att skapa ett distributionsmanifest och push-överföra distributionen till en IoT Edge-enhet. Information om hur du skapar en distribution som riktar sig mot flera enheter baserat på deras delade taggar finns i Distribuera och övervaka IoT Edge-moduler i stor skala.

Förutsättningar

• En IoT-hubb i din Azure-prenumeration.

• En IoT Edge-enhet.

  Om du inte har konfigurerat en IoT Edge-enhet kan du skapa en på en virtuell Azure-dator. Följ stegen i någon av snabbstartsartiklarna för att skapa en virtuell Linux-enhet eller Skapa en virtuell Windows-enhet.

Konfigurera ett distributionsmanifest

Ett distributionsmanifest är ett JSON-dokument som beskriver vilka moduler som ska distribueras, hur data flödar mellan modulerna och önskade egenskaper för modultvillingarna. Mer information om hur distributionsmanifest fungerar och hur du skapar dem finns i Förstå hur IoT Edge-moduler kan användas, konfigureras och återanvändas.

Azure-portalen har en guide som vägleder dig genom att skapa distributionsmanifestet i stället för att skapa JSON-dokumentet manuellt. Den har tre steg: Lägg till moduler, Ange vägar och Granska distribution.

Kommentar

Stegen i den här artikeln återspeglar den senaste schemaversionen av IoT Edge-agenten och hubben. Schemaversion 1.1 släpptes tillsammans med IoT Edge version 1.0.10 och aktiverar funktionerna för modulens startordning och vägprioritering.

Om du distribuerar till en enhet som kör version 1.0.9 eller tidigare redigerar du Runtime-Inställningar i modulsteget i guiden för att använda schemaversion 1.0.

Välj enhet och lägg till moduler

1. Logga in på Azure-portalen och gå till din IoT-hubb.

2. I den vänstra rutan väljer du Enheter under menyn Enhetshantering .

3. Välj IoT Edge-målenheten i listan.

4. I det övre fältet väljer du Ange moduler.

5. I avsnittet Autentiseringsuppgifter för containerregistret på sidan anger du autentiseringsuppgifterna för åtkomst till alla privata containerregister som innehåller dina modulavbildningar.

6. I avsnittet IoT Edge-moduler på sidan väljer du Lägg till.

7. Välj någon av de tre typerna av moduler i den nedrullningsbara menyn:

   • IoT Edge-modul – Du anger modulnamnet och containeravbildningens URI. Till exempel är mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:1.0bild-URI:n för exempelmodulen SimulatedTemperatureSensor . Om modulavbildningen lagras i ett privat containerregister lägger du till autentiseringsuppgifterna på den här sidan för att komma åt avbildningen.
   • Marketplace-modul – moduler som finns på Azure Marketplace. Vissa Marketplace-moduler kräver ytterligare konfiguration, så granska modulinformationen i listan Azure Marketplace IoT Edge-moduler .
   • Azure Stream Analytics-modul – Moduler som genereras från en Azure Stream Analytics-arbetsbelastning.

8. När du har lagt till en modul väljer du modulnamnet i listan för att öppna modulinställningarna. Fyll i de valfria fälten om det behövs.

   Mer information om de tillgängliga modulinställningarna finns i Modulkonfiguration och -hantering.

   Mer information om modultvillingen finns i Definiera eller uppdatera önskade egenskaper.

9. Upprepa steg 6 till och med 8 för att lägga till ytterligare moduler i distributionen.

10. Välj Nästa: Vägar för att fortsätta till avsnittet vägar.

Ange vägar

På fliken Vägar definierar du hur meddelanden skickas mellan moduler och IoT Hub. Meddelanden skapas med namn/värde-par. Som standard innehåller den första distributionen för en ny enhet en väg som kallas route och definieras som FROM /messages/* INTO $upstream, vilket innebär att alla meddelanden som skickas av moduler skickas till din IoT-hubb.

Parametrarna Prioritet och Tid till live är valfria parametrar som du kan inkludera i en vägdefinition. Med prioritetsparametern kan du välja vilka vägar som ska bearbetas först eller vilka vägar som ska bearbetas sist. Prioritet bestäms genom att ange talet 0–9, där 0 är högsta prioritet. Med time to live-parametern kan du deklarera hur länge meddelanden i den vägen ska lagras tills de antingen bearbetas eller tas bort från kön.

Mer information om hur du skapar vägar finns i Deklarera vägar.

När vägarna har angetts väljer du Nästa: Granska + skapa för att fortsätta till nästa steg i guiden.

Granska distribution

Granskningsavsnittet visar JSON-distributionsmanifestet som skapades baserat på dina val i de föregående två avsnitten. Observera att det finns två moduler som du inte har lagt till: $edgeAgent och $edgeHub. Dessa två moduler utgör IoT Edge-körningen och krävs som standard i varje distribution.

Granska distributionsinformationen och välj sedan Skapa.

Visa moduler på enheten

När du har distribuerat moduler till enheten kan du visa alla på sidan med enhetsinformation i din IoT Hub. På den här sidan visas namnet på varje distribuerad modul samt användbar information som distributionsstatus och slutkod.

Distribuera moduler från Azure Marketplace

Azure Marketplace är en marknadsplats för onlineprogram och tjänster där du kan bläddra igenom en mängd olika företagsprogram och lösningar som är certifierade och optimerade för att köras på Azure, inklusive IoT Edge-moduler.

Du kan distribuera en IoT Edge-modul från Azure Marketplace och från din IoT Hub.

Distribuera från Azure Marketplace

Granska IoT Edge-modulerna på Marketplace och när du hittar den du vill kan du distribuera den genom att välja Skapa eller Hämta nu. Fortsätt med distributionsguidens steg som kan variera beroende på vilken IoT Edge-modul du har valt:

1. Bekräfta leverantörens användningsvillkor och sekretesspolicy genom att välja Fortsätt. Du kan först behöva ange kontaktinformation.
2. Välj din prenumeration och den IoT Hub som målenheten är ansluten till.
3. Välj Distribuera till en enhet.
4. Ange namnet på enheten eller välj Hitta enhet för att bläddra bland de enheter som registrerats med hubben.
5. Välj Skapa för att fortsätta standardprocessen för att konfigurera ett distributionsmanifest, inklusive att lägga till andra moduler om du vill. Information om den nya modulen, till exempel bild-URI, skapa alternativ och önskade egenskaper, är fördefinierade men kan ändras.

Kontrollera att modulen har distribuerats i din IoT Hub i Azure-portalen. Välj din enhet, välj Ange moduler och modulen ska visas i avsnittet IoT Edge-moduler .

Distribuera från Azure IoT Hub

Du kan snabbt distribuera en modul från Azure Marketplace till din enhet i din IoT Hub i Azure-portalen.

1. Gå till din IoT-hubb på Azure Portal.
2. I den vänstra rutan väljer du Enheter under menyn Enhetshantering .
3. Välj den IoT Edge-enhet som ska ta emot distributionen.
4. I det övre fältet väljer du Ange moduler.
5. I avsnittet IoT Edge-moduler klickar du på Lägg till och väljer Marketplace-modul på den nedrullningsbara menyn.

Välj en modul på marketplace-sidan för IoT Edge-modulen . Den modul som du väljer konfigureras automatiskt för din prenumeration, resursgrupp och enhet. Den visas sedan i din lista över IoT Edge-moduler. Vissa moduler kan kräva ytterligare konfiguration.

Dricks

Informationen om IoT Edge-moduler från Azure IoT Hub är begränsad. Du kan först lära dig mer om IoT Edge-modulerna på Azure Marketplace.

Välj Nästa: Vägar och fortsätt med distributionen enligt beskrivningen i Ange vägar och Granska distribution tidigare i den här artikeln.

Nästa steg

Lär dig hur du distribuerar och övervakar IoT Edge-moduler i stor skala