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

Como autor de testes, você precisará configurar esses arquivos para depurar o conjunto de testes. Você deve fornecer instruções aos executores de teste para que eles possam definir as seguintes configurações conforme necessário para executar os 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 de CPU).

Os executores de teste podem fornecer essas informações usando o seguinte arquivo device.json de modelo 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) Configuração de userdata.json

O arquivo userdata.json contém toda as informações adicionais exigidas por um conjunto de testes, mas não estão especificadas no arquivo device.json. O formato desse arquivo depende do arquivo userdata_scheme.json definido no conjunto de testes. Se você é um autor de testes, forneça essas informações aos usuários que executarão os conjuntos de testes que você escreveu.

(Opcional) Configurar 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 determinados recursos 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 com êxito. Os dispositivos de recursos são opcionais e você pode exigir quantos dispositivos de recursos forem necessários. Como autor de testes, você usa o arquivo test.json para definir os recursos do dispositivo de recursos necessários para um teste. Em seguida, os executores de teste usam o arquivo resource.json para fornecer um grupo de dispositivos de recursos com os recursos necessários. Forneça essas informações aos usuários que executarão os conjuntos de teste que você escreve.

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

[
    {
        "id": "<pool-id>",
        "features": [
            {
                "name": "<feature-name>",             
                "version": "<feature-version>",                
                "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) Configuração de config.json

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

Os executores de teste podem configurar as credenciais da AWS de uma das seguintes maneiras:

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: