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 får du lära 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 az sphere product create .

az sphere product create --resource-group MyResourceGroup --catalog MyCatalog --name MyProduct --description "My First Product"

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

Az sphere-produkten 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 kommandot az sphere device enable-cloud-test för att förbereda enheten:

az sphere device enable-cloud-test --catalog MyCatalog --resource-group MyResourceGroup --product MyProduct

Det här kommandot:

  • Identifierar enheten som minproduktmodell, som skapades i föregående steg.
  • Som standard tilldelas 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.

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-katalogen med az sphere-avbildningen.

  2. Skapa en ny distribution för en enhetsgrupp för uppladdade avbildningar med hjälp av az sphere-distribution skapa.

  3. Ladda upp avbildningspaketet:

     az sphere image add --resource-group MyResourceGroup --catalog MyCatalog --image-path <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:

    az sphere deployment create --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group <device-group-ID> --images <image-ID>

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

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

  4. Ersätt <image-ID> med avbildnings-ID för det avbildningspaket som du skapade i självstudiekursen: Skapa ett program på hög nivå.

  5. Kontrollera att distributionen har konfigurerats med listkommandot az sphere image .

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 az sphere device image list-installed . 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. Använd az sphere device enable-development för att ångra az sphere device enable-cloud-test command och aktivera enheten för utveckling och felsökning.

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.

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