Skapa en distribution
Om du vill distribuera dina program från molnet laddar du upp programbilderna till Azure Sphere-katalogen och skapar en distribution för att distribuera avbildningarna till Azure Sphere-enheter. Om du vill skapa en distribution måste du vara inloggad i Azure och du måste ha rätt RBAC-behörighet. 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:
az sphere product create --resource-group MyResourceGroup --catalog MyCatalog --name MyProduct --description MyDescription
Ersätt <MinProdukt> med ett namn på produkten, till exempel DW100. Mer information om det här kommandot finns i az sphere-produkten .
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 az sphere device-group.
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 kommandot az sphere device enable-development .
Om du vill ta bort funktionen använder du az sphere device enable-cloud-test:
az sphere device enable-cloud-test --resource-group MyResourceGroup --catalog MyCatalog --device-group <device-group-ID>
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:
az sphere image add --resource-group MyResourceGroup --catalog MyCatalog --image-path <path-to-image> --regional-data-boundary <value>Skapa en ny distribution för en enhetsgrupp:
az sphere deployment create --resource-group MyResourceGroup --catalog MyCatalog --product <product-name> --device-group <device-group-ID> --images <image-ID>
Ange flera värden för --images att ange en lista med värden avgränsade med blanksteg.
Parametern --images tillhandahåller avbildnings-ID:t för avbildningspaketfilen för programmet. Avbildningen laddas upp till den aktuella katalogen.
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 (vissa parametrar har tagits bort för korthet):
az sphere image add --image my-app.imagepackage --regional-data-boundary "None"
az sphere deployment create --product "DW100" --device-group "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 az sphere-avbildningen add and az sphere deployment create commands igen, enligt beskrivningen i föregående avsnitt, och anger sökvägen till den uppdaterade programfilen.