Dela via

Självstudiekurs: Skapa en molndistribution

  • Artikel

Den här snabbstarten visar hur du skapar din första molnbaserade programdistribution. Molnbaserad distribution levererar ett program via en distribution som tilldelats en enhetsgrupp i målprodukten.

I den här självstudiekursen lär du dig hur du:

  • Skapa en produkt
  • Aktivera molnbaserad distribution för din enhet
  • Skapa distributionen
  • Utlösa distribution
  • Återaktivera utveckling och felsökning

Förutsättningar

Skapa en produkt

En produkt identifierar en modell av Azure Sphere-enhet som utför en viss funktion och kör ett visst program.

Om du inte redan har en produkt skapar du en med kommandot skapa azsfärprodukt .

azsphere product create --name MyProduct --description "My First Product"

Produktnamn måste vara unika i Azure Sphere-klientorganisationen och är inte skiftlägeskänsliga. Om namnet innehåller blanksteg omger du det med dubbla citattecken i kommandon, som i exemplet.

Azsfärprodukten skapar automatiskt fem standardenhetsgrupper för den nya produkten: Utveckling, Fälttest, Produktion, Utvärdering av fälttestoperativsystem och Utvärdering av produktionsoperativsystem. Med enhetsgrupper kan du ordna dina enheter efter hur du använder dem.

Aktivera molnbaserad distribution för din enhet

Innan du testar den molnbaserade distributionsprocessen måste Azure Sphere-enheten vara redo att acceptera molnbaserade programuppdateringar. Använd azsfärenhetens aktivera-molntestkommando för att förbereda enheten:

azsphere device enable-cloud-test --product MyProduct

Det här kommandot:

  • Identifierar enheten som minproduktmodell, som skapades i föregående steg.
  • Tilldelar enheten till gruppen Fälttestenhet, som möjliggör molnbaserade programuppdateringar.
  • Inaktiverar möjligheten för SDK att läsa in program på enheten, så att endast molnbaserade program kan läsas in.

Azure Sphere-säkerhetstjänsten använder enhetsgruppen och produkten för att avgöra om programmet ska uppdateras på en enhet.

Skapa distributionen

En distribution är en uppsättning avbildningar som kan distribueras från Azure Sphere-molntjänsten till enheter inom en viss enhetsgrupp.

Så här skapar du en distribution:

  1. Ladda upp avbildningspaketet till Azure Sphere-klienten med hjälp av azsfärbildtillägg.
  2. Skapa en ny distribution för en enhetsgrupp för uppladdade avbildningar med hjälp av distribution av azsfärenheter.
  1. Ladda upp avbildningspaketet:
azsphere image add --image <path-to-image>

Resultatet ska se ut ungefär så här:

Uploading image from file 'Blink.imagepackage':
 --> Image ID:       <image-ID>
 --> Component ID:   <component-ID>
 --> Component name: 'Blink'
Removing temporary state for uploaded image.
Successfully uploaded image with ID '<image-id>' and name 'Blink' to component with ID '<component-id>'.

Du kommer att använda bild-ID:et i nästa steg.

  1. Skapa en ny distribution för en enhetsgrupp:
azsphere device-group deployment create --device-group <device-group-ID> --images <image-ID>

Eller

azsphere device-group deployment create --device-group '<product-name>/<device-group-name>' --images <image-ID>

För fälttest för produktgruppen MinProdukt och enhet kan du använda det här andra formuläret för att enkelt skapa distributionen:

azsphere device-group deployment create --device-group "MyProduct/Field Test" --images <image-ID>

Ange flera värden för --images att ange en lista med värden avgränsade med blanksteg.

Parametern --device-group identifierar enhetsgruppen. Enhetsgrupp-ID tillhandahåller en GUID, som unikt identifierar enhetsgruppen för alla produkter. Du kan också använda namnparet för produktnamn och enhetsgrupp i <formatet produktnamn>/<enhet-grupp-namn> . Det här namnparet identifierar unikt en enhetsgrupp för en viss produkt.

Ange gruppen Fälttestenhet och namnet på produkten som du skapade i Skapa en produkt.

Ersätt <bild-ID> med avbildnings-ID för det avbildningspaket som du skapade i självstudiekursen: Skapa ett program på hög nivå. Information om hur du hämtar avbildnings-ID finns i Distribution av azsfärenheter för Azure Sphere CLI.

Kontrollera att distributionen är konfigurerad med listkommandot azsfärenhetsbild .

Utlösa distributionen

I föregående steg konfigureras alla nödvändiga distributionselement. Om du vill utlösa nedladdningen direkt trycker du på knappen Återställ på Azure Sphere-enheten. Programmet ska laddas ned och starta inom några minuter och du bör se att LED-lampan börjar blinka.

Om du vill kontrollera att programmet har installerats på enheten använder du kommandot azsfärenhetsbild som är installerat på enheten. Du kanske inte ser resultatet av distributionen omedelbart. Om distributionen inte visas när du kör kommandot kan du försöka igen om några minuter. LED-lampan börjar blinka på Azure Sphere-enheten så snart distributionen är klar.

Nästa steg

När du fortsätter att utveckla och testa program vill du förmodligen läsa in dem separat tills du är redo att distribuera dem mer allmänt. Om du vill vända azsfärenhetens enable-cloud-test-kommando och aktivera enheten för utveckling och felsökning använder du azsfärenhetens aktivera-utveckling.

Gå vidare till nästa artikel för att lära dig hur du:

Skapa ett program som kan användas i realtid

Om du inte är redo att skapa realtidsprogram kanske du också vill:

Felsöka

Om du stöter på problem med ovanstående åtgärder kan du läsa felsökningsvägledning.