翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # コアデバイスのエンドポイントを管理 クラウドディスカバリを使用するとき、コアデバイスの MQTT ブローカエンドポイントを AWS IoT Greengrass クラウドサービスに保存します。クライアントデバイスは に接続 AWS IoT Greengrass して、関連するコアデバイスのこれらのエンドポイントとその他の情報を取得します。 各コアデバイスに、エンドポイントを自動または手動で管理できます。 + **IP ディテクタでエンドポイントを自動的に管理** クライアントデバイスがコアデバイスと同じネットワーク上の場所など、複雑ではないネットワーク設定を行っている場合、[IP 検知コンポーネント](ip-detector-component.md)をデプロイして、ユーザーに代わってコアデバイスエンドポイントを自動的に管理できます。例えば、コアデバイスが、MQTT ブローカーポートをコアデバイスに転送するルータの背後にある場合、IP ディテクタコンポーネントを使用できません。 IP ディテクタコンポーネントは、モノグループにあるすべてのコアデバイスのエンドポイントを管理するため、モノグループに展開する場合にも役立ちます。詳細については、「[IP ディテクタを使用してエンドポイントを自動的に管理](#use-ip-detector)」を参照してください。 + **エンドポイントを手動で管理** IP ディテクタコンポーネントを使用できない場合、コアデバイスエンドポイントを手動で管理する必要があります。コンソールまたは API でこれらのエンドポイントを更新できます。詳細については、「[エンドポイントを手動で管理](#manually-manage-endpoints)」を参照してください。 **Topics** + [IP ディテクタを使用してエンドポイントを自動的に管理](#use-ip-detector) + [エンドポイントを手動で管理](#manually-manage-endpoints) ## IP ディテクタを使用してエンドポイントを自動的に管理 コアデバイスと同じネットワーク上でクライアントデバイスなど、単純なネットワーク設定がある場合、[IP ディテクターコンポーネント](ip-detector-component.md)をデプロイして次の手順を実行ます。 + Greengrass コアデバイスのローカルネットワーク接続情報をモニタリングします。この情報には、コアデバイスのネットワークエンドポイントと MQTT ブローカーが動作するポートが含まれます。 + コアデバイスの接続情報を AWS IoT Greengrass クラウドサービスに報告します。 IP ディテクタコンポーネントは、手動で設定するエンドポイントを上書きします。 **重要** コアデバイスの AWS IoT ポリシーでは、IP ディテクターコンポーネントを使用するアクセス`greengrass:UpdateConnectivityInfo`許可を に許可する必要があります。詳細については、「[AWS IoT データプレーンオペレーションの ポリシー](device-auth.md#iot-policies)」および「[AWS IoT モノのポリシーを設定する](connect-client-devices.md#configure-iot-policy-requirement)」を参照してください。 IP ディテクターコンポーネントをデプロイするため、次のいずれかを行います。 + コンソールの **[Configure discovery]** (ディスカバリの設定) ページを使用します。詳細については、「[クラウドディスカバリを設定する (コンソール)](connect-client-devices.md#configure-cloud-discovery-console)」を参照してください。 + IP ディテクタを含めるようにデプロイを作成と改訂します。コンソール、 AWS CLI、または AWS API を使用してデプロイを管理できます。詳細については、「[デプロイの作成](create-deployments.md)」を参照してください。 ### IP ディテクタコンポーネントをデプロイ (コンソール) 1. [AWS IoT Greengrass コンソール](https://console.aws.amazon.com/greengrass)のナビゲーションメニューで、**[Components]** (コンポーネント) を選択します。 1. **[Components]** (コンポーネント) ページで、**[Public components]** (公開コンポーネント) タブを選択し、次に **aws.greengrass.clientdevices.IPDetector** を選択します。 1. **aws.greengrass.clientdevices.IPDetector** ページで、**[Deploy]** (デプロイ) を選択します。 1. **[Add to deployment]** (デプロイに追加) で、改訂する既存のデプロイを選択するか、新しいデプロイを作成することを選択して、**[Next]** (次へ) を選択します。 1. 新しいデプロイの作成を選択した場合、デプロイのターゲットコアデバイスまたはモノグループを選択します。リポジトリの **[Specify target]** (ターゲットを指定) ページの、**[Deployment target]** (ターゲットのデプロイ) で、コアデバイスまたはモノグループを選択し、**[Next]** (次へ) を選択します。 1. **[Select components]** (コンポーネントを選択) ページで、**aws.greengrass.clientdevices.IPDetector** コンポーネントが選択されていることを確認し、**[Next]** (次) を選択します。 1. **[Configure components]** (コンポーネントを設定) ページで、**aws.greengrass.clientdevices.IPDetector** を選択したら、次の操作を行います。 1. **[Configure component]** (コンポーネントを設定) を選択します。 1. **[aws.greengrass.clientdevices.IPDetector を設定]** モーダルで、**[マージする設定]** の **[設定の更新]** 内に、設定更新を入力して IP ディテクタコンポーネントを設定できます。次の設定オプションのいずれかを指定できます。 + `defaultPort` - (オプション) このコンポーネントが IP アドレスを検出するときに報告する MQTT ブローカーポート。デフォルトポート 8883 とは異なるポートを使用するように MQTT ブローカーを設定する場合、このパラメータを指定する必要があります。 + `includeIPv4LoopbackAddrs` - (オプション) このオプションを有効にして IPv4 ループバックアドレスを検出して報告します。これらは、`localhost` など、IP アドレスであり、デバイスが自身と通信できる場所です。このオプションは、コアデバイスとクライアントデバイスを同じシステムで実行するテスト環境で使用します。 + `includeIPv4LinkLocalAddrs` - (オプション) このオプションを有効にして IPv4 [リンクローカルアドレス](https://en.wikipedia.org/wiki/Link-local_address)を検出して報告します。このオプションは、コアデバイスのネットワークに Dynamic Host Configuration Protocol (DHCP) または静的に割り当てられた IP アドレスがない場合に使用します。 + `includeIPv6LoopbackAddrs` - (オプション) このオプションを有効にして IPv6 ループバックアドレスを検出して報告します。これらは、`localhost` など、IP アドレスであり、デバイスが自身と通信できる場所です。このオプションは、コアデバイスとクライアントデバイスを同じシステムで実行するテスト環境で使用します。このオプションを使用するには、`includeIPv4Addrs` を `false` に設定し、`includeIPv6Addrs` を `true` に設定する必要があります。このオプションを使用するには、IP ディテクター v2.2.0 以降が必要です。 + `includeIPv6LinkLocalAddrs` - (オプション) このオプションを有効にして IPv6 [リンクローカルアドレス](https://en.wikipedia.org/wiki/Link-local_address)を検出して報告します。このオプションは、コアデバイスのネットワークに Dynamic Host Configuration Protocol (DHCP) または静的に割り当てられた IP アドレスがない場合に使用します。このオプションを使用するには、`includeIPv4Addrs` を `false` に設定し、`includeIPv6Addrs` を `true` に設定する必要があります。このオプションを使用するには、IP ディテクター v2.2.0 以降が必要です。 + `includeIPv4Addrs` – (オプション) デフォルトは True に設定されています。このオプションを有効にして、コアデバイスにある IPv4 アドレスを発行できます。このオプションを使用するには、IP ディテクター v2.2.0 以降が必要です。 + `includeIPv6Addrs` – (オプション) このオプションを有効にして、コアデバイスにある IPv6 アドレスを発行できます。このオプションを使用するには、`includeIPv4Addrs` を `false` に設定します。このオプションを使用するには、IP ディテクター v2.2.0 以降が必要です。 設定更新は、次の例のようになることがあります。 ``` { "defaultPort": "8883", "includeIPv4LoopbackAddrs": false, "includeIPv4LinkLocalAddrs": false } ``` 1. **[Confirm]** (確認) を選択してモーダルを閉じ、次に **[Next]** (次) を選択します。 1. **[Configure advanced settings]** (詳細設定) ページはデフォルト設定のままにし、**[Next]** (次へ) を選択します。 1. [**Review**] ページで、[**デプロイ**] を選択します。 デプロイに最大 1 分かかる場合があります。 ### IP ディテクタコンポーネント (AWS CLI) の展開 IP ディテクタコンポーネントをデプロイするには、`components` オブジェクトに `aws.greengrass.clientdevices.IPDetector` を含むデプロイドキュメントを作成してコンポーネントの設定更新を指定します。[デプロイの作成](create-deployments.md) の指示に従って、新しいデプロイを作成または既存のデプロイを改訂します。 デプロイドキュメントの作成時に IP ディテクタコンポーネントを設定するため、次のオプションのいずれかを指定できます。 + `defaultPort` - (オプション) このコンポーネントが IP アドレスを検出するときに報告する MQTT ブローカーポート。デフォルトポート 8883 とは異なるポートを使用するように MQTT ブローカーを設定する場合、このパラメータを指定する必要があります。 + `includeIPv4LoopbackAddrs` - (オプション) このオプションを有効にして IPv4 ループバックアドレスを検出して報告します。これらは、`localhost` など、IP アドレスであり、デバイスが自身と通信できる場所です。このオプションは、コアデバイスとクライアントデバイスを同じシステムで実行するテスト環境で使用します。 + `includeIPv4LinkLocalAddrs` - (オプション) このオプションを有効にして IPv4 [リンクローカルアドレス](https://en.wikipedia.org/wiki/Link-local_address)を検出して報告します。このオプションは、コアデバイスのネットワークに Dynamic Host Configuration Protocol (DHCP) または静的に割り当てられた IP アドレスがない場合に使用します。 + `includeIPv6LoopbackAddrs` - (オプション) このオプションを有効にして IPv6 ループバックアドレスを検出して報告します。これらは、`localhost` など、IP アドレスであり、デバイスが自身と通信できる場所です。このオプションは、コアデバイスとクライアントデバイスを同じシステムで実行するテスト環境で使用します。このオプションを使用するには、`includeIPv4Addrs` を `false` に設定し、`includeIPv6Addrs` を `true` に設定する必要があります。このオプションを使用するには、IP ディテクター v2.2.0 以降が必要です。 + `includeIPv6LinkLocalAddrs` - (オプション) このオプションを有効にして IPv6 [リンクローカルアドレス](https://en.wikipedia.org/wiki/Link-local_address)を検出して報告します。このオプションは、コアデバイスのネットワークに Dynamic Host Configuration Protocol (DHCP) または静的に割り当てられた IP アドレスがない場合に使用します。このオプションを使用するには、`includeIPv4Addrs` を `false` に設定し、`includeIPv6Addrs` を `true` に設定する必要があります。このオプションを使用するには、IP ディテクター v2.2.0 以降が必要です。 + `includeIPv4Addrs` – (オプション) デフォルトは True に設定されています。このオプションを有効にして、コアデバイスにある IPv4 アドレスを発行できます。このオプションを使用するには、IP ディテクター v2.2.0 以降が必要です。 + `includeIPv6Addrs` – (オプション) このオプションを有効にして、コアデバイスにある IPv6 アドレスを発行できます。このオプションを使用するには、`includeIPv4Addrs` を `false` に設定します。このオプションを使用するには、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 ブローカーがコアデバイスで動作するポート。 このポートは、[モケット MQTT ブローカーコンポーネント](mqtt-broker-moquette-component.md)に設定でき、デフォルトでポート 8883 が使用されます。 **[Metadata]** (メタデータ) (`Metadata`) このエンドポイントに接続するクライアントデバイスに提供する追加のメタデータ。 **Topics** + [エンドポイントの管理 (コンソール)](#manually-manage-endpoints-console) + [エンドポイント (AWS CLI) を管理します。](#manually-manage-endpoints-cli) + [エンドポイント (API) の管理](#manually-manage-endpoints-api) ### エンドポイントの管理 (コンソール) AWS IoT Greengrass コンソールを使用して、コアデバイスのエンドポイントを表示、更新、削除できます。 **コアデバイス (コンソール) のエンドポイントを管理するには** 1. [AWS IoT Greengrass コンソール](https://console.aws.amazon.com/greengrass)に移動します。 1. **[Core devices]** (コアデバイス) を選択します。 1. 管理するコアデバイスを選択します。 1. コアデバイスの詳細ページで、**[Client devices]** (クライアントデバイス) タブを選択します。 1. **[MQTT broker endpoints]** (MQTT ブローカーエンドポイント) セクションで、コアデバイスの MQTT ブローカーエンドポイントを確認できます。**[Manage endpoints]** (エンドポイント管理) を選択します。 1. **[Manage endpoints]** (エンドポイント管理) モーダルで、コアデバイスの MQTT ブローカーエンドポイントを追加または削除します。 1. **[更新]** を選択します。 ### エンドポイント (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) のエンドポイントを取得するには** + 次のコマンドのいずれかを実行してください: + [greengrassv2: get-connectivity-info](https://docs.aws.amazon.com/cli/latest/reference/greengrassv2/get-connectivity-info.html) + [greengrass: get-connectivity-info](https://docs.aws.amazon.com/cli/latest/reference/greengrass/get-connectivity-info.html) **コアデバイス (AWS CLI) のエンドポイントを更新するには** + 次のコマンドのいずれかを実行してください: + [greengrassv2: update-connectivity-info](https://docs.aws.amazon.com/cli/latest/reference/greengrassv2/update-connectivity-info.html) + [greengrass: update-connectivity-info](https://docs.aws.amazon.com/cli/latest/reference/greengrass/update-connectivity-info.html) ### エンドポイント (API) の管理 AWS API を使用して、コアデバイスのエンドポイントを管理できます。 **注記** のクライアントデバイスサポート AWS IoT Greengrass V2 は と下位互換性があるため AWS IoT Greengrass V1、 AWS IoT Greengrass V2 または AWS IoT Greengrass V1 API オペレーションを使用してコアデバイスエンドポイントを管理できます。 **コアデバイスのエンドポイントを取得するには (AWS API)** + 次の操作のいずれかを実行してください: + [V2: GetConnectivityInfo](https://docs.aws.amazon.com/greengrass/v2/APIReference/API_GetConnectivityInfo.html) + [V1: GetConnectivityInfo](https://docs.aws.amazon.com/greengrass/v1/apireference/getconnectivityinfo-get.html) **コアデバイスのエンドポイントを更新するには (AWS API)** + 次の操作のいずれかを実行してください: + [V2: UpdateConnectivityInfo](https://docs.aws.amazon.com/greengrass/v2/APIReference/API_UpdateConnectivityInfo.html) + [V1: UpdateConnectivityInfo](https://docs.aws.amazon.com/greengrass/v1/apireference/updateconnectivityinfo-put.html)