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

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

クラウドディスカバリを使用するとき、コアデバイスの 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 CLI、AWS API を使用してデプロイ管理できます。詳細については、「デプロイの作成」を参照してください。

AWS IoT Greengrass コンソールのナビゲーションメニューで、[Components] (コンポーネント) を選択します。
[Components] (コンポーネント) ページで、[Public components] (公開コンポーネント) タブを選択し、次に aws.greengrass.clientdevices.IPDetector を選択します。
aws.greengrass.clientdevices.IPDetector ページで、[Deploy] (デプロイ) を選択します。
[Add to deployment] (デプロイに追加) で、改訂する既存のデプロイを選択するか、新しいデプロイを作成することを選択して、[Next] (次へ) を選択します。
新しいデプロイの作成を選択した場合、デプロイのターゲットコアデバイスまたはモノグループを選択します。リポジトリの [Specify target] (ターゲットを指定) ページの、[Deployment target] (ターゲットのデプロイ) で、コアデバイスまたはモノグループを選択し、[Next] (次へ) を選択します。
[Select components] (コンポーネントを選択) ページで、aws.greengrass.clientdevices.IPDetector コンポーネントが選択されていることを確認し、[Next] (次) を選択します。
[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 アドレスがない場合に使用します。
  設定更新は、次の例のようになることがあります。
```
{
  "defaultPort": "8883",
  "includeIPv4LoopbackAddrs": false,
  "includeIPv4LinkLocalAddrs": false
}
```
3. [Confirm] (確認) を選択してモーダルを閉じ、次に [Next] (次) を選択します。
[Configure advanced settings] (詳細設定) ページはデフォルト設定のままにし、[Next] (次へ) を選択します。
[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 アドレスがない場合に使用します。

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


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

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

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

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

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

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

ポート (PortNumber)

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

このポートは、モケット MQTT ブローカーコンポーネントに設定でき、デフォルトでポート 8883 が使用されます。

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

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

トピック

エンドポイントの管理 (コンソール)
エンドポイント (AWS CLI) を管理します。
エンドポイント (API) の管理

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

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

コアデバイス (コンソール) のエンドポイントを管理するには

AWS IoT Greengrass コンソールに移動します。
[Core devices] (コアデバイス) を選択します。
管理するコアデバイスを選択します。
コアデバイスの詳細ページで、[Client devices] (クライアントデバイス) タブを選択します。
[MQTT broker endpoints] (MQTT ブローカーエンドポイント) セクションで、コアデバイスの MQTT ブローカーエンドポイントを確認できます。[Manage endpoints] (エンドポイント管理) を選択します。
[Manage endpoints] (エンドポイント管理) モーダルで、コアデバイスの MQTT ブローカーエンドポイントを追加または削除します。
[更新] を選択します。

エンドポイント (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 操作を使用してコアデバイスのエンドポイントを管理できます。