管理核心设备端点 - Amazon IoT Greengrass
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

管理核心设备端点

当您使用云发现时,将核心设备的 MQTT 代理终端节点存储在Amazon IoT Greengrass云服务。客户端设备连接到Amazon IoT Greengrass为其关联的核心设备检索这些端点和其他信息。

对于每个核心设备,您可以自动或手动管理终端节点。

  • 使用 IP 检测器自动管理端点

    你可以部署IP 检测器组件如果您的网络设置非复杂,例如客户端设备与核心设备在同一网络上的位置,自动为您管理核心设备终端节点。例如,如果核心设备位于将 MQTT Broker 端口转发到核心设备的路由器后面,则不能使用 IP 检测器组件。

    如果部署到事物组,IP 检测器组件也很有用,因为它管理事物组中所有核心设备的终端节点。有关更多信息,请参阅 使用 IP 检测器自动管理终端

  • 手动管理端节点

    如果无法使用 IP 检测器组件,则必须手动管理核心设备终端节点。您可以使用控制台或 API 更新这些终端节点。有关更多信息,请参阅 手动管理端节点

使用 IP 检测器自动管理终端

如果您有简单的网络设置(例如核心设备位于同一网络上的客户端设备),则可以部署IP 检测器组件执行以下操作:

  • 监控 Greengrass 核心设备的本地网络连接信息。这些信息包括核心设备的网络端点和 MQTT 代理运营的端口。

  • 将核心设备的连接信息报告给Amazon IoT Greengrass云服务。

IP 检测器组件将覆盖您手动设置的终端节点。

重要

核心设备Amazon IoT策略必须允许greengrass:UpdateConnectivityInfo使用 IP 检测器组件的权限。有关更多信息,请参阅 数据层面操作的 Amazon IoT 策略配置Amazon IoT事物策略

您可以执行以下任一操作以部署 IP 检测器组件:

  • 使用配置发现控制台中的页面。有关更多信息,请参阅 配置云发现(控制台)

  • 创建和修改部署以包括 IP 检测器。您可以使用控制台,Amazon CLI,或者AmazonAPI 用于管理部署。有关更多信息,请参阅 创建部署

  1. Amazon IoT Greengrass控制台导航菜单,选择组件.

  2. 在存储库的组件页面上,选择公共组件选择选项卡,然后选择aws.greengrass.clientdevices.IPDetector.

  3. 在存储库的aws.greengrass.clientdevices.IPDetector页面上,选择部署.

  4. 添加到部署,选择要修订的现有部署,或者选择创建新部署,然后选择下一步.

  5. 如果选择创建新部署,请选择部署的目标核心设备或事物组。在存储库的指定目标页面,下部署目标,选择核心设备或事物组,然后选择下一步.

  6. 在存储库的选择组件页面中,验证aws.greengrass.clientdevices.IPDetector已选择组件,请选择下一步.

  7. 在存储库的配置组件页面上,选择aws.greengrass.clientdevices.IPDetector中,执行以下操作:

    1. 选择配置组件.

    2. 配置aws.greengrass.clientdevices.IPDetector在下模态配置更新,在要合并的配置,您可以输入配置更新来配置 IP 检测器组件。您可以指定以下任意配置选项:

      • defaultPort(可选)此组件检测到 IP 地址时要报告的 MQTT 代理端口。如果将 MQTT 代理配置为使用与默认端口 8883 不同的端口,则必须指定此参数。

      • includeIPv4LoopbackAddrs(可选)您可以启用此选项来检测和报告 IPv4 环回地址。这些是 IP 地址,例如localhost,设备可以在其中与自己进行通信。在核心设备和客户端设备在同一系统上运行的测试环境中使用此选项。

      • includeIPv4LinkLocalAddrs(可选)您可以启用此选项来检测和报告 IPv4链接本地地址. 如果核心设备的网络没有动态主机配置协议 (DHCP) 或静态分配的 IP 地址,请使用此选项。

      配置更新可能与以下示例类似。

      { "defaultPort": "8883", "includeIPv4LoopbackAddrs": false, "includeIPv4LinkLocalAddrs": false }
    3. 选择请确认要关闭模式,然后选择下一步.

  8. 在存储库的配置高级设置页面上,保留默认配置设置,然后选择下一步.

  9. Review(检查)页上,选择 Deploy(部署)。

    完成部署最多需要一分钟。

要部署 IP 检测器组件,请创建一个部署文档,其中包括aws.greengrass.clientdevices.IPDetector中的components对象,然后指定组件的配置更新。请按照中的说明创建部署以创建新部署或修改现有部署。

在创建部署文档时,可以指定以下任意选项来配置 IP 检测器组件:

  • defaultPort(可选)此组件检测到 IP 地址时要报告的 MQTT 代理端口。如果将 MQTT 代理配置为使用与默认端口 8883 不同的端口,则必须指定此参数。

  • includeIPv4LoopbackAddrs(可选)您可以启用此选项来检测和报告 IPv4 环回地址。这些是 IP 地址,例如localhost,设备可以在其中与自己进行通信。在核心设备和客户端设备在同一系统上运行的测试环境中使用此选项。

  • includeIPv4LinkLocalAddrs(可选)您可以启用此选项来检测和报告 IPv4链接本地地址. 如果核心设备的网络没有动态主机配置协议 (DHCP) 或静态分配的 IP 地址,请使用此选项。

以下示例部署文档指定将端口 8883 报告为 MQTT 代理端口。

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

手动管理端节点

您可以手动管理核心设备的 MQTT 代理终端节点。

每个 MQTT 经纪商终端节点都有以下信息:

端点(HostAddress

客户端设备可以连接到核心设备上的 MQTT 代理的 IP 地址或 DNS 地址。

端口 (PortNumber)

核心设备上 MQTT 代理操作的端口。

您可以在Moquette MQTT 经纪商组件,默认使用端口 8883。

Metadata(Metadata

要提供给连接到此终端节点的客户端设备的其他元数据。

管理终端节点(控制台)

您可以使用Amazon IoT Greengrass控制台以查看、更新和删除核心设备的终端节点。

管理核心设备的终端节点(控制台)

  1. 导航到 Amazon IoT Greengrass 控制台

  2. 选择核心设备.

  3. 选择要管理的核心设备。

  4. 在核心设备的详细信息页面上,选择客户端设备选项卡。

  5. MQTT 代理终端节点部分中,你可以看到核心设备的 MQTT 代理终端节点。选择管理端节点.

  6. 管理端节点模式、添加或删除核心设备的 MQTT 代理终端节点。

  7. 选择 Update(更新)。

管理终端节点 (Amazon CLI)

您可以使用Amazon Command Line Interface(Amazon CLI) 来管理核心设备的终端节点。

注意

因为中的客户端设备支持Amazon IoT Greengrass V2向后兼容Amazon IoT Greengrass V1中,您可以使用Amazon IoT Greengrass V2要么Amazon IoT Greengrass V1API 操作以管理核心设备终端节点。

要获取核心设备的终端节点(Amazon CLI)

更新核心设备的终端节点(Amazon CLI)

管理终端节点 (API)

您可以使用Amazon用于管理核心设备的终端节点的 API。

注意

因为中的客户端设备支持Amazon IoT Greengrass V2向后兼容Amazon IoT Greengrass V1中,您可以使用Amazon IoT Greengrass V2要么Amazon IoT Greengrass V1API 操作以管理核心设备终端节点。

要获取核心设备的终端节点(AmazonAPI)

更新核心设备的终端节点(AmazonAPI)