Dela via

Skapa en molndistribution

  • Artikel

Om du vill distribuera dina program från molnet laddar du upp programbilder till en Azure Sphere-katalog och skapar en distribution för att distribuera avbildningar till Azure Sphere-enheter. Om du vill skapa en distribution måste du vara inloggad på Azure Sphere och ha rollen Administratör. Dessutom måste dina enheter vara beredda att ta emot molndistributioner.

För att vara giltig måste en distribution följa dessa regler:

  • Distributionens totala storlek måste vara mindre än 1 MiB.
  • Distributionen får inte ha fler än en tavlas konfigurationsfil.

Förbereda enheter

Innan enheterna kan ta emot program från molnet måste de ha en produkt och tillhöra en enhetsgrupp och kan inte ha funktionen AppDevelopment 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:

Använda portalen

  1. Logga in på Azure Portal. Om du vill hitta Azure Sphere-tjänsten går du till det övre sökfältet och anger och väljer Azure Sphere. Sidan Azure Sphere visas.
  2. Välj den katalog där du vill skapa en distribution. Se till att ditt prenumerationsfilter är korrekt inställt för att se alla kataloger och resursgrupper.
  3. Välj Hantera>produkter till vänster på katalogsidan.
  4. Klicka på + Skapa överst på katalogsidan.
  5. Ange ett namn och en beskrivning för produkten. Markera kryssrutan för att ange om standardenhetsgrupper ska skapas. Om den är markerad skapas följande standardenhetsgrupper: Utveckling, Fälttest, Utvärdering av fälttest i operativsystemet, Produktion, Utvärdering av produktionsoperativsystem.
  6. Klicka slutligen på Skapa längst ned på sidan.

Om du väljer att inte skapa standardenhetsgrupper måste en enhetsgrupp skapas manuellt och associeras till produkten:

  1. Välj Hantera>enhetsgrupper till vänster på sidan.
  2. Klicka på + Skapa överst på sidan.
  3. Välj den produkt som skapades från stegen ovan.
  4. Ange ett namn för enhetsgruppen och en kort beskrivning.
  5. Välj operativsystemets feed för enhetsgruppen. RetailEval-feeden tar emot förhandsversioner av operativsystemet före detaljhandelsflödet. RetailEval rekommenderas därför inte för produktionsenheter. Välj retail-feed för produktionsenheter.
  6. Välj uppdateringsprincipen för enhetsgruppen. UpdateAll innebär att enheter i gruppen tar os- och programuppdateringar när de är tillgängliga. No3rdPartyAppUpdates innebär att enheter i gruppen endast tar os-uppdateringar.

Använda CLI

Dricks

Vi rekommenderar att du konfigurerar standardvärdena för parametrarna prenumeration, resursgrupp och katalog. Detta minskar redundansen och kan avsevärt förkorta CLI-kommandosyntaxen.

Om du inte har angett den aktiva prenumerationen krävs parametern --subscription för alla kommandon. Du kan ange den aktiva prenumerationen med kommandot az account set --subscription <subscription-name>.

Använd kommandot az sphere product create.

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

az sphere device-group create Använd kommandot för att skapa en enhetsgrupp och associera den med produkten.

az sphere device-group create --resource-group MyResourceGroup --catalog MyCatalog   --name "My Development Device Group" --product MyProduct -d "development device group for MyProduct"

Distributioner riktar sig till enhetsgrupper. Enheter måste tilldelas till en enhetsgrupp som har molnuppdateringar aktiverade innan enheter kan ta emot distribuerade program. Som standard har varje produkt fem enhetsgrupper: Produktion, Fälttest, Utveckling, Utvärdering av fälttest i operativsystemet och Utvärdering av produktionsoperativsystem. Du kan använda en av dessa enhetsgrupper eller skapa en egen. Om du vill ta reda på om en enhetsgrupp accepterar molnuppdateringar använder du az sphere device-group show.

Enheter i enhetsgruppen måste förberedas för molninläsning. Det innebär att de inte får ha funktionen appUtveckling . Enheter som levereras direkt från fabriken har vanligtvis inte funktionen appUtveckling . Funktionen läggs till när kommandot az sphere device enable-development används.

Om du vill ta bort funktionen appDevelopment använder du az sphere device enable-cloud-test:

Använda CLI

Använd kommandot az sphere device enable-cloud-test.

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

Skapa en distribution för en enhetsgrupp

Distributioner är uppsättningar av avbildningar som ska distribueras till alla enheter i en enhetsgrupp. En distribution kan innehålla både program- och brädkonfigurationer. Varje distribution är länkad till en specifik enhetsgrupp inom en specifik produkt. Du måste inkludera antingen produktnamnet och enhetsgruppens namn (som följande exempel visar) eller enhetsgrupps-ID:t när du skapar distributionen.

Använda portalen

  1. Logga in på Azure Portal. Om du vill hitta Azure Sphere-tjänsten går du till det övre sökfältet och anger och väljer Azure Sphere. Sidan Azure Sphere visas.
  2. Välj den katalog där du vill skapa en distribution. Se till att ditt prenumerationsfilter är korrekt inställt för att se alla kataloger och resursgrupper.
  3. Välj Hantera>produkter till vänster på sidan.
  4. Nästa sida visar en tabell med alla skapade produkter listade. Välj den produkt som du vill skapa en distribution för.
  5. En tabell visar alla enhetsgrupper som är associerade med den valda produkten. Välj den enhetsgrupp som du vill skapa en distribution för.
  6. Välj fliken Distributioner .
  7. Klicka på +Skapa under fliken distributioner.
  8. I vyn som visas väljer du och befintlig bild eller klickar på +Lägg till för att ladda upp en ny bild.
  9. Klicka på +Skapa längst ned i vyn.

Använda CLI

Slutför stegen i Förbered enheter innan du fortsätter:

  1. Ladda upp ett avbildningspaket och anteckna imageId som returneras av kommandot:

    az sphere image add --resource-group MyResourceGroup --catalog MyCatalog --image-path myImage.imagepackage

  2. azsphere image-package show Använd kommandot för att hämta imageId för avbildningspaketet:

    azsphere image-package show --image-package myImage.imagepackage

    Kommentar

    image-package show stöds för närvarande inte i Azure CLI-tillägget.

    Kommandot returnerar information om avbildningspaketet, inklusive imageId:

    Image package metadata:
  Section: Identity
   Image Type: Application
   Component ID: 1689d8b2-c835-2e27-27ad-e894d6d15fa9
   Image ID: be3f90bd-849f-487e-a170-7fe1ff03fe2d
  Section: Signature
   Signing Type: ECDsa256
   Cert: a8d5cc6958f48710140d7a26160fc1cfc31f5dfO
  Section: Debug 
   Image Name:       myImage
   Built On (UTC):   02/21/22 16:21:58
   Built On (Local): 02/21/22 16:21:58
  Section: Temporary Image

  3. Skapa en ny distribution för en enhetsgrupp:

    az sphere deployment create --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --images <imageId returned from previous step>

Flera bilder kan tillhandahållas parametern --images med en blankstegsavgränsad lista över bild-ID:t.

Om du vill visa en lista över enhetsgrupper i en katalog använder du listan az sphere device-group.

Om du vill visa en lista över alla avbildningar i en katalog använder du az sphere-bildlistan.

Uppdatera en distribution

Det går inte att uppdatera en distribution. I stället måste en ny distribution skapas. Upprepa stegen från föregående avsnitt och uppdatera parametrarna där det behövs.