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 du måste ha administratörsrollen. Dessutom måste dina enheter vara beredda att ta emot molndistributioner.

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.

Förbereda enheter

Innan 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:

Använda portalen

    • Logga in på Azure Portal.
    • Om du vill hitta Azure Sphere-tjänsten går du till det övre sökfältet, anger och väljer Azure Sphere. Azure Sphere-sidan visas.
  2. Välj den katalog där du vill skapa en distribution. Kontrollera att ditt prenumerationsfilter är inställt på rätt sätt för att se alla kataloger och resursgrupper.
  3. Välj Hantera>produkter till vänster på katalogsidan.
  4. Klicka på + Skapa högst upp på katalogsidan.
  5. Ange ett namn och en beskrivning för produkten. Markera kryssrutan för att ange om standardenhetsgrupper ska skapas. Om de markeras skapas följande standardenhetsgrupper: Utveckling, Fälttest, Utvärdering av fälttestoperativsystem, 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 kopplas till produkten:

  1. Välj Hantera>enhetsgrupper till vänster på sidan.
  2. Klicka på + Skapa högst upp på sidan.
  3. Välj den produkt som skapats enligt 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 OS-versioner före retail-feeden. 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

Tips

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

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>.

az sphere product create Använd kommandot.

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 koppla den till 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ä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.

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

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

Använda CLI

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

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 anslagstavlakonfigurationer. 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.

Använda portalen

    • Logga in på Azure Portal.
    • Om du vill hitta Azure Sphere-tjänsten går du till det övre sökfältet, anger och väljer Azure Sphere. Azure Sphere-sidan visas.
  2. Välj den katalog där du vill skapa en distribution. Kontrollera att ditt prenumerationsfilter är inställt på rätt sätt för att se alla kataloger och resursgrupper.
  3. Välj Hantera>produkter till vänster på sidan.
  4. På nästa sida visas 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 kopplade till 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 den befintliga bilden 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örbereda enheter innan du fortsätter och gör sedan följande:

  1. Ladda upp ett avbildningspaket och notera det 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 avbildningspaketets avbildningspaketsid:

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

    Observera

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

    Kommandot returnerar information om avbildningspaketet, inklusive avbildnings-ID:

    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 skickas till parametern --images med hjälp av en blankstegsavgränsad lista med bild-ID:er.

Om du vill visa en lista över enhetsgrupper i en katalog använder du enhetsgruppslistan az sphere.

Om du vill visa en lista med alla bilder i en katalog använder du bildlistan az sphere.

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 parametrar där det behövs.