デバイスへのコンポーネントのデプロイ - Amazon Lookout for Vision

サポート終了通知: 2025 年 10 月 31 日、 AWS は Amazon Lookout for Vision のサポートを終了します。2025 年 10 月 31 日以降、Lookout for Vision コンソールまたは Lookout for Vision リソースにアクセスできなくなります。詳細については、このブログ記事 を参照してください。

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

デバイスへのコンポーネントのデプロイ

モデルコンポーネントとクライアントアプリケーションコンポーネントを AWS IoT Greengrass Version 2 コアデバイスにデプロイするには、AWS IoT Greengrass V2 コンソールまたは CreateDeployment API を使用します。詳細については、「デプロイメントを作成する」か「AWS IoT Greengrass Version 2 開発者ガイド」を参照してください。コアデバイスにデプロイされるコンポーネントの更新について詳しくは、「デプロイメントを改訂する」を参照してください。

コンポーネントのデプロイのための IAM 権限

AWS IoT Greengrass V2 によりコンポーネントをデプロイするには、次の権限も必要です:

  • greengrass:ListComponents

  • greengrass:ListComponentVersions

  • greengrass:ListCoreDevices

  • greengrass:CreateDeployment

  • greengrass:GetDeployment

  • greengrass:ListDeployments

CreateDeploymentGetDeployment には依存アクションがあります。詳細については、「 AWS IoT Greengrass V2 によって定義されるアクション 」を参照してください。

IAM 権限の変更の詳細については、「ユーザーの権限の変更」を参照してください。

コンポーネントのデプロイ (コンソール)

次の手続きを使用して、クライアントアプリケーションコンポーネントをコアデバイスにデプロイします。クライアントアプリケーションはモデルコンポーネントに依存します (逆にモデルコンポーネントは Lookout for Vision Edge エージェントに依存します)。クライアントアプリケーションコンポーネントをデプロイすると、モデルコンポーネントと Lookout for Vision Edge Agent のデプロイメントも開始されます。

注記

コンポーネントを既存のデプロイメントに追加できます。コンポーネントをモノグループにデプロイすることもできます。

この手続きを実行するには、AWS IoT Greengrass V2 コアデバイスが構成されている必要があります。詳細については「AWS IoT Greengrass Version 2 コアデバイスのセットアップ」を参照してください。

デバイスにコンポーネントをデプロイするには
  1. https://console.aws.amazon.com/iot/ で AWS IoT Greengrass コンソールを開きます。

  2. 左ナビゲーションペインの [Greengrass][デプロイメント] を選択します。

  3. [デプロイメント][作成]を選択します。

  4. 対象を指定する」ページで、次を実行します:

    1. [デプロイメント情報] で、デプロイの名前を入力または変更して、わかりやすくします。

    2. [デプロイメント対象][コアデバイス] を選択し、対象名を入力します。

    3. [次へ] をクリックします。

  5. コンポーネントを選択する」ページで、次の手順を実行します:

    1. [マイコンポーネント] で、クライアントアプリケーションコンポーネントの名前 (com.lookoutvison.EdgeAgentPythonExample) を選択します。

    2. [次へ] を選択します。

  6. コンポーネントを構成する」ページで、現行の構成を維持して [次へ] を選択します。

  7. 高度な設定を構成する」ページで、現行の設定を維持して [次へ] を選択します。

  8. 見直しをする」ページで [デプロイ] を選択し、コンポーネントのデプロイを開始します。

デプロイメントステータスのチェック (コンソール)

AWS IoT Greengrass V2 コンソールからデプロイメントのステータスをチェックできます。クライアントアプリケーションコンポーネントが クライアントアプリケーションコンポーネントの作成 のサンプルレシピおよびコードを使用している場合は、デプロイメント完了後にクライアントアプリケーションコンポーネントのログを確認してください。成功すると、ログにはコンポーネントにデプロイされた Lookout for Vision モデルのリストが含まれます。

AWS SDK を使用したデプロイメントステータスのチェックについては、「デプロイメントステータスをチェックする」を参照してください。

デプロイメントステータスをチェックするには
  1. AWS IoT Greengrass コンソール (https://console.aws.amazon.com/es/) を開きます。

  2. 左ナビゲーションメニューで、[コアデバイス] を選択します。

  3. [Greengrass コアデバイス] でコアデバイスを選択します。

  4. [デプロイメント] タブを選択すると、現在のデプロイメントステータスが表示されます。

  5. デプロイメントが成功 (ステータスが「完了」になります) したら、コアデバイスでターミナルウィンドウを開き、クライアントアプリケーションコンポーネントのログを /greengrass/v2/logs/com.lookoutvison.EdgeAgentPythonExample.log で確認します。デプロイメントでサンプルのレシピとコードを使用している場合、ログには lookoutvision_edge_agent_example.py からの出力が含まれます。例:

    Model Details model_component:"ModelComponent"

コンポーネントのデプロイ (SDK)

以下の手続きを使用して、クライアントアプリケーションコンポーネント、モデルコンポーネント、および Amazon Lookout for Vision Edge Agent をコアデバイスにデプロイします。

  1. deployment.json ファイルを作成して、コンポーネントのデプロイメント構成を定義します。このファイルは、次の例のようになります。

    { "targetArn":"targetArn", "components": { "com.lookoutvison.EdgeAgentPythonExample": { "componentVersion": "1.0.0", "configurationUpdate": { } } } }
    • [targetArn] フィールドで targetArn をデプロイメントの対象となるモノまたはモノのグループの Amazon リソースネーム (ARN) に置き換えます。形式は以下のとおりです:

      • モノ: arn:aws:iot:region:account-id:thing/thingName

      • モノのグループ: arn:aws:iot:region:account-id:thinggroup/thingGroupName

  2. デプロイメント対象に、修正が必要な既存のデプロイメントがあるかどうかをチェックします。以下を行います:

    1. 次のコマンドを実行して、デプロイメント対象のデプロイメントを一覧表示します。targetArn を、対象の AWS IoT モノまたはモノグループの Amazon リソースネーム (ARN) に置き換えます。現在の AWS リージョンにあるモノの ARN を取得するには、aws iot list-things コマンドを使用します。

      aws greengrassv2 list-deployments --target-arn targetArn

      レスポンスには、対象の最新デプロイメントのリストが含まれています。レスポンスが空の場合は、対象に既存のデプロイメントがないため、ステップ 3 にスキップできます。そうでない場合は、次のステップで使用するため、レスポンスから deploymentId をコピーします。

    2. 次のコマンドを実行して、デプロイメントの詳細を取得します。これらの詳細には、メタデータ、コンポーネント、ジョブ構成が含まれます。deploymentId を前のステップの ID に置き換えます。

      aws greengrassv2 get-deployment --deployment-id deploymentId
    3. 前のコマンドのレスポンスにおける以下の key-value ペアをすべて into deployment.json にコピーします。新しいデプロイメントではこれらの値を変更できます。

      • deploymentName - デプロイメントの名前。

      • components - デプロイメントのコンポーネント。コンポーネントをアンインストールする場合は、このオブジェクトから削除してください。

      • deploymentPolicies - デプロイメントのポリシー。

      • tags - デプロイメントのタグ。

  3. 次のコマンドを実行して、デバイスにコンポーネントをデプロイします。レスポンス内の deploymentId の値をメモしてください。

    aws greengrassv2 create-deployment \ --cli-input-json file://path/to/deployment.json
  4. 次のコマンドを実行して、デプロイのステータスを取得します。deployment-id を前のステップでメモした値に変更します。deploymentStatus の値が COMPLETED であれば、デプロイメントは正常に完了しています。

    aws greengrassv2 get-deployment --deployment-id deployment-id
  5. デプロイメントが成功したら、コアデバイスのターミナルウィンドウを開き、/greengrass/v2/logs/com.lookoutvison.EdgeAgentPythonExample.log でクライアントアプリケーションコンポーネントのログを確認します。デプロイメントでサンプルのレシピとコードを使用している場合、ログには lookoutvision_edge_agent_example.py からの出力が含まれます。例:

    Model Details model_component:"ModelComponent"