Uppdatera IoT Edge

Gäller för: IoT Edge 1.5 IoT Edge 1.4

När IoT Edge-tjänsten släpper nya versioner uppdaterar du dina IoT Edge enheter för de senaste funktionerna och säkerhetsförbättringarna. Den här artikeln innehåller information om hur du uppdaterar dina IoT Edge-enheter när en ny version är tillgänglig.

Två logiska komponenter i en IoT Edge-enhet måste uppdateras om du vill flytta till en nyare version.

• Säkerhetsundersystem – Det körs på enheten, hanterar säkerhetsbaserade uppgifter och startar modulerna när enheten startar. Säkerhetsundersystemet kan bara uppdateras från själva enheten.

• IoT Edge-körning – IoT Edge-körningen består av modulerna IoT Edge-hubb (edgeHub) och IoT Edge-agent (edgeAgent). Beroende på hur du strukturerar distributionen kan körmiljön uppdateras antingen från enheten eller via fjärranslutning.

Så här uppdaterar du

Använd avsnitten i den här artikeln för att uppdatera både säkerhetsundersystemet och körningscontainrarna på en enhet.

Korrigeringsversioner

När du uppgraderar mellan korrigeringsversioner , till exempel 1.5.1 till 1.5.2, är uppdateringsordningen inte viktig. Du kan uppgradera säkerhetssystemet eller containrarna antingen före eller efter den andra komponenten. Så här uppdaterar du mellan uppdateringsversioner:

1. Uppdatera säkerhetsundersystemet
2. Uppdatera körningscontainrarna
3. Kontrollera att versionerna matchar

Du kan felsöka uppgraderingsprocessen när som helst.

Större eller mindre versioner

När du uppgraderar mellan större eller mindre versioner, till exempel från 1.4 till 1.5, uppdaterar du både säkerhetsundersystemet och körningscontainrarna. Innan en lansering testar vi säkerhetsundersystemet och versionkombinationen av körningscontainern. Så här uppdaterar du mellan större eller mindre produktversioner:

1. På enheten stoppar du IoT Edge med kommandot sudo systemctl stop iotedge och avinstallerar.

2. Uppgradera containermotorn på enheten, antingen Docker eller Moby.

3. Installera IoT Edge på enheten.

   Om du importerar en gammal konfiguration med iotedge config import då ändrar du [agent.config]-avbildningen av den genererade /etc/aziot/config.toml-filen, så att 1.5-avbildningen används för edgeAgent.

   Mer information finns i Konfigurera enhetsinställningar för IoT Edge.

4. I IoT Hub uppdaterar du moduldistributionen så att den refererar till de senaste systemmodulerna.

5. På enheten, starta IoT Edge med sudo iotedge config apply.

Du kan felsöka uppgraderingsprocessen när som helst.

Uppdatera säkerhetsundersystemet

IoT Edge-säkerhetsundersystemet innehåller en uppsättning inbyggda komponenter som måste uppdateras med hjälp av pakethanteraren på IoT Edge-enheten.

Kontrollera vilken version av säkerhetsundersystemet som körs på enheten med hjälp av kommandot iotedge version. Om du använder IoT Edge för Linux i Windows måste du SSH till den virtuella Linux-datorn för att kontrollera versionen.

sudo apt-get update

apt list -a aziot-edge

sudo apt-get install aziot-edge

yum list aziot-edge

sudo yum install aziot-edge

Använd sedan konfigurationen igen för att säkerställa att systemet uppdateras fullständigt.

sudo iotedge config apply

Uppdatera miljöerna för körning

Hur du uppdaterar IoT Edge-agenten och IoT Edge-hubbcontainrarna beror på om du använder rullande taggar (till exempel 1,5) eller specifika taggar (t.ex. 1.5.1) i distributionen.

Kontrollera vilken version av IoT Edge-agenten och IoT Edge-hubbmodulerna som för närvarande finns på enheten med hjälp av kommandona iotedge logs edgeAgent eller iotedge logs edgeHub. Om du använder IoT Edge för Linux i Windows måste du SSH till den virtuella Linux-datorn för att kontrollera körningsmodulversionerna.

Förstå IoT Edge-taggar

IoT Edge-agenten och IoT Edge-hubbens avbildningar taggas med den IoT Edge-version som de är associerade med. Det finns två olika sätt att använda taggar med runtime-bilderna.

• Rullande taggar – Använd endast de två första värdena i versionsnumret för att hämta den senaste bilden som matchar dessa siffror. Till exempel uppdateras 1.5 när det finns en ny version som pekar på den senaste 1.5.x-versionen. Om containerkörningen på IoT Edge-enheten hämtar avbildningen igen uppdateras runtime-modulerna till den senaste versionen. Distributioner från Azure-portalen har standardinställningen rullande taggar. Den här metoden föreslås i utvecklingssyfte.

