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](set-config.md), 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](idt-greengrass-qualification.md#idt-test-suite-versions).
## 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](#bk-cli).
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 {{}} \
--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 {{}} \
--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 {{}} \
--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 {{}} \
--test-id {{,}}
--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 {{}}
```
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 `{{}}/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
```