Apparaatupdate voor Azure IoT Hub zelfstudie met de referentieagent voor de Ubuntu-simulator (18.04 x64)

Apparaatupdate voor IoT Hub ondersteunt twee soorten updates: op basis van afbeeldingen en op basis van pakketten.

Updates van afbeeldingen bieden een hoger vertrouwensniveau in de eindtoestand van het apparaat. Het is doorgaans eenvoudiger om de resultaten van een update van afbeeldingen te repliceren tussen een preproductieomgeving en een productieomgeving, omdat deze niet dezelfde uitdagingen vormt als pakketten en hun afhankelijkheden. Vanwege hun atomische aard kan een A/B-failovermodel ook eenvoudig worden gebruikt.

In deze zelfstudie doorloopt u de stappen voor het voltooien van een end-to-end update op basis van afbeeldingen met behulp van Apparaatupdate voor IoT Hub.

In deze zelfstudie leert u het volgende:

Vereisten

• Als u dit nog niet hebt gedaan, maakt u een Apparaatupdate-accounten -exemplaar , inclusief het configureren van een IoT Hub.

Downloaden en installeren

• Az-cmdlets (Azure CLI) voor PowerShell:
  • Open PowerShell > Azure CLI ('Y' installeren) voor prompts om te installeren vanuit een 'niet-vertrouwde' bron)

PS> Install-Module Az -Scope CurrentUser

WSL inschakelen op Windows apparaat (Windows-subsysteem voor Linux)

1. Open PowerShell als beheerder op uw computer en voer de volgende opdracht uit (u wordt mogelijk gevraagd om na elke stap opnieuw op te starten; opnieuw opstarten wanneer u daarom wordt gevraagd):

PS> Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform
PS> Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

( Mogelijk wordt u na deze stap gevraagd opnieuw op te starten)

2. Ga naar de Microsoft Store op het web en installeer Ubuntu 18.04 LTS.

3. Start Ubuntu 18.04 LTS en installeer.

4. Wanneer deze is geïnstalleerd, wordt u gevraagd de hoofdnaam (gebruikersnaam) en het wachtwoord in te stellen. Zorg ervoor dat u een onthouden hoofdnaamwachtwoord gebruikt.

5. Voer in PowerShell de volgende opdracht uit om Ubuntu in te stellen als de standaard Linux-distributie:

PS> wsl --setdefault Ubuntu-18.04

6. Vermeld alle Linux-distributies en zorg ervoor dat Ubuntu de standaardinstelling is.

PS> wsl --list

7. U ziet nu: Ubuntu-18.04 (standaard)

Device Update Ubuntu (18.04 x64) Simulator Reference Agent downloaden

De Ubuntu-referentieagent kan worden gedownload uit de sectie Assets in de release-opmerkingen hier.

Er zijn twee versies van de agent. Voor deze zelfstudie gebruikt u AducIotAgentSim-microsoft-swupdate, omdat u het scenario op basis van afbeeldingen wilt oefenen. Als u in plaats daarvan het pakketscenario zou gaan oefenen, gebruikt u AducIotAgentSim-microsoft-apt.

Agentsimulator voor apparaatupdates installeren

1. Start Ubuntu WSL en voer de volgende opdracht in (let op: extra ruimte en punt aan het einde).

explorer.exe .

2. Kopieer AducIotAgentSim-microsoft-swupdate (of AducIotAgentSim-microsoft-apt) uit de lokale map waar deze is gedownload onder /mnt naar uw startmap in WSL.

3. Voer de volgende opdracht uit om de binaire bestanden uitvoerbaar te maken.

sudo chmod u+x AducIotAgentSim-microsoft-swupdate

of

sudo chmod u+x AducIotAgentSim-microsoft-apt

Apparaatupdate voor Azure IoT Hub-software is onderhevig aan de volgende licentievoorwaarden:

• Apparaatupdate voor IoT Hub licentie
• Delivery Optimization-clientlicentie

Lees de licentievoorwaarden voordat u de agent gebruikt. Uw installatie en gebruik vormt uw acceptatie van deze voorwaarden. Als u niet akkoord gaat met de licentievoorwaarden, gebruikt u de apparaatupdate niet voor IoT Hub agent.

Apparaat toevoegen aan Azure IoT Hub

Zodra de Agent voor apparaatupdates wordt uitgevoerd op een IoT-apparaat, moet het apparaat worden toegevoegd aan de Azure IoT Hub. Vanuit Azure IoT Hub wordt een connection string gegenereerd voor een bepaald apparaat.

1. Start vanuit Azure Portal de IoT Hub.
2. Maak een nieuw apparaat.
3. Navigeer aan de linkerkant van de pagina naar IoT-apparaten > Selecteer 'Nieuw'.
4. Geef een naam op voor het apparaat onder Apparaat-id. Zorg ervoor dat het selectievakje Automatisch gegenereerde sleutels is ingeschakeld.
5. Selecteer Opslaan.
6. U keert nu terug naar de pagina Apparaten en het apparaat dat u hebt gemaakt, moet in de lijst staan. Selecteer dat apparaat.
7. Selecteer in de apparaatweergave het pictogram Kopiëren naast Primaire verbindingsreeks.
8. Plak de gekopieerde tekens ergens voor later gebruik in de onderstaande stappen. Deze gekopieerde tekenreeks is uw apparaat connection string.

Een connection string simulator toevoegen

Start De Agent voor apparaatupdates op uw nieuwe softwareapparaten.

1. Start Ubuntu.
2. Voer de Agent voor apparaatupdates uit en geef de connection string uit de vorige sectie, verpakt met apostroofs:

