AWS IoT Greengrass Version 1 entrou na fase de vida útil prolongada em 30 de junho de 2023. Para obter mais informações, consulte política de manutenção do AWS IoT Greengrass V1. Após essa data, AWS IoT Greengrass V1 não lançaremos atualizações que forneçam recursos, aprimoramentos, correções de erros ou patches de segurança. Os dispositivos que funcionam AWS IoT Greengrass V1 não serão interrompidos e continuarão operando e se conectando à nuvem. É altamente recomendável que você migre para AWS IoT Greengrass Version 2, o que adiciona novos recursos significativos e suporte para plataformas adicionais.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Definir configurações para executores de teste

Para executar conjuntos de testes personalizados, os executores de teste devem definir suas configurações com base no pacote de testes que desejam executar. As configurações são especificadas com base nos modelos de arquivo de configuração JSON localizados na pasta <device-tester-extract-location>/configs/. Se necessário, os executores de teste também devem configurar as credenciais da AWS que o IDT usará para se conectar à nuvem da AWS.

Como redator de testes, você precisará configurar esses arquivos para depurar seu pacote de testes. Você deve fornecer instruções aos executores de teste para que eles possam definir as configurações a seguir conforme necessário para executar seus conjuntos de testes.

Configurar device.json

O arquivo device.json contém informações sobre os dispositivos nos quais os testes são executados (por exemplo, endereço IP, informações de login, sistema operacional e arquitetura da CPU).

Os executores de teste podem fornecer essas informações usando o seguinte modelo de arquivo device.json localizado na pasta <device-tester-extract-location>/configs/.

[
    {
        "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>",
                }
            }
        ]
    }
]

Todos os campos que contêm valores são necessários, conforme descrito aqui:

(Opcional) Configurar userdata.json

O arquivo userdata.json contém qualquer informação adicional que seja exigida por um pacote de testes, mas que não esteja especificada no arquivo device.json. O formato desse arquivo depende do arquivo userdata_scheme.json definido no pacote de testes. Se você é um escritor de testes, certifique-se de fornecer essas informações aos usuários que executarão os conjuntos de testes que você escreve.

(Opcional) Configure resource.json

O arquivo resource.json contém informações sobre todos os dispositivos que serão usados como dispositivos de recursos. Os dispositivos de recursos são necessários para testar determinadas capacidades de um dispositivo em teste. Por exemplo, para testar a capacidade Bluetooth de um dispositivo, você pode usar um dispositivo de recurso para testar se seu dispositivo consegue se conectar a ele com sucesso. Os dispositivos de recursos são opcionais, e você pode exigir quantos dispositivos de recursos forem necessários. Como redator de testes, você usa o arquivo test.json para definir os atributos do dispositivo de atributos necessários para um teste. Em seguida, os executores de teste usam o arquivo resource.json para fornecer um grupo de dispositivos de atributos contendo os atributos necessários. Certifique-se de fornecer essas informações aos usuários que executarão os conjuntos de testes que você escreve.

Os executores de teste podem fornecer essas informações usando o seguinte modelo de arquivo resource.json localizado na pasta <device-tester-extract-location>/configs/.

[
    {
        "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>",
                }
            }
        ]
    }
]

Todos os campos que contêm valores são necessários, conforme descrito aqui:

(Opcional) Configurar config.json

O arquivo config.json contém as informações de configuração para o IDT. Normalmente, os executores de teste não precisarão modificar esse arquivo, exceto para fornecer suas credenciais de usuário da AWS para o IDT e, opcionalmente, para uma região da AWS. Se as credenciais da AWS com as permissões necessárias forem fornecidas, o AWS IoT Device Tester coletará e enviará métricas de uso para a AWS. Esse atributo é opcional e usado para aprimorar a funcionalidade do IDT. Para obter mais informações, consulte Métricas de uso do IDT.

Os executores de teste podem configurar suas credenciais da AWS por meio de uma das maneiras a seguir:

Para configurar as credenciais da AWS para o IDT, os executores de teste editam a seção auth no arquivo config.json localizado na pasta <device-tester-extract-location>/configs/.

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

Todos os campos que contêm valores são necessários, conforme descrito aqui: