Skapa en distribution
Om du vill distribuera dina program från molnet laddar du upp programbilderna till Azure Sphere-klientorganisationen och skapar en distribution för att distribuera avbildningarna till Azure Sphere-enheter. Om du vill skapa en distribution måste du vara inloggad på Azure Sphere och du måste ha administratörsrollen. Dessutom måste dina enheter vara beredda att ta emot molndistributioner.
Observera
Varje komponent i en distribution måste ha ett unikt GUID. Om du baserar programmet på ett Azure Sphere-exempel ska du komma ihåg att skapa ett unikt GUID för programmet innan du skapar en distribution för att undvika eventuella konflikter.
Förbereda enheterna
Innan dina enheter kan ta emot program från molnet måste de ha en produkt och tillhöra en enhetsgrupp och kan inte ha apputvecklingsfunktionen installerad.
Om du inte redan har skapat en produkt för dina enheter måste du göra det innan du kan skapa en distribution. Så här skapar du en produkt:
azsphere product create --name <product-name>
Ersätt <produktnamnet> med ett namn för produkten, till exempel DW100. Mer information om det här kommandot finns i azsfärprodukt .
Distributioner riktar sig till enhetsgrupper, så du måste också tilldela dina enheter till en enhetsgrupp som aktiverar molnuppdateringar innan de kan ta emot dina distribuerade program. Som standard har varje produkt fem enhetsgrupper: Produktion, Fälttest, Utveckling, Utvärdering av fälttestoperativsystem och Utvärdering av produktionsoperativsystem. Du kan använda någon av dessa enhetsgrupper eller skapa en egen. Om du vill ta reda på om en enhetsgrupp accepterar molnuppdateringar använder du bildspelet azsfärenhetsgrupp.
Enheterna måste också förberedas för molninläsning, vilket innebär att de inte har appUtvecklingsfunktion . Enheter har inte den här funktionen när de levereras från fabriken. Men om du har använt en enhet för programutveckling har du förmodligen lagt till den här funktionen med azsfärenhetens aktivera-utvecklingskommando (kallas azsfärenhet prep-debug i tidigare förhandsversioner av SDK).
Om du vill ta bort funktionen använder du azsfärenhet enable-cloud-test:
azsphere device enable-cloud-test --device-group <device-group-ID> or '<product-name>/<device-group-name>'
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. Mer information finns i Skapa distribution.
Skapa en distribution för en enhetsgrupp
Distributioner kan innehålla både program- och anslagstavlor och båda hanteras på samma sätt när du skapar en distribution. Distributioner är uppsättningar av avbildningar som ska distribueras till alla enheter i en enhetsgrupp. Varje distribution är länkad till en viss enhetsgrupp i en viss produkt. Du måste inkludera antingen produktnamnet och enhetsgruppens namn (som i följande exempel) eller enhetsgrupp-ID:t när du skapar distributionen.
Så här skapar du en distribution:
Ladda upp avbildningspaketet:
azsphere image add --image <path-to-image> --regional-data-boundary <value>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 '<product-name>/<device-group-name>' --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.
Parametern --images tillhandahåller avbildnings-ID:t för avbildningspaketfilen för programmet. Avbildningen laddas upp till den aktuella klientorganisationen.
Parametern --regional-data-boundary anger den regionala datagränsen för den här avbildningen. Tillåtna värden är EU och None. Standardvärdet är None. Om inget värde anges används standardvärdet.
Till exempel:
azsphere image add --image my-app.imagepackage --regional-data-boundary "None"
azsphere device-group deployment create --device-group "DW100/Field Test" --images e3769536-dc4b-48d9-afd4-22ed321ba4bc
Regler för en giltig distribution
För att vara giltig måste en distribution följa följande regler:
- Distributionens totala storlek måste vara mindre än 1 MiB.
- Distributionen kan inte ha fler än en konfigurationsfil för anslagstavlor.
Uppdatera en distribution
Om du vill uppdatera en distribution använder du distributionskommandona för azsfäravbildningen add och azsfärenhetsgruppen igen, enligt beskrivningen i föregående avsnitt, och anger sökvägen till den uppdaterade programfilen.