Share via

Een cloudimplementatie maken

  • Artikel

Als u uw toepassingen vanuit de cloud wilt implementeren, uploadt u toepassingsinstallatiekopieën naar een Azure Sphere-catalogus en maakt u een implementatie om installatiekopieën te distribueren naar Azure Sphere-apparaten. Als u een implementatie wilt maken, moet u zijn aangemeld bij Azure Sphere en moet u de rol Beheerder hebben. Bovendien moeten uw apparaten zijn voorbereid op het ontvangen van cloudimplementaties.

Een implementatie moet aan deze regels voldoen om geldig te zijn:

  • De totale grootte van de implementatie moet kleiner zijn dan 1 MiB.
  • De implementatie mag niet meer dan één bordconfiguratiebestand hebben.

Apparaten voorbereiden

Voordat apparaten toepassingen van de cloud kunnen ontvangen, moeten ze een product hebben en deel uitmaken van een apparaatgroep en mogen ze niet de AppDevelopment-functie hebben geïnstalleerd.

Als u nog geen product voor uw apparaten hebt gemaakt, moet u dit doen voordat u een implementatie kunt maken. Een product maken:

De portal gebruiken

    • Meld u aan bij Azure Portal.
    • Als u de Azure Sphere-service wilt zoeken, voert u In de bovenste zoekbalk Azure Sphere in en selecteert u deze. De pagina Azure Sphere wordt weergegeven.
  2. Selecteer de catalogus waarin u een implementatie wilt maken. Zorg ervoor dat het abonnementsfilter juist is ingesteld om alle catalogi en resourcegroepen te zien.
  3. Selecteer Producten beheren> aan de linkerkant van de cataloguspagina.
  4. Klik op + Maken boven aan de cataloguspagina.
  5. Voer een naam en beschrijving in voor het product. Schakel het selectievakje in om aan te geven of standaardapparaatgroepen moeten worden gemaakt. Als deze optie is gemarkeerd, worden de volgende standaardapparaatgroepen gemaakt: Ontwikkeling, Veldtest, Evaluatie van veldtest besturingssysteem, Productie, Evaluatie van productiebesturingssystemen.
  6. Klik ten slotte op Maken onderaan de pagina.

Als u ervoor kiest geen standaardapparaatgroepen te maken, moet er handmatig een apparaatgroep worden gemaakt en aan het product worden gekoppeld:

  1. Selecteer Apparaatgroepen beheren> aan de linkerkant van de pagina.
  2. Klik boven aan de pagina op + Maken .
  3. Selecteer het product dat u hebt gemaakt in de bovenstaande stappen.
  4. Voer een naam in voor de apparaatgroep en een korte beschrijving.
  5. Selecteer de besturingssysteemfeed voor de apparaatgroep. De RetailEval-feed ontvangt voorlopige versies van het besturingssysteem voorafgaand aan de Retail-feed . De RetailEval wordt daarom niet aanbevolen voor productieapparaten. Selecteer de retailfeed voor productieapparaten.
  6. Selecteer het updatebeleid voor de apparaatgroep. UpdateAll betekent dat apparaten in de groep besturingssysteem- en toepassingsupdates moeten uitvoeren wanneer deze beschikbaar zijn. No3rdPartyAppUpdates betekent dat apparaten in de groep alleen besturingssysteemupdates nodig hebben.

De CLI gebruiken

Tip

U wordt aangeraden de standaardwaarden te configureren voor de parameters abonnement, resourcegroep en catalogus. Dit helpt de redundantie te verminderen en kan de syntaxis van de CLI-opdracht aanzienlijk verkorten.

Tenzij u het actieve abonnement hebt ingesteld, is de --subscription parameter vereist voor alle opdrachten. U kunt het actieve abonnement instellen met behulp van de opdracht az account set --subscription <subscription-name>.

Gebruik de az sphere product create opdracht.

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

Gebruik de az sphere device-group create opdracht om een apparaatgroep te maken en deze te koppelen aan het product.

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

