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

Tutorial: compile e execute o pacote de amostra de teste de IDT

O download do AWS IoT Device Tester inclui o código-fonte de um pacote de amostra de teste. Você pode seguir este tutorial para criar e executar o pacote de amostra de teste para entender como você pode usar o AWS IoT Device Tester para executar conjuntos de teste personalizados do AWS IoT Greengrass.

Pré-requisitos

Para concluir este tutorial, você precisará do seguinte:

Configure as informações do dispositivo para o IDT

Configure as informações do seu dispositivo para que o IDT execute o teste. Você deve atualizar o modelo device.json localizado na pasta <device-tester-extract-location>/configs com as seguintes informações.

[
  {
    "id": "pool",
    "sku": "N/A",
    "devices": [
      {
        "id": "<device-id>",
        "connectivity": {
          "protocol": "ssh",
          "ip": "<ip-address>",
          "port": "<port>",
          "auth": {
            "method": "pki | password",
            "credentials": {
              "user": "<user-name>",
              "privKeyPath": "/path/to/private/key",
              "password": "<password>"
            }
          }
        }
      }
    ]
  }
]

No objeto devices, forneça as seguintes informações:

Compile o pacote de amostra de teste

A pasta <device-tester-extract-location>/samples/python contém exemplos de arquivos de configuração, código-fonte e o SDK do cliente IDT que você pode combinar em um pacote de testes usando os scripts de construção fornecidos. A árvore de diretórios a seguir mostra a localização desses arquivos de amostra:

<device-tester-extract-location>
├── ...
├── tests
├── samples
│   ├── ...
│   └── python
│       ├── configuration
│       ├── src
│       └── build-scripts
│           ├── build.sh
│           └── build.ps1
└── sdks
    ├── ...
    └── python
        └── idt_client

Para criar o pacote de testes, execute os seguintes comandos em seu computador host:

Windows

cd <device-tester-extract-location>/samples/python/build-scripts
./build.ps1

Linux, macOS, or UNIX

cd <device-tester-extract-location>/samples/python/build-scripts
./build.sh

Isso cria o pacote de amostra de teste na pasta IDTSampleSuitePython_1.0.0 dentro da pasta <device-tester-extract-location>/tests. Examine os arquivos na pasta IDTSampleSuitePython_1.0.0 para entender como o pacote de amostra de teste está estruturado e veja vários exemplos de executáveis de casos de teste e arquivos JSON de configuração de teste.

Próxima etapa: use o IDT para executar o pacote de amostra de teste que você criou.

Use o IDT para executar o pacote de amostra de teste

Para executar o pacote de amostra de teste, execute os seguintes comandos em seu computador host:

cd <device-tester-extract-location>/bin
./devicetester_[linux | mac | win_x86-64] run-suite --suite-id IDTSampleSuitePython

O IDT executa o pacote de amostra de teste e transmite os resultados para o console. Quando a execução do teste for concluída, você verá as seguintes informações:

========== Test Summary ==========
Execution Time:         5s
Tests Completed:        4
Tests Passed:           4
Tests Failed:           0
Tests Skipped:          0
----------------------------------
Test Groups:
    sample_group:       PASSED
----------------------------------
Path to IoT Device Tester Report: /path/to/devicetester/results/87e673c6-1226-11eb-9269-8c8590419f30/awsiotdevicetester_report.xml
Path to Test Execution Logs: /path/to/devicetester/results/87e673c6-1226-11eb-9269-8c8590419f30/logs
Path to Aggregated JUnit Report: /path/to/devicetester/results/87e673c6-1226-11eb-9269-8c8590419f30/IDTSampleSuitePython_Report.xml

Solução de problemas

Use as informações a seguir para ajudar você a resolver quaisquer problemas do tutorial.

O caso de teste não é executado com êxito

Se o teste não for executado com êxito, o IDT transmite os logs de erros para o console, o que pode ajudar você a solucionar o problema da execução do teste. Certifique-se de que você atendeu a todos os pré-requisitos deste tutorial.