AWS IoT Greengrass Version 1 est entré dans la phase de durée de vie prolongée le 30 juin 2023. Pour plus d'informations, consultez la politique de AWS IoT Greengrass V1 maintenance. Après cette date, AWS IoT Greengrass V1 ne publiera pas de mises à jour fournissant des fonctionnalités, des améliorations, des corrections de bogues ou des correctifs de sécurité. Les appareils qui fonctionnent AWS IoT Greengrass V1 sous tension ne seront pas perturbés et continueront à fonctionner et à se connecter au cloud. Nous vous recommandons vivement de migrer vers AWS IoT Greengrass Version 2, qui ajoute de nouvelles fonctionnalités importantes et prend en charge des plateformes supplémentaires.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configuration des paramètres pour les coureurs de tests

Pour exécuter des suites de tests personnalisées, les exécuteurs de tests doivent configurer leurs paramètres en fonction de la suite de tests qu'ils souhaitent exécuter. Les paramètres sont spécifiés en fonction des modèles de fichiers de configuration JSON situés dans le<device-tester-extract-location>/configs/folder. Si nécessaire, les coureurs d'essai doivent également configurerAWSinformations d'identification qu'IDT utilisera pour se connecter auAWScloud.

En tant que rédacteur de tests, vous devez configurer ces fichiers pourdéboguer votre suite de tests. Vous devez fournir des instructions pour tester les coureurs afin qu'ils puissent configurer les paramètres suivants au besoin pour exécuter vos suites de tests.

Configurer device.json

Ledevice.jsoncontient des informations sur les appareils sur lesquels les tests sont effectués (par exemple, l'adresse IP, les informations de connexion, le système d'exploitation et l'architecture d'UC).

Les coureurs de tests peuvent fournir ces informations via le modèle suivant.device.jsonsitué dans le fichier<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>",
                }
            }
        ]
    }
]

Tous les champs qui contiennent des valeurs sont requis, comme indiqué ici :

(Facultatif) Configuration de userdata.json

Leuserdata.jsoncontient toutes les informations supplémentaires requises par une suite de tests, mais qui ne sont pas spécifiées dans ledevice.jsondans le fichier. Le format de ce fichier dépend de lauserdata_scheme.jsonfichierdéfini dans la suite de tests. Si vous êtes un rédacteur de tests, assurez-vous de fournir ces informations aux utilisateurs qui exécuteront les suites de tests que vous écrivez.

(Facultatif) Configuration de resource.json

Leresource.jsoncontient des informations sur tous les appareils qui seront utilisés comme périphériques de ressources. Les périphériques de ressources sont des appareils nécessaires pour tester certaines fonctionnalités d'un appareil en cours de test. Par exemple, pour tester la capacité Bluetooth d'un appareil, vous pouvez utiliser un périphérique de ressources pour vérifier si votre appareil peut s'y connecter correctement. Les périphériques de ressources sont facultatifs et vous pouvez avoir besoin d'autant d'appareils de ressources que nécessaire. En tant que rédacteur de tests, vous utilisez lefichier test.jsonpour définir les fonctionnalités du périphérique de ressources requises pour un test. Les coureurs de test utilisent ensuite leresource.jsonpour fournir un pool de périphériques de ressources dotés des fonctionnalités requises. Assurez-vous de fournir ces informations aux utilisateurs qui exécuteront les suites de tests que vous écrivez.

Les coureurs de tests peuvent fournir ces informations via le modèle suivant.resource.jsonsitué dans le fichier<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>",
                }
            }
        ]
    }
]

Tous les champs qui contiennent des valeurs sont requis, comme indiqué ici :

(Facultatif) Configuration de config.json

Leconfig.jsoncontient des informations de configuration pour IDT. En règle générale, les exécuteurs de tests n'auront pas besoin de modifier ce fichier, sauf pour fournir leurAWSinformations d'identification utilisateur pour IDT, et éventuellement, unAWSrégion. SiAWSles informations d'identification avec les autorisations requises sont fourniesAWS IoTDevice Tester collecte et soumet des mesures d'utilisation àAWS. Il s'agit d'une fonctionnalité d'option facultative utilisée pour améliorer la fonctionnalité IDT. Pour plus d'informations, consultez Métriques d'utilisation IDT.

Les coureurs de test peuvent configurer leurAWSinformations d'identification de l'une des manières suivantes :

Pour configurerAWSinformations d'identification pour IDT, les coureurs de test modifient leauthdans la sectionconfig.jsonsitué dans le fichier<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>"
        }
    }
}
]

Tous les champs qui contiennent des valeurs sont requis, comme indiqué ici :