Een implementatie maken

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

Opmerking

Elk onderdeel in een implementatie moet een unieke GUID hebben. Als u uw toepassing baseert op een Azure Sphere-voorbeeld, moet u een unieke GUID voor uw toepassing maken voordat u een implementatie maakt om mogelijke conflicten te voorkomen.

De apparaten voorbereiden

Voordat uw 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:

az sphere product create --resource-group MyResourceGroup --catalog MyCatalog --name MyProduct --description MyDescription

Vervang <MyProduct> door een naam voor uw product, zoals DW100. Zie az sphere product voor meer informatie over deze opdracht.

Implementaties van doelapparaatgroepen, dus u moet uw apparaten ook toewijzen aan een apparaatgroep die cloudupdates inschakelt voordat ze uw 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.

De apparaten moeten ook worden voorbereid op het laden in de cloud, wat betekent dat ze niet over de appDevelopment-mogelijkheid beschikken. Wanneer apparaten vanuit de fabriek worden verzonden, beschikken ze niet over deze mogelijkheid. Als u echter een apparaat hebt gebruikt voor het ontwikkelen van toepassingen, hebt u deze mogelijkheid waarschijnlijk toegevoegd met de opdracht az sphere device enable-development .

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

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

Zie Implementatie maken voor meer informatie.

Een implementatie maken voor een apparaatgroep

Implementaties kunnen zowel toepassingen als bordconfiguraties bevatten, en beide worden op dezelfde manier verwerkt wanneer u een implementatie maakt. Implementaties zijn sets installatiekopieën die moeten worden gedistribueerd naar alle apparaten binnen een apparaatgroep. 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.

Een implementatie maken:

1. Upload het installatiekopieënpakket:

   az sphere image add --resource-group MyResourceGroup --catalog MyCatalog --image-path <path-to-image> --regional-data-boundary <value>
   

2. Maak een nieuwe implementatie voor een apparaatgroep:

   az sphere deployment create --resource-group MyResourceGroup --catalog MyCatalog --product <product-name> --device-group <device-group-ID> --images <image-ID>
   

Als u meerdere waarden wilt opgeven voor --images het invoeren van een lijst met waarden gescheiden door spaties.

De --images parameter biedt de installatiekopieën-id van het installatiekopieënpakketbestand voor de toepassing. De afbeelding wordt geüpload naar uw huidige catalogus.

De --regional-data-boundary parameter geeft de regionale gegevensgrens voor deze afbeelding op. Toegestane waarden zijn EU en None. De standaardwaarde is None. Als er geen waarde is opgegeven, wordt de standaardwaarde gebruikt.

Bijvoorbeeld (sommige parameters zijn voor beknoptheid verwijderd):

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

Regels voor een geldige implementatie

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.

Een implementatie bijwerken

Als u een implementatie wilt bijwerken, gebruikt u opnieuw de opdrachten az sphere image add en az sphere deployment create , zoals beschreven in de vorige sectie, en geeft u het pad naar het bijgewerkte toepassingsbestand op.