Execute o pacote AWS IoT Greengrass de qualificação - AWS IoT Greengrass
Exemplos de comandos run-suiteComandos do IDT

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

Execute o pacote AWS IoT Greengrass de qualificação

Depois de definir a configuração necessária, você poderá iniciar os testes. O runtime do conjunto de testes completo depende do seu hardware. Como referência, leva aproximadamente 30 minutos para concluir o pacote de testes completo em um Raspberry Pi 3B.

Use o comando run-suite a seguir para executar um pacote de testes.

devicetester_[linux | mac | win]_x86-64 run-suite  \\
    --suite-id suite-id  \\
    --group-id group-id  \\
    --pool-id your-device-pool \\
    --test-id test-id  \\
    --update-idt y|n  \\
    --userdata userdata.json

Todas as opções são facultativas. Por exemplo, você pode omitir pool-id se tiver apenas um grupo de dispositivos, que é um conjunto de dispositivos idênticos, definido em seu arquivo device.json. Você também pode omitir suite-id se quiser executar a versão mais recente do conjunto de testes na pasta tests.

nota

O IDT avisará se uma versão mais recente do conjunto de testes estiver disponível online. Para obter mais informações, consulte Versões do pacote de testes.

Exemplos de comandos para executar o pacote de qualificação

O comando a seguir mostra como executar os testes de qualificação para um grupo de dispositivos. Para obter mais informações sobre run-suite e outros comandos IDT, consulte IDT para comandos AWS IoT Greengrass V2.

Use o seguinte comando para executar todos os grupos de testes em um determinado pacote de testes. O comando list-suites lista os conjuntos de testes que estão na pasta tests.

devicetester_[linux | mac | win]_x86-64 run-suite \
    --suite-id GGV2Q_1.0.0 \
    --pool-id <pool-id> \
    --userdata userdata.json

Use o comando a seguir para executar um grupo de testes em um pacote de testes. O comando list-groups lista os grupos de teste em um conjunto de testes.

devicetester_[linux | mac | win]_x86-64 run-suite \
    --suite-id GGV2Q_1.0.0 \
    --group-id <group-id> \
    --pool-id <pool-id> \
    --userdata userdata.json

Use o comando a seguir para executar um caso de teste em um grupo de testes.

devicetester_[linux | mac | win]_x86-64 run-suite \
    --group-id <group-id> \
    --test-id <test-id> \
    --userdata userdata.json

Use o comando a seguir para executar vários casos de teste em um grupo de teste.

devicetester_[linux | mac | win]_x86-64 run-suite \
    --group-id <group-id> \
    --test-id <test-id1>,<test-id2>
    --userdata userdata.json

Use o comando a seguir para listar todos os casos de teste em um grupo de testes.

devicetester_[linux | mac | win]_x86-64 list-test-cases --group-id <group-id>

Recomendamos que você execute o conjunto completo de testes de qualificação, que executa as dependências do grupo de teste na ordem correta. Se você optar por executar grupos de testes específicos, recomendamos executar primeiro o grupo de testes do verificador de dependência para garantir que todas as dependências do Greengrass estejam instaladas antes de executar grupos de testes relacionados. Por exemplo:

  • Execute coredependencies antes de executar grupos de testes de qualificação de núcleo.

IDT para comandos AWS IoT Greengrass V2

Os comandos do IDT estão localizados no diretório <device-tester-extract-location>/bin. Para executar uma suíte de testes, você fornece o comando no seguinte formato:

help

Lista as informações sobre o comando especificado.

list-groups

Lista os grupos em um determinado conjunto de teste.

list-suites

Lista os conjuntos de teste disponíveis.

list-supported-products

Lista os produtos suportados, neste caso AWS IoT Greengrass as versões, e as versões do conjunto de testes para a versão atual do IDT.

list-test-cases

Lista os casos de teste em um grupo de teste. A seguinte opção é compatível:

  • group-id. O grupo de teste a ser pesquisado. Esta opção é necessária e deve especificar um único grupo.

run-suite

Executa um conjunto de testes em um grupo de dispositivos. Algumas opções compatíveis estão listadas a seguir:

  • suite-id. A versão do conjunto de testes a ser executada. Se não for especificado, o IDT usará a versão mais recente na pasta tests.

  • group-id. Os grupos de teste a serem executados, como uma lista separada por vírgulas. Se não for especificado, o IDT executará todos os grupos de teste apropriados no pacote de teste, dependendo das configurações definidas no arquivo device.json. O IDT não executa nenhum grupo de teste que o dispositivo não suporte com base nas configurações definidas, mesmo que esses grupos de teste estejam especificados na lista group-id.

  • test-id. Os casos de teste a serem executados, como uma lista separada por vírgulas. Quando especificado, group-id deve especificar um único grupo.

  • pool-id. O grupo de dispositivos a ser testado. Você deve especificar um grupo se tiver vários grupos de dispositivos definidos no arquivo device.json.

  • stop-on-first-failure. Configura o IDT de modo a interromper a execução na primeira falha. Use essa opção com group-id quando quiser depurar os grupos de teste especificados. Não use essa opção para gerar um relatório de qualificação ao executar um conjunto de testes completo.

  • update-idt. Define a resposta do prompt para atualização do IDT. A resposta Y interrompe a execução do teste se o IDT detectar que há uma versão mais recente. A resposta N continua a execução do teste.

  • userdata. O caminho completo para o arquivo userdata.json que contém informações sobre os caminhos dos artefatos de teste. Essa opção é necessária para o comando run-suite. O userdata.json arquivo deve estar localizado no diretório devicetester_extract_location /devicetester_ggv2_ [win|mac|linux] /configs/.

Para obter mais informações sobre as opções run-suite, use a opção help:

devicetester_[linux | mac | win]_x86-64 run-suite -h