Zelfstudie: Een cloudimplementatie 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.
In deze quickstart ziet u hoe u uw eerste cloudtoepassingsimplementatie maakt. Cloudimplementatie levert een toepassing via een implementatie die is toegewezen aan een apparaatgroep binnen het doelproduct.
In deze zelfstudie leert u het volgende:
- Een product maken
- Cloudimplementatie inschakelen voor uw apparaat
- De implementatie maken
- Implementatie activeren
- Ontwikkeling en foutopsporing opnieuw inschakelen
Vereisten
- Uw Azure Sphere-apparaat is verbonden met uw computer en met internet.
- U hebt de zelfstudie voltooid: een toepassing op hoog niveau bouwen en een installatiekopieënpakketbestand voor uw toepassing hebben.
Een product maken
Een product identificeert een model van een Azure Sphere-apparaat dat een specifieke functie uitvoert en een bepaalde toepassing uitvoert.
Als u nog geen product hebt, maakt u er een met behulp van de opdracht azsphere product create .
azsphere product create --name MyProduct --description "My First Product"
Productnamen moeten uniek zijn binnen uw Azure Sphere-tenant en zijn niet hoofdlettergevoelig. Als de naam spaties bevat, plaatst u deze tussen dubbele aanhalingstekens in opdrachten, zoals in het voorbeeld.
Met de opdracht azsphere product create worden automatisch vijf standaardapparaatgroepen gemaakt voor het nieuwe product: Development, Field Test, Production, Field Test OS Evaluation en Production OS Evaluation. Apparaatgroepen bieden een manier om uw apparaten te organiseren op basis van hoe u ze gebruikt.
Cloudimplementatie inschakelen voor uw apparaat
Voordat u het cloudimplementatieproces test, moet uw Azure Sphere-apparaat gereed zijn om updates voor cloudtoepassingen te accepteren. Gebruik de opdracht azsphere device enable-cloud-test om uw apparaat voor te bereiden:
azsphere device enable-cloud-test --product MyProduct
Met deze opdracht gebeurt het volgende:
- Identificeert het apparaat als het MyProduct-model, dat in de vorige stap is gemaakt.
- Hiermee wordt het apparaat toegewezen aan de apparaatgroep Field Test, waarmee toepassingsupdates in de cloud worden ingeschakeld.
- Hiermee schakelt u de mogelijkheid voor de SDK uit om toepassingen op het apparaat te laden, zodat alleen cloudtoepassingen kunnen worden geladen.
De Azure Sphere-beveiligingsservice gebruikt de apparaatgroep en het product om te bepalen of de toepassing op een apparaat moet worden bijgewerkt.
De implementatie maken
Een implementatie is een set installatiekopieën die vanuit de Azure Sphere-cloudservice kunnen worden geïmplementeerd op de apparaten binnen een bepaalde apparaatgroep.
Een implementatie maken:
- Upload het installatiekopieënpakket naar uw Azure Sphere-tenant met behulp van azsphere image add.
- Maak een nieuwe implementatie voor een apparaatgroep voor de geüploade installatiekopieën met behulp van azsphere device-group deployment create.
- Upload het installatiekopieënpakket:
azsphere image add --image <path-to-image>
De uitvoer moet er ongeveer als volgt uitzien:
Uploading image from file 'Blink.imagepackage':
--> Image ID: <image-ID>
--> Component ID: <component-ID>
--> Component name: 'Blink'
Removing temporary state for uploaded image.
Successfully uploaded image with ID '<image-id>' and name 'Blink' to component with ID '<component-id>'.
In de volgende stap gebruikt u de afbeeldings-id.
- 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 --device-group '<product-name>/<device-group-name>' --images <image-ID>
Voor het product MyProduct en apparaatgroep Field Test kunt u dit tweede formulier gebruiken om uw implementatie eenvoudig te maken:
azsphere device-group deployment create --device-group "MyProduct/Field Test" --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.
Geef de apparaatgroep Veldtest en de naam op van het product dat u hebt gemaakt in Een product maken.
Vervang <de installatiekopieën-id> door de installatiekopieën-id van het installatiekopieënpakket dat u in de zelfstudie hebt gemaakt: Een toepassing op hoog niveau bouwen. Zie azsphere device-group deployment create voor informatie over het ophalen van de installatiekopieën-id voor Azure Sphere CLI.
Gebruik de opdracht azsphere device image list-targeted om te controleren of de implementatie is ingesteld.
De implementatie activeren
In de vorige stappen zijn alle vereiste implementatie-elementen ingesteld. Als u het downloaden onmiddellijk wilt activeren, drukt u op de knop Opnieuw instellen op het Azure Sphere-apparaat. De toepassing moet binnen enkele minuten worden gedownload en gestart en u ziet dat de LED begint te knipperen.
Gebruik de opdracht azsphere device image list-installed om te controleren of de toepassing op uw apparaat is geïnstalleerd. De resultaten van de implementatie worden mogelijk niet onmiddellijk weergegeven. Als de implementatie niet wordt weergegeven wanneer u de opdracht uitvoert, probeert u het over enkele minuten opnieuw. De LED knippert op het Azure Sphere-apparaat zodra de implementatie is voltooid.
Volgende stappen
Wanneer u toepassingen blijft ontwikkelen en testen, wilt u ze waarschijnlijk sideloaden totdat u er klaar voor bent om ze breder te implementeren. Als u de opdracht azsphere device enable-cloud-test wilt omkeren en het apparaat wilt inschakelen voor ontwikkeling en foutopsporing, gebruikt u azsphere device enable-development.
Ga naar het volgende artikel om te lezen hoe u dit doet:
Als u nog niet klaar bent om realtime toepassingen te bouwen, kunt u ook het volgende doen:
- De Azure Sphere-voorbeelden op GitHub verkennen
- Meer informatie over de basisprincipes van Azure Sphere-implementatie
Problemen oplossen
Als u problemen ondervindt met de bovenstaande bewerkingen, raadpleegt u de richtlijnen voor probleemoplossing.