AWS IoT Greengrass Version 1 è entrato nella fase di estensione della vita utile il 30 giugno 2023. Per ulteriori informazioni, consulta la politica AWS IoT Greengrass V1 di manutenzione. Dopo questa data, AWS IoT Greengrass V1 non rilascerà aggiornamenti che forniscano funzionalità, miglioramenti, correzioni di bug o patch di sicurezza. I dispositivi che funzionano AWS IoT Greengrass V1 non subiranno interruzioni e continueranno a funzionare e a connettersi al cloud. Ti consigliamo vivamente di eseguire la migrazione a AWS IoT Greengrass Version 2, che aggiunge nuove importanti funzionalità e supporto per piattaforme aggiuntive.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Aggiornamenti OTA del software AWS IoT Greengrass Core

Il pacchetto software AWS IoT Greengrass Core include un agente di aggiornamento in grado di eseguire aggiornamenti over-the-air (OTA) del AWS IoT Greengrass software. È possibile utilizzare gli aggiornamenti OTA per installare la versione più recente del software AWS IoT Greengrass Core o del software dell'agente di aggiornamento OTA su uno o più core. Con gli aggiornamenti OTA, i dispositivi core non devono essere fisicamente presenti.

Si consiglia di utilizzare gli aggiornamenti OTA quando possibile. Forniscono un meccanismo che è possibile utilizzare per tenere traccia dello stato degli aggiornamenti e della relativa cronologia. Se si verifica un aggiornamento non riuscito, l'agente di aggiornamento OTA ripristina la versione precedente del software.

Gli aggiornamenti OTA rendono più efficiente:

Questa funzionalità si integra con i processi AWS IoT.

Requisiti

I seguenti requisiti si applicano agli aggiornamenti OTA del software AWS IoT Greengrass.

Autorizzazioni IAM per gli aggiornamenti OTA

Quando AWS IoT Greengrass rilascia una nuova versione del software AWS IoT Greengrass Core, AWS IoT Greengrass aggiorna gli elementi software archiviati in Amazon S3 utilizzati per l'aggiornamento OTA.

Account AWSDevi includere un ruolo di firmatario URL di Amazon S3 che può essere utilizzato per accedere a questi artefatti. Il ruolo deve avere una politica di autorizzazioni che consenta l's3:GetObjectazione sui bucket nei target Regione AWS s. Il ruolo deve inoltre disporre di una policy di attendibilità che consenta a iot.amazonaws.com di assumere il ruolo come entità attendibile.

Inoltre, l'utente che avvia un aggiornamento OTA deve disporre delle autorizzazioni per utilizzare greengrass:CreateSoftwareUpdateJob e iot:CreateJob, nonché utilizzare iam:PassRole per passare le autorizzazioni del ruolo firmatario. Ecco un esempio di policy IAM:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "greengrass:CreateSoftwareUpdateJob"
            ],
            "Effect": "Allow",
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "iot:CreateJob"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "iam:PassRole"
            ],
            "Resource": "arn-of-s3-url-signer-role"
        }
    ]
}

Considerazioni

Prima di avviare un aggiornamento OTA del software Greengrass Core, è necessario conoscere l'impatto sui dispositivi del gruppo Greengrass, sia sul dispositivo core che sui dispositivi client collegati localmente al core:

Le seguenti informazioni di stato vengono conservate durante un aggiornamento OTA:

Agente di aggiornamento OTA di Greengrass

L'agente di aggiornamento OTA di Greengrass è il componente software del dispositivo che gestisce i processi di aggiornamento creati e distribuiti nel cloud. L'agente di aggiornamento OTA è distribuito nello stesso pacchetto software del software AWS IoT Greengrass Core. L'agente si trova in /greengrass-root/ota/ota_agent/ggc-ota. Scrive i registri in /var/log/greengrass/ota/ggc_ota.txt.

È possibile avviare l'agente di aggiornamento OTA eseguendo il file binario manualmente o integrandolo come parte di uno script di init, ad esempio un file di servizio systemd. Se esegui il file binario manualmente, dovrebbe essere eseguito come root. All'avvio, l'agente di aggiornamento OTA ascolta i processi di aggiornamento AWS IoT Greengrass del software AWS IoT Core e li esegue in sequenza. L'agente di aggiornamento OTA ignora tutti gli altri tipi di AWS IoT lavoro.

Il seguente estratto mostra un esempio di un file di servizio systemd per avviare, arrestare e riavviare l'agente di aggiornamento OTA:

[Unit]
Description=Greengrass OTA Daemon

[Service]
Type=forking
Restart=on-failure
ExecStart=/greengrass/ota/ota_agent/ggc-ota

[Install]
WantedBy=multi-user.target

Un core oggetto di un aggiornamento non deve eseguire due istanze dell'agente di aggiornamento OTA. In questo modo, i due agenti elaborano gli stessi processi creando conflitti.

Integrazione con i sistemi di inizializzazione

Durante un aggiornamento OTA, l'agente di aggiornamento OTA riavvia i file binari sul dispositivo principale. Se i file binari sono in esecuzione, ciò potrebbe causare conflitti quando un sistema init sta monitorando lo stato del software AWS IoT Greengrass Core o dell'agente durante l'aggiornamento. Per aiutarti a integrare il meccanismo di aggiornamento OTA con le tue strategie di monitoraggio init, puoi scrivere script di shell eseguibili prima e dopo un aggiornamento. Ad esempio, è possibile utilizzare ggc_pre_update.sh lo script per eseguire il backup dei dati o interrompere i processi prima che il dispositivo si spenga.

Per dire all'agente di aggiornamento OTA di eseguire questi script, devi includere il "managedRespawn" : true flag nel file config.json. Questa impostazione è mostrata nel seguente estratto:

{
   "coreThing": {                                                     
       …
   },
   "runtime": {                                                       
       …
   },
   "managedRespawn": true
       …
}

Rigenerazione gestita con aggiornamenti OTA

I seguenti requisiti si applicano agli aggiornamenti OTA managedRespawn impostati sutrue:

L'agente di aggiornamento OTA esegue gli script da. /greengrass-root/usr/scripts La struttura di directory deve essere simile alla seguente:

<greengrass_root>
|-- certs
|-- config
|   |-- config.json
|-- ggc
|-- usr/scripts
|   |-- ggc_pre_update.sh
|   |-- ggc_post_update.sh
|   |-- ota_pre_update.sh
|   |-- ota_post_update.sh
|-- ota

Quando managedRespawn è impostato sutrue, l'agente di aggiornamento OTA controlla la /greengrass-root/usr/scripts directory di questi script prima e dopo l'aggiornamento del software. Se gli script non esistono, l'aggiornamento non riesce. AWS IoT Greengrassnon convalida il contenuto di questi script. Come best practice, verifica che gli script funzionino correttamente e inserisci i codici di uscita appropriati per gli errori.

Creare un aggiornamento OTA.

Attenersi alla seguente procedura per eseguire un aggiornamento OTA del software AWS IoT Greengrass su uno o più core:

API CreateSoftwareUpdateJob

Puoi utilizzare l'CreateSoftwareUpdateJobAPI per aggiornare il software AWS IoT Greengrass Core o il software OTA update agent sui tuoi dispositivi principali. Questa API crea un processo di snapshot AWS IoT che notifica ai dispositivi quando è disponibile un aggiornamento. Dopo aver chiamato CreateSoftwareUpdateJob, è possibile utilizzare altri comandi del processo AWS IoT per tenere traccia dell'aggiornamento software. Per ulteriori informazioni, consulta Jobs in the AWS IoTDeveloper Guide.

L'esempio seguente mostra come usare l'AWS CLI per creare un processo di aggiornamento del software AWS IoT Greengrass Core su un dispositivo core:

aws greengrass create-software-update-job \
--update-targets-architecture x86_64 \
--update-targets [\"arn:aws:iot:region:123456789012:thing/myCoreDevice\"] \
--update-targets-operating-system ubuntu \
--software-to-update core \
--s3-url-signer-role arn:aws:iam::123456789012:role/myS3UrlSignerRole \
--update-agent-log-level WARN \
--amzn-client-token myClientToken1

Il comando create-software-update-job restituisce una risposta JSON contenente l'ID processo, l'ARN del processo e la versione software che sono stati installati dall'aggiornamento:

{
    "IotJobId": "GreengrassUpdateJob_c3bd7f36-ee80-4d42-8321-a1da0EXAMPLE",
    "IotJobArn": "arn:aws:iot:region:123456789012:job/GreengrassUpdateJob_c3bd7f36-ee80-4d42-8321-a1da0EXAMPLE",
    "PlatformSoftwareVersion": "1.9.2"
}

Per i passaggi che illustrano come utilizzare create-software-update-job per aggiornare un dispositivo core, consulta Creare un aggiornamento OTA..

Il comando create-software-update-job ha i seguenti parametri: