コアデバイスのエンドポイントを管理 - AWS IoT Greengrass

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

コアデバイスのエンドポイントを管理

クラウド検出を使用する場合、コアデバイスのMQTTブローカーエンドポイントを AWS IoT Greengrass クラウドサービスに保存します。クライアントデバイスは、 AWS IoT Greengrass に接続して、これらのエンドポイントおよび関連するコアデバイスのその他の情報を取得します。

各コアデバイスに、エンドポイントを自動または手動で管理できます。

  • IP ディテクタでエンドポイントを自動的に管理

    クライアントデバイスがコアデバイスと同じネットワーク上の場所など、複雑ではないネットワーク設定を行っている場合、IP 検知コンポーネントをデプロイして、ユーザーに代わってコアデバイスエンドポイントを自動的に管理できます。例えば、コアデバイスがMQTTブローカーポートをコアデバイスに転送するルーターの背後にある場合、IP ディテクターコンポーネントを使用することはできません。

    IP ディテクタコンポーネントは、モノグループにあるすべてのコアデバイスのエンドポイントを管理するため、モノグループに展開する場合にも役立ちます。詳細については、「IP ディテクタを使用してエンドポイントを自動的に管理」を参照してください。

  • エンドポイントを手動で管理

    IP ディテクタコンポーネントを使用できない場合、コアデバイスエンドポイントを手動で管理する必要があります。これらのエンドポイントは、 コンソールまたは を使用して更新できますAPI。詳細については、「エンドポイントを手動で管理」を参照してください。

IP ディテクタを使用してエンドポイントを自動的に管理

コアデバイスと同じネットワーク上でクライアントデバイスなど、単純なネットワーク設定がある場合、IP ディテクターコンポーネントをデプロイして次の手順を実行ます。

  • Greengrass コアデバイスのローカルネットワーク接続情報をモニタリングします。この情報には、コアデバイスのネットワークエンドポイントとMQTTブローカーが動作するポートが含まれます。

  • コアデバイスの接続情報を AWS IoT Greengrass クラウドサービスに報告します。

IP ディテクタコンポーネントは、手動で設定するエンドポイントを上書きします。

重要

コアデバイスの AWS IoT ポリシーは、IP ディテクターコンポーネントを使用するアクセスgreengrass:UpdateConnectivityInfo許可を許可する必要があります。詳細については、「データプレーンオペレーションの AWS IoT ポリシー」および「AWS IoTモノポリシーを設定する」を参照してください。

IP ディテクターコンポーネントをデプロイするため、次のいずれかを行います。

  • コンソールの [Configure discovery] (ディスカバリの設定) ページを使用します。詳細については、「クラウドディスカバリを設定する (コンソール)」を参照してください。

  • IP ディテクタを含めるようにデプロイを作成と改訂します。コンソール、、または AWS API を使用して AWS CLIデプロイを管理できます。詳細については、「デプロイの作成」を参照してください。

  1. AWS IoT Greengrass コンソールのナビゲーションメニューで、[Components] (コンポーネント) を選択します。

  2. [Components] (コンポーネント) ページで、[Public components] (公開コンポーネント) タブを選択し、次に aws.greengrass.clientdevices.IPDetector を選択します。

  3. aws.greengrass.clientdevices.IPDetector ページで、[Deploy] (デプロイ) を選択します。

  4. [Add to deployment] (デプロイに追加) で、改訂する既存のデプロイを選択するか、新しいデプロイを作成することを選択して、[Next] (次へ) を選択します。

  5. 新しいデプロイの作成を選択した場合、デプロイのターゲットコアデバイスまたはモノグループを選択します。リポジトリの [Specify target] (ターゲットを指定) ページの、[Deployment target] (ターゲットのデプロイ) で、コアデバイスまたはモノグループを選択し、[Next] (次へ) を選択します。

  6. [Select components] (コンポーネントを選択) ページで、aws.greengrass.clientdevices.IPDetector コンポーネントが選択されていることを確認し、[Next] (次) を選択します。

  7. [Configure components] (コンポーネントを設定) ページで、aws.greengrass.clientdevices.IPDetector を選択したら、次の操作を行います。

    1. [Configure component] (コンポーネントを設定) を選択します。

    2. 「設定aws.greengrass.clientdevices.IPDetectorモーダル」の「設定の更新」の「 をマージする設定」で、設定の更新を入力して IP ディテクターコンポーネントを設定できます。次の設定オプションのいずれかを指定できます。

      • defaultPort(オプション) このコンポーネントが IP アドレスを検出したときにレポートするMQTTブローカーポート。デフォルトのポート 8883 とは異なるポートを使用するようにMQTTブローカーを設定する場合は、このパラメータを指定する必要があります。

      • includeIPv4LoopbackAddrs(オプション) このオプションを有効にして、IPv4ループバックアドレスを検出してレポートできます。これらは、localhost など、IP アドレスであり、デバイスが自身と通信できる場所です。このオプションは、コアデバイスとクライアントデバイスを同じシステムで実行するテスト環境で使用します。

      • includeIPv4LinkLocalAddrs(オプション) このオプションを有効にして、IPv4リンクローカルアドレス を検出してレポートできます。このオプションは、コアデバイスのネットワークに Dynamic Host Configuration Protocol (DHCP) または静的に割り当てられた IP アドレスがない場合に使用します。

      • includeIPv6LoopbackAddrs(オプション) このオプションを有効にして、IPv6ループバックアドレスを検出してレポートできます。これらは、localhost など、IP アドレスであり、デバイスが自身と通信できる場所です。このオプションは、コアデバイスとクライアントデバイスを同じシステムで実行するテスト環境で使用します。このオプションを使用するにはincludeIPv4Addrs、 を に設定falsetrueincludeIPv6Addrsを に設定する必要があります。このオプションを使用するには、IP ディテクター v2.2.0 以降が必要です。

      • includeIPv6LinkLocalAddrs(オプション) このオプションを有効にして、IPv6リンクローカルアドレス を検出してレポートできます。このオプションは、コアデバイスのネットワークに Dynamic Host Configuration Protocol (DHCP) または静的に割り当てられた IP アドレスがない場合に使用します。このオプションを使用するにはincludeIPv4Addrs、 を に設定falsetrueincludeIPv6Addrsを に設定する必要があります。このオプションを使用するには、IP ディテクター v2.2.0 以降が必要です。

      • includeIPv4Addrs(オプション) デフォルトは true に設定されています。このオプションを有効にすると、コアデバイスにあるIPv4アドレスを発行できます。このオプションを使用するには、IP ディテクター v2.2.0 以降が必要です。

      • includeIPv6Addrs(オプション) このオプションを有効にして、コアデバイスにあるIPv6アドレスを発行できます。このオプションを使用するにはfalseincludeIPv4Addrsに設定します。このオプションを使用するには、IP ディテクター v2.2.0 以降が必要です。

      設定更新は、次の例のようになることがあります。

      { "defaultPort": "8883", "includeIPv4LoopbackAddrs": false, "includeIPv4LinkLocalAddrs": false }
    3. [Confirm] (確認) を選択してモーダルを閉じ、次に [Next] (次) を選択します。

  8. [Configure advanced settings] (詳細設定) ページはデフォルト設定のままにし、[Next] (次へ) を選択します。

  9. [Review] ページで、[デプロイ] を選択します。

    デプロイに最大 1 分かかる場合があります。

IP ディテクタコンポーネントをデプロイするには、components オブジェクトに aws.greengrass.clientdevices.IPDetector を含むデプロイドキュメントを作成してコンポーネントの設定更新を指定します。デプロイの作成 の指示に従って、新しいデプロイを作成または既存のデプロイを改訂します。

