のドキュメントを表示していますAWS IoT Greengrass Version 1。AWS IoT Greengrass Version 2の最新のメジャーバージョンです。AWS IoT Greengrass。の使用方法の詳細については、「」を参照してください。AWS IoT Greengrass V2の詳細については、AWS IoT Greengrass Version 2開発者ガイド。

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

チュートリアル: シンプルなIDTテストスイートの開発

テストスイートは、次のものを組み合わせます。

このチュートリアルでは、IDT をAWS IoT Greengrassを使用して、単一のテストケースを含む Python テストスイートを開発します。このチュートリアルでは、次の手順を実行します。

Prerequisites

このチュートリアルを完了するには、以下が必要です。

テストスイートディレクトリの作成

IDT は、テストケースを各テストスイート内のテストグループに論理的に分離します。各テストケースは、テストグループ内に存在する必要があります。このチュートリアルでは、MyTestSuite_1.0.0をクリックし、このフォルダ内に次のディレクトリツリーを作成します。

MyTestSuite_1.0.0
└── suite
    └── myTestGroup
        └── myTestCase

JSON 設定ファイルを作成する

テストスイートには、以下の必須のJSON 設定ファイル:

ディレクトリツリーMyTestSuite_1.0.0フォルダは以下のようになります。

MyTestSuite_1.0.0
└── suite
    ├── suite.json
    └── myTestGroup
        ├── group.json
        └── myTestCase
            └── test.json

IDT クライアント SDK の取得

「」を使用します。IDT クライアント SDKを使用して、IDT がテスト対象のデバイスと対話し、テスト結果を報告できるようにします。このチュートリアルでは、Python バージョンの SDK を使用します。

」<device-tester-extract-location>/sdks/python/フォルダーで、idt_clientフォルダをMyTestSuite_1.0.0/suite/myTestGroup/myTestCasefolder

SDK が正常にコピーされたことを確認するには、次のコマンドを実行します。

cd MyTestSuite_1.0.0/suite/myTestGroup/myTestCase
python3 -c 'import idt_client'

テストケースの実行可能ファイルを作成する

テストケース実行可能ファイルには、実行するテストロジックが含まれています。テストスイートには、複数のテストケース実行可能ファイルを含めることができます。このチュートリアルでは、テストケースの実行可能ファイルを 1 つだけ作成します。

IDT のデバイス情報の構成

IDT でテストを実行するためのデバイス情報を設定します。更新する必要があります。device.jsonテンプレートにある<device-tester-extract-location>/configsフォルダーに以下の情報を入力します。

[
  {
    "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>"
            }
          }
        }
      }
    ]
  }
]

左devicesオブジェクトには、次の情報を入力します。

テストスイートの実行

テストスイートを作成したら、それが期待どおりに機能することを確認する必要があります。既存のデバイスプールでテストスイートを実行するには、以下の手順に従います。

IDT はテストスイートを実行し、結果をコンソールにストリーミングします。テストの実行が完了すると、次の情報が表示されます。

time="2020-10-19T09:24:47-07:00" level=info msg=Using pool: pool
time="2020-10-19T09:24:47-07:00" level=info msg=Using test suite "MyTestSuite_1.0.0" for execution
time="2020-10-19T09:24:47-07:00" level=info msg=b'hello world\n' suiteId=MyTestSuite groupId=myTestGroup testCaseId=myTestCase deviceId=my-device executionId=9a52f362-1227-11eb-86c9-8c8590419f30
time="2020-10-19T09:24:47-07:00" level=info msg=All tests finished. executionId=9a52f362-1227-11eb-86c9-8c8590419f30
time="2020-10-19T09:24:48-07:00" level=info msg=

========== Test Summary ==========
Execution Time:         1s
Tests Completed:        1
Tests Passed:           1
Tests Failed:           0
Tests Skipped:          0
----------------------------------
Test Groups:
    myTestGroup:        PASSED
----------------------------------
Path to IoT Device Tester Report: /path/to/devicetester/results/9a52f362-1227-11eb-86c9-8c8590419f30/awsiotdevicetester_report.xml
Path to Test Execution Logs: /path/to/devicetester/results/9a52f362-1227-11eb-86c9-8c8590419f30/logs
Path to Aggregated JUnit Report: /path/to/devicetester/results/9a52f362-1227-11eb-86c9-8c8590419f30/MyTestSuite_Report.xml

Troubleshooting

チュートリアルを完了する際の問題を解決するには、以下の情報が役立ちます。