AWS IoT Greengrass 資格 Suite の実行 - AWS IoT Greengrass
実行スイートコマンドの例IDT コマンド

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWS IoT Greengrass 資格 Suite の実行

必要な設定を定義したら、テストを開始できます。完全なテストスイートのランタイムはハードウェアによって異なります。参考までに、Raspberry Pi 3B で完全なテストスイートを完了するには約 30 分かかります。

次の run-suite コマンドを使用して、一連のテストを実行します。

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

すべてオプションは任意です。例えば、device.json ファイルに定義されている同一のデバイスのセットであるデバイスプールが 1 つしかない場合は、pool-id を省略できます。または、tests フォルダ内の最新のテストスイートのバージョンを実行する場合は、suite-id を省略できます。

注記

IDT は、新しいテストスイートのバージョンをオンラインで入手できるかどうかを尋ねるプロンプトを表示します。詳細については、「テストスイートのバージョン」を参照してください。

資格スイートを実行するためのコマンド例

以下のコマンドラインの例では、デバイスプールに対して適格性確認テストを実行する方法を示します。run-suite およびその他の IDT コマンドの詳細については、「AWS IoT Greengrass V2 コマンドの IDT」を参照してください。

指定のテストスイートのテストグループをすべて実行するには、次のコマンドを使用します。list-suites コマンドは、tests フォルダにあるテストスイートを一覧表示します。

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

テストスイートの特定のテストグループを実行するには、次のコマンドを使用します。list-groups コマンドは、テストスイートのテストグループを一覧表示します。

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

テストグループの特定のテストケースを実行するには、次のコマンドを使用します。

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

テストグループの複数のテストケースを実行するには、次のコマンドを使用します。

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

テストグループのすべてのテストケースを一覧表示するには、次のコマンドを使用します。

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

テストグループの依存関係を正しい順序で実行する、完全な認定テストスイートを実行することをお勧めします。特定のテストグループを実行することを選択した場合、関連するテストグループを実行する前に、まず依存関係チェッカーテストグループを実行し、すべての Greengrass の依存関係がインストールされていることを確認することをお勧めします。例:

  • コア資格テストグループを実行する前に coredependencies を実行します。

AWS IoT Greengrass V2 コマンドの IDT

IDT コマンドは、<device-tester-extract-location>/bin ディレクトリにあります。テストスイートを実行するには、次の形式でコマンドを提供します。

help

指定されたコマンドに関する情報を一覧表示します。

list-groups

特定のテストスイート内のグループを一覧表示します。

list-suites

使用可能なテストスイートを一覧表示します。

list-supported-products

サポート対象製品 (この場合は AWS IoT Greengrass バージョン) と最新の IDT バージョンのテストスイートのバージョンを一覧表示します。

list-test-cases

指定したテストグループのテストケースを一覧表示します。次のオプションがサポートされています。

  • group-id。検索するテストグループ。このオプションは必須で、1 つのグループを指定する必要があります。

run-suite

デバイスプールに対してテストスイートを実行します。サポートされているオプションの一部は以下のとおりです。

  • suite-id。実行するテストスイートのバージョン。指定しない場合、IDT は tests フォルダにある最新バージョンを使用します。

  • group-id。実行するテストグループ (カンマ区切りリストとして)。指定しない場合、IDT は、device.json で設定された設定に応じて、テストスイートのすべての適切なテストグループを実行します。IDT は、設定した設定に基づいてデバイスがサポートしていないテストグループを実行しません。(これらのテストグループが group-id リストで指定されている場合でも同様)。

  • test-id。実行するテストケース (カンマ区切りリストとして)。指定した場合は、group-id は 1 つのグループを指定する必要があります。

  • pool-id。テストするデバイスプール。device.json ファイルに複数のデバイスプールが定義されている場合は、プールを指定する必要があります。

  • stop-on-first-failure。最初に障害で実行を停止するように IDT を設定します。指定されたテストグループをデバッグする場合は、このオプションを group-id とともに使用します。完全テストスイートを実行して認定レポートを生成する場合は、このオプションを使用しないでください。

  • update-idt。 IDT を更新するプロンプトの応答を設定します。IDT が新しいバージョンがあることを検出した場合、Y 応答はテストの実行を停止します。N 応答は、テストの実行を継続します。

  • userdata。テストアーティファクトパスに関する情報を含む userdata.json ファイルへのフルパス。このオプションは、run-suite コマンドに必要です。userdata.json ファイルは devicetester_extract_location/devicetester_ggv2_[win|mac|linux]/configs/ ディレクトリに配置される必要があります。

run-suite オプションの詳細については、次の help オプションを使用してください。

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