デプロイドキュメントの作成時に IP ディテクタコンポーネントを設定するため、次のオプションのいずれかを指定できます。

  • defaultPort(オプション) このコンポーネントが IP アドレスを検出したときにレポートするMQTTブローカーポート。デフォルトのポート 8883 とは異なるポートを使用するようにMQTTブローカーを設定する場合は、このパラメータを指定する必要があります。

  • includeIPv4LoopbackAddrs(オプション) このオプションを有効にして、IPv4ループバックアドレスを検出してレポートできます。これらは、localhost など、IP アドレスであり、デバイスが自身と通信できる場所です。このオプションは、コアデバイスとクライアントデバイスを同じシステムで実行するテスト環境で使用します。

  • includeIPv4LinkLocalAddrs(オプション) このオプションを有効にして、IPv4リンクローカルアドレス を検出してレポートできます。このオプションは、コアデバイスのネットワークに Dynamic Host Configuration Protocol (DHCP) または静的に割り当てられた IP アドレスがない場合に使用します。

  • includeIPv6LoopbackAddrs(オプション) このオプションを有効にして、IPv6ループバックアドレスを検出してレポートできます。これらは、localhost など、IP アドレスであり、デバイスが自身と通信できる場所です。このオプションは、コアデバイスとクライアントデバイスを同じシステムで実行するテスト環境で使用します。このオプションを使用するにはincludeIPv4Addrs、 を に設定falsetrueincludeIPv6Addrsを に設定する必要があります。このオプションを使用するには、IP ディテクター v2.2.0 以降が必要です。

  • includeIPv6LinkLocalAddrs(オプション) このオプションを有効にして、IPv6リンクローカルアドレス を検出してレポートできます。このオプションは、コアデバイスのネットワークに Dynamic Host Configuration Protocol (DHCP) または静的に割り当てられた IP アドレスがない場合に使用します。このオプションを使用するにはincludeIPv4Addrs、 を に設定falsetrueincludeIPv6Addrsを に設定する必要があります。このオプションを使用するには、IP ディテクター v2.2.0 以降が必要です。

  • includeIPv4Addrs(オプション) デフォルトは true に設定されています。このオプションを有効にすると、コアデバイスにあるIPv4アドレスを発行できます。このオプションを使用するには、IP ディテクター v2.2.0 以降が必要です。

  • includeIPv6Addrs(オプション) このオプションを有効にして、コアデバイスにあるIPv6アドレスを発行できます。このオプションを使用するにはfalseincludeIPv4Addrsに設定します。このオプションを使用するには、IP ディテクター v2.2.0 以降が必要です。

次の部分デプロイドキュメントの例では、ポート 8883 をMQTTブローカーポートとしてレポートするように指定しています。

{ ..., "components": { ..., "aws.greengrass.clientdevices.IPDetector": { "componentVersion": "2.1.1", "configurationUpdate": { "merge": "{\"defaultPort\":\"8883\",}" } } } }

エンドポイントを手動で管理

コアデバイスのMQTTブローカーエンドポイントを手動で管理できます。

各MQTTブローカーエンドポイントには、次の情報があります。

[Endpoint] (エンドポイント) (HostAddress)

クライアントデバイスがコアデバイスのMQTTブローカーに接続できる IP DNS アドレス。

ポート (PortNumber)

MQTT ブローカーがコアデバイスで動作するポート。

このポートは、デフォルトでポート 8883 を使用する Moquette MQTTブローカーコンポーネント で設定できます。

[Metadata] (メタデータ) (Metadata)

このエンドポイントに接続するクライアントデバイスに提供する追加のメタデータ。

エンドポイントの管理 (コンソール)

AWS IoT Greengrass コンソールを使用して、コアデバイスのエンドポイントを表示、更新、削除できます。

コアデバイス (コンソール) のエンドポイントを管理するには
  1. [Core devices] (コアデバイス) を選択します。

  2. 管理するコアデバイスを選択します。

  3. コアデバイスの詳細ページで、[Client devices] (クライアントデバイス) タブを選択します。

  4. MQTT ブローカーエンドポイントセクションには、コアデバイスのMQTTブローカーエンドポイントが表示されます。[Manage endpoints] (エンドポイント管理) を選択します。

  5. エンドポイントの管理モーダルで、コアデバイスのMQTTブローカーエンドポイントを追加または削除します。

  6. [Update] (更新) を選択します。

エンドポイント (AWS CLI) を管理します。

AWS Command Line Interface (AWS CLI) を使用して、コアデバイスのエンドポイントを管理できます。

注記

のクライアントデバイスサポート AWS IoT Greengrass V2 は と下位互換性があるため AWS IoT Greengrass V1、 AWS IoT Greengrass V2 または AWS IoT Greengrass V1 API オペレーションを使用してコアデバイスエンドポイントを管理できます。

コアデバイス (AWS CLI) のエンドポイントを取得するには
コアデバイス (AWS CLI) のエンドポイントを更新するには

エンドポイント (API) を管理します。

を使用して、 AWS APIコアデバイスのエンドポイントを管理できます。

注記

のクライアントデバイスサポート AWS IoT Greengrass V2 は と下位互換性があるため AWS IoT Greengrass V1、 AWS IoT Greengrass V2 または AWS IoT Greengrass V1 API オペレーションを使用してコアデバイスエンドポイントを管理できます。

コアデバイスのエンドポイントを取得するには (AWS API)
コアデバイスのエンドポイントを更新するには (AWS API)