Aggiornare IoT Edge

Nei dispositivi Linux x64 usare apt-get o la gestione pacchetti appropriata per aggiornare il modulo di runtime alla versione più recente.

Aggiornare apt.

sudo apt-get update

Verificare le versioni di IoT Edge disponibili.

apt list -a iotedge

Se si vuole eseguire l'aggiornamento alla versione più recente del modulo di runtime, usare il comando seguente, che aggiorna anche libiothsm-std alla versione più recente:

sudo apt-get install iotedge

Se si vuole eseguire l'aggiornamento a una versione specifica del modulo di runtime, specificare la versione dall'output dell'elenco apt. Ogni volta che iotedge viene aggiornato, tenta automaticamente di aggiornare il pacchetto libiothsm-std alla versione più recente, che può causare un conflitto di dipendenza. Se non si intende usare la versione più recente, assicurarsi di specificare come destinazione entrambi i pacchetti per la stessa versione. Ad esempio, il comando seguente installa una versione specifica della versione 1.1:

sudo apt-get install iotedge=1.1.1 libiothsm-std=1.1.1

Se la versione che si vuole installare non è disponibile tramite apt-get, è possibile usare curl per specificare come destinazione qualsiasi versione dal repository delle versioni di IoT Edge. Per qualsiasi versione da installare, individuare i file libiothsm-std e iotedge appropriati per il dispositivo. Per ogni file, fare clic con il pulsante destro del mouse sul collegamento al file e copiare l'indirizzo del collegamento. Usare l'indirizzo di collegamento per installare le versioni specifiche di tali componenti:

curl -L <libiothsm-std link> -o libiothsm-std.deb && sudo apt-get install ./libiothsm-std.deb
curl -L <iotedge link> -o iotedge.deb && sudo apt-get install ./iotedge.deb

IoT Edge versione 1.1 non è supportato in Red Hat Enterprise Linux 8.

Per informazioni sugli aggiornamenti di IoT Edge per Linux in Windows, vedere Aggiornamenti EFLOW.

Con IoT Edge per Windows, IoT Edge viene eseguito direttamente nel dispositivo Windows.

Usare il Update-IoTEdge comando per aggiornare il runtime del modulo. Lo script esegue automaticamente il pull della versione più recente del runtime del modulo.

. {Invoke-WebRequest -useb aka.ms/iotedge-win} | Invoke-Expression; Update-IoTEdge

L'esecuzione del Update-IoTEdge comando rimuove e aggiorna il modulo di runtime dal dispositivo, insieme alle due immagini del contenitore di runtime. Il file config.yaml viene mantenuto nel dispositivo, così come i dati del motore del contenitore Moby. Mantenere le informazioni di configurazione significa che non è necessario fornire di nuovo le informazioni sul servizio di stringa di connessione o Device Provisioning per il dispositivo durante il processo di aggiornamento.

Se si vuole eseguire l'aggiornamento a una versione specifica del sottosistema di sicurezza, trovare la versione del canale di versione 1.1 di destinazione dalle versioni di IoT Edge. In tale versione scaricare il file Microsoft-Azure-IoTEdge.cab . Usare quindi il -OfflineInstallationPath parametro per puntare al percorso del file locale. Ad esempio:

. {Invoke-WebRequest -useb aka.ms/iotedge-win} | Invoke-Expression; Update-IoTEdge -OfflineInstallationPath <absolute path to directory>

Se si vuole aggiornare un dispositivo offline, trovare la versione di destinazione dalle versioni di Azure IoT Edge. In questa versione scaricare i file IoTEdgeSecurityDaemon.ps1 e Microsoft-Azure-IoTEdge.cab . È importante usare lo script di PowerShell dalla stessa versione del file di .cab usato perché le funzionalità cambiano per supportare le funzionalità in ogni versione.

Se nel file .cab scaricato è presente un suffisso dell'architettura, rinominare il file in Microsoft-Azure-IoTEdge.cab.

Per eseguire l'aggiornamento con i componenti offline, dot source la copia locale dello script di PowerShell. Usare quindi il -OfflineInstallationPath parametro come parte del Update-IoTEdge comando e specificare il percorso assoluto della directory del file. ad esempio:

. <path>\IoTEdgeSecurityDaemon.ps1
Update-IoTEdge -OfflineInstallationPath <path>

Per altre informazioni sulle opzioni di aggiornamento, usare il comando Get-Help Update-IoTEdge -full o fare riferimento agli script di PowerShell per IoT Edge con contenitori Windows.

A partire dalla versione 1.2, il servizio IoT Edge usa un nuovo nome del pacchetto e presenta alcune differenze nei processi di installazione e configurazione. Se si dispone di un dispositivo IoT Edge che esegue la versione 1.0 o 1.1, usare queste istruzioni per informazioni su come eseguire l'aggiornamento alla versione più recente.

Alcune delle differenze principali tra la versione più recente e la versione 1.1 e precedenti includono:

• Il nome del pacchetto è cambiato da iotedge a aziot-edge.
• Il pacchetto libiothsm-std non viene più usato. Se è stato usato il pacchetto standard fornito come parte della versione di IoT Edge, le configurazioni possono essere trasferite alla nuova versione. Se è stata usata un'implementazione diversa di libiothsm-std, sarà necessario riconfigurare tutti i certificati forniti dall'utente, ad esempio il certificato di identità del dispositivo, la CA del dispositivo e il bundle di attendibilità.
• È stato introdotto un nuovo servizio di gestione delle identità, aziot-identity-service nell'ambito della versione 1.2. Questo servizio gestisce il provisioning e la gestione delle identità per IoT Edge e per altri componenti del dispositivo che devono comunicare con hub IoT, ad esempio Aggiornamento dispositivi per hub IoT.
• Il file di configurazione predefinito ha un nuovo nome e un nuovo percorso. In precedenza /etc/iotedge/config.yaml, le informazioni di configurazione del dispositivo saranno ora incluse per /etc/aziot/config.toml impostazione predefinita. Il comando iotedge config import può essere usato per eseguire la migrazione delle informazioni di configurazione dalla posizione e sintassi precedenti a quelle nuove.
  • Il comando di importazione non è in grado di rilevare o modificare le regole di accesso al modulo TPM (Trusted Platform Module) di un dispositivo. Se il dispositivo usa l'attestazione TPM, è necessario aggiornare manualmente il file /etc/udev/rules.d/tpmaccess.rules per concedere l'accesso al servizio aziottpm. Per altre informazioni, vedere Concedere a IoT Edge l'accesso al TPM.
• L'API del carico di lavoro nella versione più recente salva i segreti crittografati in un nuovo formato. Se si esegue l'aggiornamento da una versione precedente alla versione più recente, viene importata la chiave di crittografia master esistente. L'API del carico di lavoro può leggere i segreti salvati nel formato precedente usando la chiave di crittografia importata. Tuttavia, l'API del carico di lavoro non può scrivere segreti crittografati nel formato precedente. Una volta che un segreto viene ricrittografato da un modulo, viene salvato nel nuovo formato. I segreti crittografati nella versione più recente sono illeggibili dallo stesso modulo nella versione 1.1. Se si salvano in modo permanente i dati crittografati in una cartella o in un volume montato su host, creare sempre una copia di backup dei dati prima dell'aggiornamento per mantenere la possibilità di effettuare il downgrade, se necessario.
• Per garantire la compatibilità con le versioni precedenti quando si connettono dispositivi che non supportano TLS 1.2, è possibile configurare l'hub Edge per accettare ancora TLS 1.0 o 1.1 tramite la variabile di ambiente SslProtocols. Si noti che il supporto per TLS 1.0 e 1.1 in hub IoT è considerato legacy e può anche essere rimosso dall'hub Edge nelle versioni future. Per evitare problemi futuri, usare TLS 1.2 come unica versione TLS durante la connessione all'hub Edge o hub IoT.
• L'anteprima per il broker MQTT sperimentale nell'hub Edge 1.2 è terminata e non è inclusa nell'hub Edge 1.3 o versione successiva. Stiamo continuando a perfezionare i nostri piani per un broker MQTT in base al feedback ricevuto. Nel frattempo, se è necessario un broker MQTT conforme agli standard in IoT Edge, valutare la possibilità di distribuire un broker open source come Mosquitto come modulo IoT Edge.
• A partire dalla versione 1.2, quando un'immagine di backup viene rimossa da un contenitore, il contenitore continua a essere in esecuzione e viene mantenuto tra i riavvii. Nella versione 1.1, quando viene rimossa un'immagine di supporto, il contenitore viene ricreato immediatamente e l'immagine di supporto viene aggiornata.

Prima di automatizzare i processi di aggiornamento, verificare che funzioni nei computer di test.

Quando si è pronti, seguire questa procedura per aggiornare IoT Edge nei dispositivi:

1. Aggiornare apt.

   sudo apt-get update
   

2. Disinstallare la versione precedente di IoT Edge, lasciando i file di configurazione sul posto.

   sudo apt-get remove iotedge
   

3. Installare la versione più recente di IoT Edge, insieme al servizio di gestione delle identità IoT e all'agente micro di Microsoft Defender per IoT per Edge.

   sudo apt-get install aziot-edge defender-iot-micro-agent-edge
   

È consigliabile installare il micro agente con l'agente Edge per abilitare il monitoraggio della sicurezza e la protezione avanzata dei dispositivi Edge. Per altre informazioni su Microsoft Defender per IoT, vedere Che cos'è Microsoft Defender per IoT per i generatori di dispositivi.

1. Importare il file config.yaml precedente nel nuovo formato e applicare le informazioni di configurazione.

   sudo iotedge config import
   

IoT Edge versione 1.1 non è supportato in Red Hat Enterprise Linux 8.

Se si usano contenitori Windows o IoT Edge per Linux in Windows, questa sezione caso speciale non si applica.

Attualmente non è disponibile alcun supporto per IoT Edge versione 1.2 o successiva in esecuzione nei dispositivi Windows.