Självstudie: Skapa en molndistribution
Viktigt!
Det här är dokumentationen om Azure Sphere (Legacy). Azure Sphere (Legacy) upphör den 27 september 2027 och användarna måste migrera till Azure Sphere (integrerad) vid den här tiden. Använd versionsväljaren ovanför TOC för att visa dokumentationen om Azure Sphere (integrerad).
Den här snabbstarten visar hur du skapar din första molnbaserade programdistribution. Molnbaserad distribution levererar ett program via en distribution som tilldelats till en enhetsgrupp inom målprodukten.
I den här självstudien lär du dig att:
- Skapa en produkt
- Aktivera molnbaserad distribution för din enhet
- Skapa distributionen
- Utlösardistribution
- Återaktivera utveckling och felsökning
Förutsättningar
- Din Azure Sphere-enhet är ansluten till datorn och till Internet.
- Du har slutfört självstudien : Skapa ett högnivåprogram och ha en avbildningspaketfil för ditt program.
Skapa en produkt
En produkt identifierar en modell av En Azure Sphere-enhet som utför en specifik funktion och kör ett visst program.
Om du inte redan har en produkt skapar du en med kommandot azsphere product create .
azsphere product create --name MyProduct --description "My First Product"
Produktnamn måste vara unika i din Azure Sphere-klientorganisation och är inte skiftlägeskänsliga. Om namnet innehåller blanksteg omger du det med dubbla citattecken i kommandon, som i exemplet.
Kommandot azsphere product create skapar automatiskt fem standardenhetsgrupper för den nya produkten: Development, Field Test, Production, Field Test OS Evaluation och Production OS Evaluation. Enhetsgrupper ger dig ett sätt att organisera dina enheter enligt hur du använder dem.
Aktivera molnbaserad distribution för din enhet
Innan du testar den molnbaserade distributionsprocessen måste din Azure Sphere-enhet vara redo att acceptera molnbaserade programuppdateringar. Använd kommandot azsphere device enable-cloud-test för att förbereda enheten:
azsphere device enable-cloud-test --product MyProduct
Det här kommandot:
- Identifierar enheten som MyProduct-modellen, 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 Security Service 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 enheterna i en viss enhetsgrupp.
Så här skapar du en distribution:
- Ladda upp avbildningspaketet till din Azure Sphere-klientorganisation med azsphere image add.
- Skapa en ny distribution för en enhetsgrupp för de uppladdade avbildningarna med azsphere device-group deployment create.
- Ladda upp avbildningspaketet:
azsphere image add --image <path-to-image>
Utdata bör visa något som liknar följande:
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 avbildnings-ID:t i nästa steg.
- 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 produkten MyProduct och enhetsgruppen Field Test 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:t tillhandahåller ett GUID som unikt identifierar enhetsgruppen för alla produkter. Du kan också använda produktnamnet och enhetsgruppens namnpar i <formatet product-name>/<device-group-name> . Det här namnparet identifierar unikt en enhetsgrupp för en viss produkt.
Ange enhetsgruppen Fälttest och namnet på den produkt som du skapade i Skapa en produkt.
Ersätt <avbildnings-ID> med avbildnings-ID för avbildningspaketet som du skapade i Självstudie: Skapa ett högnivåprogram. För Azure Sphere CLI, se azsphere device-group deployment create för information om hur du hämtar avbildnings-ID:t.
Kontrollera att distributionen har konfigurerats med kommandot azsphere device image list-targeted.
Utlös distributionen
I föregående steg konfigureras alla nödvändiga distributionselement. Om du vill utlösa nedladdningen omedelbart trycker du på knappen Återställ på Azure Sphere-enheten. Programmet bör ladda ned och starta inom flera minuter, och du bör se att lysdioderna börjar blinka.
Om du vill kontrollera att programmet har installerats på enheten använder du kommandot azsphere 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. Lysdioderna 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 kommer du förmodligen att vilja läsa in dem separat tills du är redo att distribuera dem mer allmänt. Om du vill vända kommandot azsphere device enable-cloud-test och aktivera enheten för utveckling och felsökning använder du azsphere device enable-development.
Gå vidare till nästa artikel för att lära dig hur du:
Om du inte är redo att skapa realtidsprogram kanske du också vill:
Felsöka
Om du stöter på problem med åtgärderna ovan kan du läsa felsökningsvägledningen.