Implementaties doelapparaatgroepen. Apparaten moeten worden toegewezen aan een apparaatgroep waarvoor cloudupdates zijn ingeschakeld voordat apparaten geïmplementeerde toepassingen kunnen ontvangen. Elk product heeft standaard vijf apparaatgroepen: Productie, Veldtest, Ontwikkeling, Evaluatie van het veldtest besturingssysteem en Evaluatie van productiebesturingssystemen. U kunt een van deze apparaatgroepen gebruiken of uw eigen apparaatgroepen maken. Als u wilt weten of een apparaatgroep cloudupdates accepteert, gebruikt u az sphere device-group show.

Apparaten binnen de apparaatgroep moeten worden voorbereid op het laden in de cloud. Dit betekent dat ze niet over de appDevelopment-mogelijkheid mogen beschikken. Apparaten die rechtstreeks vanuit de fabriek worden verzonden, hebben doorgaans niet de appDevelopment-mogelijkheid . De mogelijkheid wordt toegevoegd wanneer de opdracht az sphere device enable-development wordt gebruikt.

Als u de appDevelopment-mogelijkheid wilt verwijderen, gebruikt u az sphere device enable-cloud-test:

De CLI gebruiken

Gebruik de az sphere device enable-cloud-test opdracht.

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

Een implementatie maken voor een apparaatgroep

Implementaties zijn sets installatiekopieën die moeten worden gedistribueerd naar alle apparaten binnen een apparaatgroep. Een implementatie kan zowel toepassingen als bordconfiguraties bevatten. Elke implementatie is gekoppeld aan een specifieke apparaatgroep binnen een specifiek product. U moet de productnaam en de naam van de apparaatgroep (zoals in het volgende voorbeeld wordt weergegeven) of de id van de apparaatgroep opnemen wanneer u de implementatie maakt.

De portal gebruiken

    • Meld u aan bij Azure Portal.
    • Als u de Azure Sphere-service wilt zoeken, voert u In de bovenste zoekbalk Azure Sphere in en selecteert u deze. De pagina Azure Sphere wordt weergegeven.
  2. Selecteer de catalogus waarin u een implementatie wilt maken. Zorg ervoor dat het abonnementsfilter juist is ingesteld om alle catalogi en resourcegroepen te zien.
  3. Selecteer Producten beheren> aan de linkerkant van de pagina.
  4. Op de volgende pagina ziet u een tabel met alle gemaakte producten. Selecteer het product waarvoor u een implementatie wilt maken.
  5. Een tabel toont alle apparaatgroepen die zijn gekoppeld aan het gekozen product. Selecteer de apparaatgroep waarvoor u een implementatie wilt maken.
  6. Selecteer het tabblad Implementaties .
  7. Klik op +Maken onder het tabblad Implementaties.
  8. Selecteer en bestaande afbeelding in de weergave die wordt weergegeven of klik op +Toevoegen om een nieuwe afbeelding te uploaden.
  9. Klik onder aan de weergave op +Maken.

De CLI gebruiken

Voer de stappen in Apparaten voorbereiden voordat u doorgaat uit en voer vervolgens de volgende stappen uit:

  1. Upload een afbeeldingspakket en noteer de imageId die is geretourneerd met de opdracht:

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

  2. Gebruik de azsphere image-package show opdracht om de imageId van het installatiekopieënpakket op te halen:

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

    Opmerking

    image-package show wordt momenteel niet ondersteund in de Azure CLI-extensie.

    De opdracht retourneert informatie over het installatiekopieënpakket, inclusief de 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. Maak een nieuwe implementatie voor een apparaatgroep:

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

Er kunnen meerdere installatiekopieën aan de --images parameter worden verstrekt met behulp van een door spaties gescheiden lijst met afbeeldings-id's.

Als u apparatengroepen in een catalogus wilt weergeven, gebruikt u az sphere device-group list.

Gebruik az sphere image list om alle afbeeldingen in een catalogus weer te geven.

Een implementatie bijwerken

Het is niet mogelijk om een implementatie bij te werken. In plaats daarvan moet er een nieuwe implementatie worden gemaakt. Herhaal de stappen uit de vorige sectie en werk waar nodig de parameters bij.