• Specifika taggar – Använd alla tre värdena i versionsnumret för att uttryckligen ange avbildningsversionen. Till exempel ändras inte 1.5.0 efter den första versionen. Du kan deklarera ett nytt versionsnummer i distributionsmanifestet när du är redo att uppdatera. Den här metoden föreslås i produktionssyfte.

Uppdatera en rullande taggbild

Om du använder rullande taggar i distributionen (till exempel mcr.microsoft.com/azureiotedge-hub:1.5) måste du kräva att containerkörningsmiljön på enheten hämtar den senaste versionen av avbildningen.

Ta bort den lokala versionen av avbildningen från din IoT Edge-enhet. Om du avinstallerar säkerhetsundersystemet på Windows-datorer tas även körningsavbildningarna bort, så du behöver inte ta det här steget igen.

docker rmi mcr.microsoft.com/azureiotedge-hub:1.5
docker rmi mcr.microsoft.com/azureiotedge-agent:1.5

Du kan behöva använda force-flaggan -f för att ta bort bilderna.

IoT Edge-tjänsten hämtar de senaste versionerna av körningsavbildningarna och startar dem automatiskt på enheten igen.

Uppdatera en specifik taggbild

Om du använder specifika taggar i distributionen (till exempel mcr.microsoft.com/azureiotedge-hub:1.5) behöver du bara uppdatera taggen i distributionsmanifestet och tillämpa ändringarna på enheten.

1. I IoT Hub i Azure Portal väljer du din IoT Edge-enhet och väljer Ange moduler.

2. På fliken Moduler väljer du Körningsinställningar.

3. I Körningsinställningar uppdaterar du avbildnings-URI-värdet i avsnittet Edge Agent med önskad version. Till exempel, mcr.microsoft.com/azureiotedge-agent:1.5 välj inte tillämpa ännu.

4. Välj Edge Hub-fliken och uppdatera värdet för bild-URI med samma önskade version. Exempel: mcr.microsoft.com/azureiotedge-hub:1.5

5. Välj Använd för att spara ändringar.

6. Välj Granska + skapa, granska distributionen enligt JSON-filen och välj Skapa.

Uppdatera URI:er för partnermodul

Om du använder partnermoduler, uppdaterar du dina moduldistributioner med bild-URI:er som tillhandahålls av partnern. Kontakta IoT Edge-modulutgivaren för att hämta den uppdaterade containeravbildnings-URI:n. Uppdatera enhetskonfigurationerna med den senaste bild-URI som tillhandahålls av utgivaren.

1. Logga in på Azure Portal och navigera till din IoT Hub.
2. I den vänstra rutan väljer du Enheter under menyn Enhetshantering .
3. Välj den IoT Edge-enhet som använder partnermodulen i listan.
4. I det övre fältet väljer du Ange moduler.
5. Välj den IoT Edge-partnermodul som du vill uppdatera med den nya avbildnings-URI:n.
6. Uppdatera värdet för bildens URI med den nya bild-URI som tillhandahålls av utgivaren.
7. Välj Använd för att spara ändringar.
8. Välj Granska + skapa, granska distributionen enligt JSON-filen och välj Skapa.

Kontrollera att versionerna matchar

1. På enheten använder du iotedge version för att kontrollera säkerhetsundersystemversionen. Utdata innehåller versionsnummer för huvudversioner, delversioner och revisioner. Till exempel iotedge 1.5.13.

2. I inställningarna för enhetsdistributionskörning kontrollerar du att URI-versionerna för edgeHub - och edgeAgent-avbildningen matchar huvud- och delversionen av säkerhetsundersystemet. Om säkerhetsundersystemversionen är 1.5.15 blir avbildningsversionerna 1.5. Till exempel mcr.microsoft.com/azureiotedge-hub:1.5 och mcr.microsoft.com/azureiotedge-agent:1.5.

Felsökning

Du kan visa loggar i systemet när som helst genom att köra följande kommandon från enheten.

• Börja felsöka med hjälp av kommandot check . Den kör en samling konfigurations- och anslutningstester för vanliga problem.

  sudo iotedge check --verbose
  

• Om du vill visa status för IoT Edge-systemet kör du:

  sudo iotedge system status 
  

• Om du vill visa värdkomponentloggar kör du:

  sudo iotedge system logs
  

• Om du vill söka efter återkommande problem som rapporterats med edgeAgent och edgeHub kör du:

  Ersätt <module> med ditt eget modulnamn. Om det inte finns några problem visas inga utdata.

  sudo iotedge logs <module>
  

Mer information finns i Felsöka din IoT Edge-enhet.

Nästa steg

Visa de senaste Versionerna av Azure IoT Edge.

Håll dig uppdaterad med de senaste uppdateringarna och meddelandena i Sakernas Internet-blogg