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à.

Distribuzione di gruppi AWS IoT Greengrass in un AWS IoT Greengrass Core

Usa AWS IoT Greengrass i gruppi per organizzare le entità nel tuo ambiente edge. I gruppi vengono utilizzati anche per controllare il modo in cui le entità del gruppo interagiscono tra loro e conCloud AWS. Ad esempio, solo le funzioni Lambda del gruppo vengono distribuite per l'esecuzione locale e solo i dispositivi del gruppo possono comunicare utilizzando il server MQTT locale.

Un gruppo deve includere un core, ovvero un dispositivo AWS IoT che esegue il software AWS IoT Greengrass Core. Il core funge da gateway edge e fornisce funzionalità AWS IoT Core nell'ambiente edge. A seconda delle esigenze aziendali, puoi anche aggiungere le seguenti entità a un gruppo:

Gestisci il tuo gruppo Greengrass in Cloud AWS e poi lo distribuisci su un core. La distribuzione copia la configurazione del gruppo nel file group.json sul dispositivo core. Questo file si trova in greengrass-root/ggc/deployments/group.

Distribuzione dei gruppi dalla console AWS IoT

È possibile distribuire un gruppo e gestirne le distribuzioni dalla pagina di configurazione del gruppo nella console. AWS IoT

Distribuzione di gruppi con l'API AWS IoT Greengrass

L'API AWS IoT Greengrass fornisce le seguenti operazioni per distribuire i gruppi AWS IoT Greengrass e gestire le distribuzioni dei gruppi. Puoi chiamare queste operazioni dalla AWS CLI, dall'AWS IoT Greengrass API o dall'SDK AWS.

Ottenere l'ID del gruppo

L'ID del gruppo viene comunemente utilizzato nelle operazioni API. Puoi utilizzare l'ListGroupsazione per trovare l'ID del gruppo target dal tuo elenco di gruppi. Ad esempio, nell’AWS CLI, utilizzare il comando list-groups.

aws greengrass list-groups

È inoltre possibile includere l'opzione query per filtrare i risultati. Per esempio:

Di seguito è riportata una risposta list-groups di esempio: Le informazioni relative a ciascun gruppo includono l'ID del gruppo (nella proprietà Id) e l'ID della versione più recente del gruppo (nella proprietà LatestVersion). Per ottenere altri ID di versione per un gruppo, usa l'ID del gruppo con ListGroupVersions.

{
    "Groups": [
        {
            "LatestVersionArn": "arn:aws:us-west-2:123456789012:/greengrass/groups/00dedaaa-ac16-484d-ad77-c3eedEXAMPLE/versions/4cbc3f07-fc5e-48c4-a50e-7d356EXAMPLE",
            "Name": "MyFirstGroup",
            "LastUpdatedTimestamp": "2019-11-11T05:47:31.435Z",
            "LatestVersion": "4cbc3f07-fc5e-48c4-a50e-7d356EXAMPLE",
            "CreationTimestamp": "2019-11-11T05:47:31.435Z",
            "Id": "00dedaaa-ac16-484d-ad77-c3eedEXAMPLE",
            "Arn": "arn:aws:us-west-2:123456789012:/greengrass/groups/00dedaaa-ac16-484d-ad77-c3eedEXAMPLE"
        },
        {
            "LatestVersionArn": "arn:aws:us-west-2:123456789012:/greengrass/groups/036ceaf9-9319-4716-ba2a-237f9EXAMPLE/versions/8fe9e8ec-64d1-4647-b0b0-01dc8EXAMPLE",
            "Name": "GreenhouseSensors",
            "LastUpdatedTimestamp": "2020-01-07T19:58:36.774Z",
            "LatestVersion": "8fe9e8ec-64d1-4647-b0b0-01dc8EXAMPLE",
            "CreationTimestamp": "2020-01-07T19:58:36.774Z",
            "Id": "036ceaf9-9319-4716-ba2a-237f9EXAMPLE",
            "Arn": "arn:aws:us-west-2:123456789012:/greengrass/groups/036ceaf9-9319-4716-ba2a-237f9EXAMPLE"
        },
        ...
    ]
}

Se non specifichi unRegione AWS, AWS CLI i comandi utilizzano la regione predefinita del tuo profilo. Per restituire gruppi in un'altra regione, includere l'opzione regione . Per esempio:

aws greengrass list-groups --region us-east-1

Panoramica del modello di oggetti del gruppo AWS IoT Greengrass

Durante la programmazione con l'API AWS IoT Greengrass, è utile comprendere il modello di oggetti del gruppo Greengrass.

Gruppi

Nell'API AWS IoT Greengrass, l'oggetto Group di primo livello è costituito da metadati e da un elenco di oggetti GroupVersion. Gli oggetti GroupVersion sono associati a un Group per ID.

Versioni del gruppo

Gli oggetti GroupVersion definiscono l'appartenenza al gruppo. Ogni GroupVersion fa riferimento a una CoreDefinitionVersion e ad altre versioni dei componenti per ARN. Questi riferimenti determinano quali entità includere nel gruppo.

Ad esempio, per includere tre funzioni Lambda, un dispositivo e due abbonamenti nel gruppo, i riferimenti: GroupVersion

Il GroupVersion distribuito su un dispositivo core determina le entità disponibili nell'ambiente locale e il modo in cui possono interagire.

Componenti del gruppo

I componenti aggiunti ai gruppi hanno una gerarchia di tre livelli:

L'esempio seguente DeviceDefinition fa riferimento a tre oggetti DeviceDefinitionVersion che contengono ciascuno più oggetti Device. In un gruppo viene utilizzato solo un oggetto DeviceDefinitionVersion alla volta.

Aggiornamento dei gruppi

Nell'API AWS IoT Greengrass, utilizzare le versioni per aggiornare la configurazione di un gruppo. Le versioni sono immutabili, quindi per aggiungere, rimuovere o modificare i componenti del gruppo, è necessario creare DefinitionVersionoggetti che contengano entità nuove o aggiornate.

È possibile associare nuovi DefinitionVersionsoggetti a oggetti Definition nuovi o esistenti. Ad esempio, puoi utilizzare l'operazione CreateFunctionDefinition per creare un FunctionDefinition che include FunctionDefinitionVersion come versione iniziale oppure puoi utilizzare l'operazione CreateFunctionDefinitionVersion e fare riferimento a un FunctionDefinition esistente.

Dopo aver creato i componenti del gruppo, ne create uno GroupVersion contenente tutti DefinitionVersiongli oggetti che desiderate includere nel gruppo. Puoi quindi distribuire GroupVersion.

Per distribuire un GroupVersion, deve fare riferimento a un CoreDefinitionVersion che contiene esattamente uno Core. Tutte le entità a cui si fa riferimento devono essere membri del gruppo. Inoltre, un ruolo di servizio Greengrass deve essere associato all'utente Account AWS nel luogo in Regione AWS cui si sta implementando il. GroupVersion

Aggiornamento di entità che fanno riferimento a risorse AWS

Le funzioni e le risorse segrete di Greengrass Lambda definiscono le proprietà specifiche di Greengrass e fanno anche riferimento alle risorse corrispondenti. AWS Per aggiornare queste entità, è possibile apportare modifiche alla AWS risorsa corrispondente anziché agli oggetti Greengrass. Ad esempio, le funzioni Lambda fanno riferimento a una funzione in AWS Lambda e definiscono anche il ciclo di vita e altre proprietà specifiche del gruppo Greengrass.

Consulta anche