Een implementatie maken
Belangrijk
Dit is de Documentatie voor Azure Sphere (verouderd). Azure Sphere (verouderd) wordt op 27 september 2027 buiten gebruik gesteld en gebruikers moeten tegen deze tijd migreren naar Azure Sphere (geïntegreerd). Gebruik de versiekiezer boven de inhoudsweergave om de Documentatie van Azure Sphere (geïntegreerd) weer te geven.
Als u uw toepassingen vanuit de cloud wilt implementeren, uploadt u de toepassingsinstallatiekopieën naar uw Azure Sphere-tenant 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 Sphere en moet u de beheerdersrol hebben. Daarnaast moeten uw apparaten voorbereid zijn op het ontvangen van cloudimplementaties.
Notitie
Elk onderdeel in een implementatie moet een unieke GUID hebben. Als u uw toepassing baseeert 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 tot een apparaatgroep behoren en kunnen ze de appontwikkelingsmogelijkheid niet installeren.
Als u nog geen product voor uw apparaten hebt gemaakt, moet u dit doen voordat u een implementatie kunt maken. Ga als volgende te werk om een product te maken:
azsphere product create --name <product-name>
Vervang <de productnaam> door een naam voor uw product, zoals DW100. Zie azsphere-product voor meer informatie over deze opdracht.
Implementaties zijn gericht op apparaatgroepen, dus u moet uw apparaten ook toewijzen aan een apparaatgroep die cloudupdates mogelijk maakt voordat ze uw geïmplementeerde toepassingen kunnen ontvangen. Elk product heeft standaard vijf apparaatgroepen: Productie, Veldtest, Ontwikkeling, Evaluatie van besturingssysteem voor veldtests 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 azsphere device-group show.
De apparaten moeten ook worden voorbereid op het laden van de cloud, wat betekent dat ze niet over de appOntwikkelingsmogelijkheid beschikken. Wanneer ze vanuit de fabriek worden verzonden, hebben apparaten deze mogelijkheid niet. Als u echter een apparaat hebt gebruikt voor het ontwikkelen van toepassingen, hebt u deze mogelijkheid waarschijnlijk toegevoegd met de opdracht azsphere device enable-development (genaamd azsphere device prep-debug in eerdere preview-releases van de SDK).
Als u de mogelijkheid wilt verwijderen, gebruikt u azsphere device enable-cloud-test:
azsphere device enable-cloud-test --device-group <device-group-ID> or '<product-name>/<device-group-name>'
De --device-group parameter identificeert de apparaatgroep. De apparaatgroep-id levert een GUID, waarmee de apparaatgroep uniek wordt geïdentificeerd in alle producten. U kunt ook het paar productnamen en apparaatgroepen gebruiken in de <indeling productnaam>/<apparaatgroepnaam> . Met dit paar namen wordt een apparaatgroep voor een bepaald product uniek geïdentificeerd. Zie implementatie maken voor meer informatie.
Een implementatie voor een apparaatgroep maken
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 apparaatgroepnaam (zoals in het volgende voorbeeld wordt weergegeven) of de apparaatgroep-id opnemen wanneer u de implementatie maakt.
Een implementatie maken:
Upload het installatiekopieënpakket:
azsphere image add --image <path-to-image> --regional-data-boundary <value>Maak een nieuwe implementatie voor een apparaatgroep:
azsphere device-group deployment create --device-group <device-group-ID> --images <image-ID>or
azsphere device-group deployment create '<product-name>/<device-group-name>' --images <image-ID>
Als u meerdere waarden wilt opgeven voor --images het invoeren van een lijst met waarden gescheiden door spaties.
De --device-group parameter identificeert de apparaatgroep. De apparaatgroep-id levert een GUID, waarmee de apparaatgroep uniek wordt geïdentificeerd in alle producten. U kunt ook het paar productnamen en apparaatgroepen gebruiken in de <indeling productnaam>/<apparaatgroepnaam> . Met dit paar namen wordt een apparaatgroep voor een bepaald product uniek geïdentificeerd.
De --images parameter biedt de installatiekopieën-id van het installatiekopieënpakketbestand voor de toepassing. De afbeelding wordt geüpload naar uw huidige tenant.
Met --regional-data-boundary de parameter wordt de regionale gegevensgrens voor deze afbeelding opgegeven. Toegestane waarden zijn EU en None. De standaardwaarde is None. Als er geen waarde is opgegeven, wordt de standaardwaarde gebruikt.
Voorbeeld:
azsphere image add --image my-app.imagepackage --regional-data-boundary "None"
azsphere device-group deployment create --device-group "DW100/Field Test" --images e3769536-dc4b-48d9-afd4-22ed321ba4bc
Regels voor een geldige implementatie
Een implementatie moet de volgende regels volgen om geldig te zijn:
- De totale grootte van de implementatie moet kleiner zijn dan 1 MiB.
- De implementatie mag niet meer dan één boardconfiguratiebestand hebben.
Een implementatie bijwerken
Als u een implementatie wilt bijwerken, gebruikt u de opdrachten voor het toevoegen van azsphere-installatiekopieën en azsphere-apparaatgroepimplementaties, zoals beschreven in de vorige sectie, en geeft u het pad naar het bijgewerkte toepassingsbestand op.