Distribuzione dei componenti su un dispositivo

Per distribuire il componente del modello e il componente dell'applicazione client su un dispositivo AWS IoT Greengrass Version 2 principale, si utilizza la AWS IoT Greengrass V2 console o l'CreateDeploymentAPI. Per ulteriori informazioni, consulta Create deployments o nella Developer Guide. AWS IoT Greengrass Version 2 Per informazioni sull'aggiornamento di un componente distribuito su un dispositivo principale, consulta Revise deployments.

Autorizzazioni IAM per la distribuzione dei componenti

Per distribuire un componente con AWS IoT Greengrass V2 te sono necessarie le seguenti autorizzazioni:

• greengrass:ListComponents

• greengrass:ListComponentVersions

• greengrass:ListCoreDevices

• greengrass:CreateDeployment

• greengrass:GetDeployment

• greengrass:ListDeployments

CreateDeploymente GetDeployment hanno azioni dipendenti. Per ulteriori informazioni, consulta Azioni definite da AWS IoT Greengrass V2.

Per informazioni sulla modifica delle autorizzazioni IAM, consulta Modifica delle autorizzazioni per un utente.

Implementazione dei componenti (console)

Utilizzare la procedura seguente per distribuire il componente dell'applicazione client su un dispositivo principale. L'applicazione client dipende dal componente del modello (che a sua volta dipende dall'agente Lookout for Vision Edge). L'implementazione del componente dell'applicazione client avvia anche la distribuzione del componente modello e dell'agente Lookout for Vision Edge.

Nota

È possibile aggiungere i componenti a una distribuzione esistente. È inoltre possibile distribuire componenti in un gruppo di oggetti.

Per eseguire questa procedura, è necessario disporre di un dispositivo AWS IoT Greengrass V2 principale configurato. Per ulteriori informazioni, consulta Configurazione del dispositivo principale AWS IoT Greengrass Version 2.

Per distribuire i componenti su un dispositivo

1. Apri la AWS IoT Greengrass console all'indirizzo https://console.aws.amazon.com/iot/.

2. Nel riquadro di navigazione a sinistra, in Greengrass, scegli Deployments.

3. In Distribuzioni scegli Crea.

4. Nella pagina Specificare la destinazione, procedi come segue:

   1. In Informazioni sulla distribuzione, inserisci o modifica il nome descrittivo per la tua distribuzione.

   2. In Destinazione di distribuzione, seleziona Dispositivo principale e inserisci un nome di destinazione.

   3. Seleziona Successivo.

5. Nella pagina Seleziona componenti, procedi come segue:

   1. In I miei componenti, scegliete il nome del componente dell'applicazione client (com.lookoutvison.EdgeAgentPythonExample).

   2. Seleziona Next (Successivo).

6. Nella pagina Configura componenti, mantieni la configurazione corrente e scegli Avanti.

7. Nella pagina Configura impostazioni avanzate, mantieni le impostazioni correnti e scegli Avanti.

8. Nella pagina Revisione, scegli Distribuisci per iniziare a distribuire il componente.

Verifica dello stato di implementazione (console)

È possibile controllare lo stato della distribuzione dalla AWS IoT Greengrass V2 console. Se il componente dell'applicazione client utilizza la ricetta e il codice di esempio diCreazione del componente dell'applicazione client, visualizza il registro del componente dell'applicazione client al termine della distribuzione. In caso di successo, il registro include un elenco dei modelli Lookout for Vision distribuiti sul componente.

Per informazioni sull'utilizzo dell'AWSSDK per verificare lo stato della distribuzione, consulta Verifica dello stato della distribuzione.

Per verificare lo stato della distribuzione

1. Apri la AWS IoT Greengrass console all'indirizzo https://console.aws.amazon.com/iot/

2. Nel riquadro di navigazione a sinistra, scegli Dispositivi principali.

3. In Greengrass core devices scegli il tuo dispositivo principale.

4. Scegli la scheda Distribuzioni per visualizzare lo stato attuale della distribuzione.

5. Una volta completata la distribuzione (lo stato è Completato), apri una finestra di terminale sul dispositivo principale e visualizza il registro dei componenti dell'applicazione client all'indirizzo. /greengrass/v2/logs/com.lookoutvison.EdgeAgentPythonExample.log Se la distribuzione utilizza la ricetta e il codice di esempio, il registro include l'output di. lookoutvision_edge_agent_example.py Ad esempio:

   Model Details model_component:"ModelComponent"

Distribuzione dei componenti (SDK)

Utilizza la seguente procedura per distribuire il componente dell'applicazione client, il componente modello e Amazon Lookout for Vision Edge Agent sul tuo dispositivo principale.

1. Crea un deployment.json file per definire la configurazione di distribuzione per i tuoi componenti. Questo file dovrebbe essere simile all'esempio seguente.

   {
     "targetArn":"targetArn",
     "components": {
       "com.lookoutvison.EdgeAgentPythonExample": {
         "componentVersion": "1.0.0",
         "configurationUpdate": {
         }
       }
     }
   }

   • Nel targetArn campo, sostituisci targetArncon l'Amazon Resource Name (ARN) dell'oggetto o del gruppo di oggetti a cui destinare la distribuzione, nel seguente formato:

     • Cosa: arn:aws:iot:region:account-id:thing/thingName

     • Gruppo di cose: arn:aws:iot:region:account-id:thinggroup/thingGroupName

2. Controlla se il target di distribuzione ha una distribuzione esistente che desideri modificare. Esegui questa operazione:

   1. Esegui il comando seguente per elencare le distribuzioni per l'obiettivo di distribuzione. Sostituisci targetArn con l'Amazon Resource Name (ARN) dell'oggetto o del gruppo di AWS oggetti IoT di destinazione. Per ottenere gli ARN degli oggetti nell'attuale regione AWS, usa il comandoaws iot list-things.

      aws greengrassv2 list-deployments --target-arn targetArn

      La risposta contiene un elenco con la distribuzione più recente per l'obiettivo. Se la risposta è vuota, la destinazione non dispone di una distribuzione esistente e puoi saltare al passaggio 3. Altrimenti, copia il deploymentId codice dalla risposta da utilizzare nel passaggio successivo.

   2. Esegui il comando seguente per ottenere i dettagli della distribuzione. Questi dettagli includono metadati, componenti e configurazione del processo. Sostituisci deploymentId con l'ID del passaggio precedente.

      aws greengrassv2 get-deployment --deployment-id deploymentId

   3. Copia una delle seguenti coppie chiave-valore dalla risposta del comando precedente in deployment.json. È possibile modificare questi valori per la nuova distribuzione.

      • deploymentName— Il nome della distribuzione.

      • components— I componenti della distribuzione. Per disinstallare un componente, rimuovilo da questo oggetto.

      • deploymentPolicies— Le politiche della distribuzione.

      • tags— I tag della distribuzione.

3. Esegui il comando seguente per distribuire i componenti sul dispositivo. Annota il valore di deploymentId nella risposta.

   aws greengrassv2 create-deployment \
       --cli-input-json file://path/to/deployment.json

4. Esegui il comando seguente per ottenere lo stato della distribuzione. Passa deployment-id al valore che hai annotato nel passaggio precedente. La distribuzione è stata completata correttamente se il valore di deploymentStatus è. COMPLETED

   aws greengrassv2 get-deployment --deployment-id deployment-id

5. Una volta completata la distribuzione, aprite una finestra di terminale sul dispositivo principale e visualizzate il registro dei componenti dell'applicazione client all'indirizzo. /greengrass/v2/logs/com.lookoutvison.EdgeAgentPythonExample.log Se la distribuzione utilizza la ricetta e il codice di esempio, il registro include l'output di. lookoutvision_edge_agent_example.py Ad esempio:

   Model Details model_component:"ModelComponent"