Hantera IoT Edge-distributionsmanifest i ditt IoT Central-program
Med ett distributionsmanifest kan du ange de moduler som IoT Edge-körningen ska ladda ned och konfigurera. En IoT Edge-enhet kan ladda ned ett distributionsmanifest när den först ansluter till ditt IoT Central-program. Den här artikeln beskriver hur du hanterar distributionsmanifest i ditt IoT Central-program.
Mer information om IoT Edge och IoT Central finns i Anslut Azure IoT Edge-enheter till ett Azure IoT Central-program.
Information om hur du hanterar distributionsmanifest med hjälp av IoT Central REST API finns i Så här använder du IoT Central REST API för att hantera distributionsmanifest.
Hantera distributionsmanifest
På sidan Edge-manifest kan du hantera distributionsmanifesten i ditt program. På den här sidan kan du:
- Ladda upp eller skapa distributionsmanifest
- Ändra befintliga distributionsmanifest
- Ta bort distributionsmanifest
Ladda upp och skapa distributionsmanifest
När du skapar ett nytt distributionsmanifest kan du ladda upp JSON-filen för distributionsmanifestet eller börja med ett befintligt manifest:
På sidan Edge-manifest väljer du + Ny.
Ange ett namn för distributionsmanifestet.
Om ditt program använder organisationer väljer du en organisation att associera distributionsmanifestet med.
Bläddra efter en distributionsmanifestfil för att ladda upp eller välj ett befintligt distributionsmanifest som startpunkt för den nya. IoT Central validerar alla uppladdade filer.
Välj Nästa. Sidan Granska och slutför visar information om distributionsmanifestet och de moduler som definieras. Du kan också visa rå JSON.
Välj Skapa. Sidan Edge-manifest innehåller nu det nya distributionsmanifestet .
Dricks
Om du har ett stort antal distributionsmanifest kan du sortera och filtrera listan som visas på sidan Edge-manifest .
Redigera JSON-källan för ett distributionsmanifest
Så här ändrar du ett distributionsmanifest genom att redigera JSON direkt:
Gå till sidan Edge-manifest .
Välj Redigera JSON på snabbmenyn för distributionsmanifestet som du vill ändra.
Använd JSON-redigeraren för att göra nödvändiga ändringar. Välj sedan Spara.
Ersätt innehållet i ett distributionsmanifest
Så här ersätter du innehållet i ett distributionsmanifest helt:
Gå till sidan Edge-manifest .
Välj det distributionsmanifest som du vill ersätta.
I dialogrutan Anpassa bläddrar du efter en ny distributionsmanifestfil för att ladda upp eller välja ett befintligt distributionsmanifest som utgångspunkt. IoT Central validerar alla uppladdade filer.
Välj Nästa. Sidan Granska och slutför visar information om det nya distributionsmanifestet och de moduler som definieras. Du kan också visa rå JSON.
Välj Spara. Sidan Edge-manifest innehåller nu det uppdaterade distributionsmanifestet .
Hantera IoT Edge-enheter
När du lägger till en IoT Edge-enhet på enhetssidan kan du välja ett distributionsmanifest för enheten. I dialogrutan Skapa en ny enhet kan du välja från listan över tidigare uppladdade enhetsmanifest på sidan Edge-manifest. Det går också att lägga till ett distributionsmanifest direkt till en enhet när du har skapat enheten.
Om du lägger till en IoT Edge-enhet som inte är tilldelad till en enhetsmall ser dialogrutan Skapa en ny enhet ut som följande skärmbild:
Så här väljer du distributionsmanifestet för enheten:
Växla Azure IoT Edge-enhet? till Ja.
Välj det IoT Edge-distributionsmanifest som ska användas. Du kan också välja att tilldela ett distributionsmanifest när du har skapat enheten.
Välj Skapa.
Om du lägger till en IoT Edge-enhet som har tilldelats en enhetsmall ser dialogrutan Skapa en ny enhet ut som följande skärmbild:
Så här väljer du distributionsmanifestet för enheten:
Azure IoT Edge-enheten? är redan inställd på Ja eftersom IoT Central identifierar att du använder en IoT Edge-enhetsmall.
Välj det IoT Edge-distributionsmanifest som ska användas. Du kan också välja att tilldela ett distributionsmanifest när du har skapat enheten.
Välj Skapa.
När en IoT Edge-enhet ansluter till ditt program för första gången laddar den ned distributionsmanifestet, konfigurerar de moduler som anges i distributionsmanifestet och kör modulerna.
Om du inte väljer ett distributionsmanifest när du skapar en IoT Edge-enhet kan du tilldela en senare antingen individuellt eller till flera enheter med hjälp av ett jobb.
Uppdatera distributionsmanifestet som en enhet använder
Du kan hantera distributionsmanifestet för en befintlig enhet:
Använd Tilldela gränsmanifest för att välja ett tidigare uppladdat distributionsmanifest från sidan Edge-manifest . Du kan också använda det här alternativet för att manuellt meddela en enhet om du ändrar distributionsmanifestet på sidan Edge-manifest .
Använd Redigera manifest för att ändra distributionsmanifestet för den här enheten. Ändringar som du gör här påverkar inte distributionsmanifestet på sidan Edge-manifest .
Projekt
Om du vill tilldela eller uppdatera distributionsmanifestet för flera enheter använder du ett jobb. Använd jobbtypen Ändra gränsdistributionsmanifest:
Lägga till moduler och egenskaper i enhetsmallar
Ett distributionsmanifest definierar de moduler som ska köras på enheten och eventuellt skrivbara egenskaper som du kan använda för att konfigurera moduler.
Om du tilldelar en enhetsmall till en IoT Edge-enhet kanske du vill definiera modulerna och skrivbara egenskaper i enhetsmallen. Så här lägger du till moduler och egenskapsdefinitioner i en enhetsmall:
- Gå till sidan Modulsammanfattning i enhetsmallen IoT Edge.
- Välj Importera moduler från manifestet.
- Välj lämpligt distributionsmanifest i listan.
- Välj Importera. IoT Central lägger till de anpassade moduler som definierats i distributionsmanifestet i enhetsmallen. Namnen på modulerna i enhetsmallen matchar namnen på de anpassade modulerna i distributionsmanifestet. Det genererade gränssnittet innehåller egenskapsdefinitioner för de egenskaper som definierats för den anpassade modulen i distributionsmanifestet:
