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

Configurazione delle impostazioni per i test runner

Per eseguire suite di test personalizzate, i test runner devono configurare le impostazioni in base alla suite di test che desiderano eseguire. Le impostazioni sono specificate in base ai modelli di file di configurazione JSON situati nel<device-tester-extract-location>/configs/folder. Se necessario, devono essere configurati anche i test runnerAWScredenziali che IDT utilizzerà per connettersi alAWSnuvola.

In qualità di test writer, è necessario configurare questi fileEseguire il debug della suite di test. È necessario fornire istruzioni per testare i runner in modo che possano configurare le seguenti impostazioni secondo necessità per eseguire le suite di test.

Configura dispositivo.json

Ladevice.jsonIl file contiene le informazioni sui dispositivi su cui eseguire i test (ad esempio l'indirizzo IP, le informazioni di accesso, il sistema operativo e l'architettura della CPU).

I corridori di test possono fornire queste informazioni utilizzando il seguente modellodevice.jsonfile situato nel<device-tester-extract-location>/configs/folder.

[
    {
        "id": "<pool-id>",
        "sku": "<pool-sku>",
        "features": [
            {
                "name": "<feature-name>",             
                "value": "<feature-value>",                
                "configs": [
                    {
                        "name": "<config-name>",                    
                        "value": "<config-value>"
                    }
                ],
            }
        ],     
        "devices": [
            {
                "id": "<device-id>",              
                "connectivity": {
                    "protocol": "ssh | uart | docker",                   
                    // ssh
                    "ip": "<ip-address>",
                    "port": <port-number>,
                    "auth": {
                        "method": "pki | password",
                        "credentials": {
                            "user": "<user-name>", 
                            // pki
                            "privKeyPath": "/path/to/private/key",
                                         
                            // password
                            "password": "<password>",
                        }
                    },
                    
                    // uart
                    "serialPort": "<serial-port>",
                    
                    // docker
                    "containerId": "<container-id>",
                    "containerUser": "<container-user-name>",
                }
            }
        ]
    }
]

Tutti i campi che includono valori sono obbligatori, come descritto di seguito:

(Facoltativo) Configurazione di userdata.json

Lauserdata.jsonil file contiene qualsiasi informazione aggiuntiva richiesta da una suite di test ma non specificata nelladevice.jsonfile. Il formato di questo file dipende dallauserdata_scheme.jsondocumentodefinito nella suite di test. Se sei un test writer, assicurati di fornire queste informazioni agli utenti che eseguiranno le suite di test che scrivi.

(Facoltativo) Configurazione di resource.json

Laresource.jsonil file contiene informazioni su tutti i dispositivi che verranno utilizzati come dispositivi di risorse. I dispositivi di risorse sono dispositivi necessari per testare determinate funzionalità di un dispositivo in fase di test. Ad esempio, per testare la funzionalità Bluetooth di un dispositivo, è possibile utilizzare un dispositivo di risorse per verificare che il dispositivo possa connettersi correttamente. I dispositivi di risorse sono facoltativi e puoi richiedere tutte le risorse di cui hai bisogno. Come scrittore di test, si utilizza iltest.jsonper definire le funzionalità del dispositivo di risorse necessarie per un test. I corridori di prova quindi usano ilresource.jsonfile per fornire un pool di dispositivi di risorse che dispongono delle funzionalità richieste. Assicurati di fornire queste informazioni agli utenti che eseguiranno le suite di test che scrivi.

I corridori di test possono fornire queste informazioni utilizzando il seguente modelloresource.jsonfile situato nel<device-tester-extract-location>/configs/folder.

[
    {
        "id": "<pool-id>",
        "features": [
            {
                "name": "<feature-name>",             
                "version": "<feature-value>",                
                "jobSlots": <job-slots>
            }
        ],     
        "devices": [
            {
                "id": "<device-id>",              
                "connectivity": {
                    "protocol": "ssh | uart | docker",                   
                    // ssh
                    "ip": "<ip-address>",
                    "port": <port-number>,
                    "auth": {
                        "method": "pki | password",
                        "credentials": {
                            "user": "<user-name>", 
                            // pki
                            "privKeyPath": "/path/to/private/key",
                                         
                            // password
                            "password": "<password>",
                        }
                    },
                    
                    // uart
                    "serialPort": "<serial-port>",
                    
                    // docker
                    "containerId": "<container-id>",
                    "containerUser": "<container-user-name>",
                }
            }
        ]
    }
]

Tutti i campi che includono valori sono obbligatori, come descritto di seguito:

(Facoltativo) Config.json

Laconfig.jsonil file contiene informazioni di configurazione per IDT. In genere, i test runner non dovranno modificare questo file, tranne che per fornire il loroAWScredenziali utente per IDT e, facoltativamente, unAWSregione. SeAWSvengono fornite credenziali con autorizzazioni richiesteAWS IoTDevice Tester raccoglie e invia le metriche di utilizzo aAWS. Questa è una funzionalità di consenso e viene utilizzata per migliorare la funzionalità IDT. Per ulteriori informazioni, consulta la pagina Parametri di utilizzo IDT .

I test runner possono configurare il loroAWScredenziali in uno dei seguenti modi:

Per configurareAWScredenziali per IDT, i test runner modificanoauthsezione nellaconfig.jsonfile situato nel<device-tester-extract-location>/configs/folder.

{
    "log": {
        "location": "logs"
    },
    "configFiles": {
        "root": "configs",
        "device": "configs/device.json"
    },
    "testPath": "tests",
    "reportPath": "results",
    "awsRegion": "<region>",
    "auth": {
        "method": "file | environment",
        "credentials": {
            "profile": "<profile-name>"
        }
    }
}
]

Tutti i campi che includono valori sono obbligatori, come descritto di seguito: