Een apparaat voor IoT Edge linux maken en inrichten met behulp van symmetrische sleutels

Dit artikel bevat end-to-end instructies voor het registreren en inrichten van een Linux IoT Edge-apparaat, waaronder het installeren van IoT Edge.

Elk apparaat dat verbinding maakt met een IoT-hub heeft een apparaat-id die wordt gebruikt voor het bijhouden van cloud-naar-apparaat- of apparaat-naar-cloud-communicatie. U configureert een apparaat met de verbindingsgegevens, waaronder de hostnaam van de IoT-hub, de apparaat-id en de informatie die het apparaat gebruikt om te verifiëren IoT Hub.

De stappen in dit artikel doorlopen een proces met de naam handmatige inrichting, waarbij u één apparaat verbindt met de IoT-hub. Voor handmatige inrichting hebt u twee opties voor het IoT Edge apparaten:

• Symmetrische sleutels: wanneer u een nieuwe apparaat-id maakt in IoT Hub, maakt de service twee sleutels. U kunt een van de sleutels op het apparaat plaatsen en de sleutel wordt aan IoT Hub tijdens de authenticatie.

  Deze verificatiemethode is sneller om aan de slag te gaan, maar niet zo veilig.

• X.509 zelf-ondertekend: u maakt twee X.509-identiteitscertificaten en plaats deze op het apparaat. Wanneer u een nieuwe apparaat-id in IoT Hub, geeft u de vingerafdruk van beide certificaten op. Wanneer het apparaat wordt geverifieerd voor IoT Hub, wordt er één certificaat IoT Hub controleert of het certificaat overeenkomt met de vingerafdruk.

  Deze verificatiemethode is veiliger en wordt aanbevolen voor productiescenario's.

In dit artikel wordt het gebruik van symmetrische sleutels als verificatiemethode beschreven. Zie Create and provision an IoT Edge device on Linux using X.509 certificates (Een IoT Edge-apparaat in Linux maken en inrichten met behulp van X.509-certificaten) als u X.509-certificaten wilt gebruiken.

Vereisten

In dit artikel wordt beschreven hoe u IoT Edge apparaat registreert en IoT Edge installeert. Deze taken hebben verschillende vereisten en hulpprogramma's die worden gebruikt om ze te bereiken. Zorg ervoor dat alle vereisten zijn gedekt voordat u doorgaat.

Hulpprogramma’s voor apparaatbeheer

U kunt de stappen Azure Portal, Visual Studio Code of Azure CLI gebruiken om uw apparaat te registreren. Elk hulpprogramma heeft zijn eigen vereisten:

IoT Edge installeren

Een X64-, ARM32- of ARM64 Linux-apparaat.

Microsoft biedt installatiepakketten voor Ubuntu Server 18.04- en Raspberry Pi OS Stretch-besturingssystemen.

Zie Voor de meest recente informatie over welke besturingssystemen momenteel worden ondersteund voor productiescenario's, Azure IoT Edge ondersteunde systemen.

Uw apparaat registreren

U kunt de Azure Portal, Visual Studio Code of Azure CLI gebruiken om uw apparaat te registreren, afhankelijk van uw voorkeur.

az iot hub device-identity create --device-id device_id_here --hub-name hub_name_here --edge-enabled

Nu u een apparaat hebt geregistreerd in IoT Hub, haalt u de informatie op die u gebruikt om de installatie en inrichting van de IoT Edge voltooien.

Geregistreerde apparaten weergeven en inrichtingsgegevens ophalen

Apparaten die gebruikmaken van symmetrische-sleutelverificatie hebben hun verbindingsreeksen nodig om de installatie en inrichting van de IoT Edge te voltooien.

az iot hub device-identity list --hub-name hub_name_here

az iot hub device-identity connection-string show --device-id [device_id] --hub-name [hub_name]

Installatie IoT Edge

In deze sectie bereidt u uw Linux-VM of fysiek apparaat voor op IoT Edge. Vervolgens installeert u IoT Edge.

U moet twee stappen op uw apparaat uitvoeren voordat het klaar is om de IoT Edge installeren. Uw apparaat moet toegang hebben tot de Microsoft-installatiepakketten en er moet een container-engine zijn geïnstalleerd.

Toegang tot de Microsoft-installatiepakketten

1. Download het configuratiepakket voor de opslagplaats dat overeenkomt met het besturingssysteem van uw apparaat.

   • Ubuntu Server 18.04:

     curl https://packages.microsoft.com/config/ubuntu/18.04/multiarch/packages-microsoft-prod.deb > ./packages-microsoft-prod.deb
     

   • Raspberry Pi OS Stretch:

     curl https://packages.microsoft.com/config/debian/stretch/multiarch/packages-microsoft-prod.deb > ./packages-microsoft-prod.deb
     

2. Installeer het configuratiepakket om de pakketopslagplaats en openbare GPG-sleutel van Microsoft toe te voegen.

   sudo apt install ./packages-microsoft-prod.deb
   

Een container-engine installeren

Azure IoT Edge is afhankelijk van een met OCI compatibele containerruntime. Voor productiescenario's raden we u aan de Moby-engine te gebruiken. De Moby-engine is de enige container-engine die officieel wordt ondersteund IoT Edge. Docker CE/EE container-afbeeldingen zijn compatibel met de Moby-runtime.

1. Pakketlijsten bijwerken op uw apparaat.

   sudo apt-get update
   

2. Installeer de Moby-engine.

   sudo apt-get install moby-engine
   

   Tip

   Als er fouten optreden wanneer u de Moby-container-engine installeert, controleert u of uw Linux-kernel compatibel is met Moby. Sommige fabrikanten van ingesloten apparaten verzenden apparaatafbeeldingen die aangepaste Linux-kernels bevatten zonder de functies die vereist zijn voor compatibiliteit met de container-engine. Voer de volgende opdracht uit, die gebruikmaakt van het check-config-script van Moby, om uw kernelconfiguratie te controleren:

   curl -ssl https://raw.githubusercontent.com/moby/moby/master/contrib/check-config.sh -o check-config.sh
   chmod +x check-config.sh
   ./check-config.sh
   

   Controleer in de uitvoer van het script of alle items onder Generally Necessary en Network Drivers zijn ingeschakeld. Als er functies ontbreken, kunt u deze inschakelen door de kernel opnieuw te bouwen vanuit de bron en de bijbehorende modules te selecteren voor opname in de juiste kernel .config. Op dezelfde manier kunt u, als u een kernelconfiguratiegenerator zoals of gebruikt, de respectieve functies zoeken en inschakelen en de defconfig menuconfig kernel dienovereenkomstig herbouwen. Nadat u de zojuist gewijzigde kernel hebt geïmplementeerd, moet u het script check-config opnieuw uitvoeren om te controleren of alle vereiste functies zijn ingeschakeld.

De IoT Edge-runtime installeren

sudo apt-get update

sudo apt-get install iotedge

sudo apt-get update

apt list -a aziot-edge aziot-identity-service

sudo apt-get install aziot-edge

Het apparaat inrichten met de cloudidentiteit

Nu de container-engine en de IoT Edge-runtime op uw apparaat zijn geïnstalleerd, bent u klaar voor de volgende stap: het apparaat instellen met de cloudidentiteit en verificatiegegevens.

sudo nano /etc/iotedge/config.yaml

# Manual provisioning configuration using a connection string
provisioning:
  source: "manual"
  device_connection_string: "ADD_DEVICE_CONNECTION_STRING_HERE"

sudo systemctl restart iotedge

sudo iotedge config mp --connection-string 'PASTE_DEVICE_CONNECTION_STRING_HERE'

sudo iotedge config apply

sudo nano /etc/aziot/config.toml

Controleren of de configuratie is geslaagd

Controleer of de runtime goed is geïnstalleerd en geconfigureerd op uw IoT Edge-apparaat.

Controleer of de IoT Edge wordt uitgevoerd.

sudo systemctl status iotedge

sudo iotedge system status

Als u problemen met de service moet oplossen, haalt u de servicelogboeken op.

journalctl -u iotedge

sudo iotedge system logs

Gebruik het check hulpprogramma om de configuratie en verbindingsstatus van het apparaat te controleren.

sudo iotedge check

Bekijk alle modules die op uw IoT Edge-apparaat worden uitgevoerd. Wanneer de service voor het eerst wordt gestart, wordt alleen de edgeAgent-module uitgevoerd. De edgeAgent-module wordt standaard uitgevoerd en helpt bij het installeren en starten van aanvullende modules die u op uw apparaat implementeert.

sudo iotedge list

Wanneer u een nieuw apparaat IoT Edge, wordt de statuscode 417 -- The device's deployment configuration is not set weergegeven in de Azure Portal. Deze status is normaal en betekent dat het apparaat gereed is om een module-implementatie te ontvangen.

Offline of specifieke versie-installatie (optioneel)

De stappen in deze sectie zijn voor scenario's die niet worden gedekt door de standaardinstallatiestappen. Dit kan het volgende omvatten:

• Installatie van IoT Edge offline
• Een versie van een releasekandidaat installeren

Gebruik de stappen in deze sectie als u een specifieke versie van de Azure IoT Edge runtime wilt installeren die niet beschikbaar is via apt-get install . De Microsoft-pakketlijst bevat slechts een beperkte set recente versies en de subversies, dus deze stappen zijn voor iedereen die een oudere versie of een versie van een releasekandidaat wil installeren.

Met curl-opdrachten kunt u de onderdeelbestanden rechtstreeks vanuit de opslagplaats IoT Edge GitHub richten.

Nu de container-engine en de IoT Edge-runtime op uw apparaat zijn geïnstalleerd, bent u klaar voor de volgende stap: Het apparaat inrichten met de cloudidentiteit.

Uninstall IoT Edge

Als u de installatie van IoT Edge apparaat wilt verwijderen, gebruikt u de volgende opdrachten.

De IoT Edge-runtime verwijderen.

sudo apt-get remove iotedge

sudo apt-get remove aziot-edge

Gebruik de vlag als u alle bestanden wilt verwijderen die zijn gekoppeld aan --purge IoT Edge, inclusief uw configuratiebestanden. Laat deze vlag weg als u deze opnieuw wilt IoT Edge en in de toekomst dezelfde configuratiegegevens wilt gebruiken.

Wanneer de IoT Edge runtime wordt verwijderd, worden alle gemaakte containers gestopt, maar nog steeds aanwezig op uw apparaat. Alles weergeven containers om te zien welke overblijven.

sudo docker ps -a

Verwijder de containers van uw apparaat, inclusief de twee runtimecontainers.

sudo docker rm -f <container name>

Verwijder ten slotte de container-runtime van uw apparaat.

sudo apt-get remove --purge moby-cli
sudo apt-get remove --purge moby-engine

Volgende stappen

Ga door met het IoT Edge modules voor meer informatie over het implementeren van modules op uw apparaat.