Vervang <device connection string> door uw connection string

sudo ./AducIotAgentSim-microsoft-swupdate "<device connection string>"

of

./AducIotAgentSim-microsoft-apt -c '<device connection string>'

3. Schuif omhoog en zoek naar de tekenreeks die aangeeft dat het apparaat de status 'Niet-actief' heeft. De status Niet-actief geeft aan dat het apparaat gereed is voor serviceopdrachten:

Agent running. [main]

Een tag toevoegen aan uw apparaat

1. Meld u Azure Portal aan en navigeer naar de IoT Hub.

2. Zoek in IoT-apparaten of IoT Edge in het navigatiedeelvenster aan de linkerkant uw IoT-apparaat en navigeer naar de apparaat dubbel of module dubbel.

3. Verwijder in de module Module dubbel van de agent voor apparaatupdates een bestaande waarde voor de tag Apparaatupdate door deze in te stellen op null. Als u Apparaat-id gebruikt met de agent voor apparaatupdates, moet u deze wijzigingen aanbrengen op de apparaatt dubbel.

4. Voeg een nieuwe waarde voor de tag Apparaatupdate toe, zoals hieronder wordt weergegeven.

    "tags": {
            "ADUGroup": "<CustomTagValue>"
            }

Update importeren

1. Download het voorbeeldmanifest voor importeren en de voorbeeldafbeelding bijwerken. Opmerking: dit zijn opnieuw gebruikte updatebestanden uit de Raspberry Pi-zelfstudie, omdat de update in deze zelfstudie wordt gesimuleerd en daarom de specifieke bestandsinhoud niet van belang is.

2. Meld u aan bij Azure Portal en navigeer naar uw IoT Hub apparaatupdate. Selecteer vervolgens de optie Apparaatupdates onder Automatisch apparaatbeheer in de navigatiebalk aan de linkerkant.

3. Selecteer het tabblad Updates.

4. Selecteer +Nieuwe update importeren.

5. Selecteer het mappictogram of het tekstvak onder 'Selecteer een manifestbestand importeren'. U ziet een dialoogvenster voor het kiezen van bestanden. Selecteer het voorbeeldmanifest voor importeren dat u in stap 1 hierboven hebt gedownload. Selecteer vervolgens het mappictogram of het tekstvak onder Een of meer updatebestanden selecteren. U ziet een dialoogvenster voor het kiezen van bestanden. Selecteer de voorbeeldafbeeldingsupdate die u in stap 1 hierboven hebt gedownload.

   

6. Selecteer het mappictogram of het tekstvak onder Een opslagcontainer selecteren. Selecteer vervolgens het juiste opslagaccount.

7. Als u al een container hebt gemaakt, kunt u deze opnieuw gebruiken. (Anders selecteert u +Container om een nieuwe opslagcontainer voor updates te maken.) Selecteer de container die u wilt gebruiken en klik op Selecteren.

8. Selecteer Verzenden om het importproces te starten.

9. Het importproces begint en het scherm wordt gewijzigd in de sectie Importgeschiedenis. Selecteer Vernieuwen om de voortgang te bekijken totdat het importproces is voltooid. Afhankelijk van de grootte van de update kan dit enkele minuten duren, maar kan het langer duren.

   

10. Wanneer in de kolom Status wordt aangegeven dat het importeren is geslaagd, selecteert u de header Gereed voor implementatie. De geïmporteerde update wordt nu weergegeven in de lijst.

Meer informatie over het importeren van updates.

Updategroep maken

1. Ga naar de IoT Hub u eerder verbinding hebt met uw apparaatupdate-exemplaar.

2. Selecteer de optie Apparaatupdates onder Automatisch apparaatbeheer in de navigatiebalk aan de linkerkant.

3. Selecteer het tabblad Groepen bovenaan de pagina.

4. Selecteer de knop Toevoegen om een nieuwe groep te maken.

5. Selecteer de IoT Hub tag die u in de vorige stap hebt gemaakt in de lijst. Selecteer Updategroep maken.

   

Meer informatie over het toevoegen van tags en het maken van updategroepen

Update implementeren

1. Zodra de groep is gemaakt, ziet u een nieuwe update die beschikbaar is voor uw apparaatgroep, met een koppeling naar de update onder Updates in behandeling. Mogelijk moet u eenmaal vernieuwen.

2. Klik op de beschikbare update.

3. Controleer of de juiste groep is geselecteerd als de doelgroep. Plan uw implementatie en selecteer vervolgens Update implementeren.

   

4. Bekijk de compatibiliteitsgrafiek. U ziet nu dat de update wordt uitgevoerd.

   

5. Nadat het apparaat is bijgewerkt, ziet u de compatibiliteitsgrafiek en de update van de implementatiedetails.

   

Een update-implementatie bewaken

1. Selecteer het tabblad Implementaties bovenaan de pagina.

   

2. Selecteer de implementatie die u hebt gemaakt om de implementatiedetails weer te geven.

   

3. Selecteer Vernieuwen om de meest recente statusdetails weer te geven. Ga door met dit proces totdat de status verandert in Geslaagd.

U hebt nu een end-to-end-update van de installatie afbeelding voltooid met Apparaatupdate voor IoT Hub met behulp van de Ubuntu(18.04 x64) Simulator Reference Agent.

Resources opschonen

Schoon uw apparaatupdateaccount, exemplaar, apparaat en IoT-apparaat op wanneer IoT Hub niet meer nodig hebt.

Volgende stappen