IP 探测器 - Amazon IoT Greengrass
版本类型操作系统要求依赖项配置本地日志文件更改日志
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

IP 探测器

IP 检测器组件 (aws.greengrass.clientdevices.IPDetector) 执行以下操作：

  • 监控 Greengrass 核心设备的网络连接信息。此信息包括核心设备的网络端点和MQTT代理运行的端口。

  • 更新 Amazon IoT Greengrass 云服务中核心设备的连接信息。

客户设备可以使用 Greengrass 云发现来检索相关核心设备的连接信息。然后，客户端设备可以尝试连接到每台核心设备，直到它们成功连接。

注意

客户端设备是连接到 Greengrass 核心设备以MQTT发送消息和数据进行处理的本地物联网设备。有关更多信息，请参阅 与本地物联网设备互动。

IP 探测器组件将核心设备的现有连接信息替换为其检测到的信息。由于此组件会删除现有信息，因此您可以使用 IP 检测器组件，也可以手动管理连接信息。

版本

此组件有以下版本：

  • 2.2.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

类型

此组件是一个插件组件 (aws.greengrass.plugin)。Greengrass 核心在与核心相同的 Java 虚拟机 () 中运行此组件。JVM当您在核心设备上更改此组件的版本时，nucleus 会重新启动。

该组件使用与 Greengrass 核相同的日志文件。有关更多信息，请参阅 监控Amazon IoT Greengrass日志。

有关更多信息，请参阅 组件类型。

操作系统

此组件可以安装在运行以下操作系统的核心设备上：

  • Linux

  • Windows

要求

此组件具有以下要求：

  • Greengrass 服务角色必须与 Amazon Web Services 账户 您的关联并允许和权限。iot:GetThingShadow iot:UpdateThingShadow

  • 核心设备的 Amazon IoT 策略必须允许该greengrass:UpdateConnectivityInfo权限。有关更多信息，请参阅数据层面操作的 Amazon IoT 策略 和支持客户端设备的最低Amazon IoT政策。

  • 如果将核心设备的MQTT代理组件配置为使用默认端口 8883 以外的端口，则必须使用 IP 检测器 v2.1.0 或更高版本。将其配置为报告代理运行的端口。

  • 如果您的网络设置很复杂，IP 检测器组件可能无法识别客户端设备可以连接到核心设备的端点。如果 IP 检测器组件无法管理端点，则必须改为手动管理核心设备端点。例如，如果核心设备位于将MQTT代理端口转发给它的路由器后面，则必须将该路由器的 IP 地址指定为核心设备的终端节点。有关更多信息，请参阅 管理核心设备端点。

  • 支持 IP 检测器组件在中运行VPC。

依赖项

部署组件时， Amazon IoT Greengrass 还会部署其依赖项的兼容版本。这意味着您必须满足组件及其所有依赖项的要求才能成功部署该组件。本节列出了此组件已发布版本的依赖关系以及定义每个依赖项的组件版本的语义版本限制。您还可以在Amazon IoT Greengrass 控制台中查看组件每个版本的依赖关系。在组件详细信息页面上，查找 “依赖关系” 列表。

2.2.0

下表列出了此组件版本 2.2.0 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.2.0 <2.14.0 软性
2.2.0

下表列出了此组件版本 2.2.0 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.2.0 <2.14.0 软性
2.1.8 – 2.1.9

下表列出了此组件版本 2.1.8 和 2.1.9 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.2.0 <2.13.0 软性
2.1.7

下表列出了此组件版本 2.1.7 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.2.0 <2.12.0 软性
2.1.6

下表列出了此组件版本 2.1.6 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.2.0 <2.11.0 软性
2.1.5

下表列出了此组件版本 2.1.5 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.2.0 <2.10.0 软性
2.1.4

下表列出了此组件版本 2.1.4 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.2.0 <2.9.0 软性
2.1.3

下表列出了此组件版本 2.1.3 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.2.0 <2.8.0 软性
2.1.2

下表列出了此组件版本 2.1.2 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.2.0 <2.7.0 软性
2.1.1

下表列出了此组件版本 2.1.1 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.2.0 <2.6.0 软性
2.1.0 and 2.0.2

下表列出了此组件版本 2.1.0 和 2.0.2 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.2.0 <2.5.0 软性
2.0.1

下表列出了此组件版本 2.0.1 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.2.0 <2.4.0 软性
2.0.0

下表列出了此组件版本 2.0.0 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass 核 >=2.2.0 <2.3.0 软性

有关组件依赖关系的更多信息，请参阅组件配方参考。

配置

此组件提供以下配置参数，您可以在部署该组件时对其进行自定义。

2.2.x
defaultPort

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

默认：8883

includeIPv4LoopbackAddrs

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

默认：false

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

默认：false

includeIPv6LoopbackAddrs

（可选）您可以启用此选项来检测和报告IPv6环回地址。这些是 IP 地址，例如localhost，设备可以与自己通信的地方。在核心设备和客户端设备在同一系统上运行的测试环境中使用此选项。必须将设置includeIPv4Addrs为false和设置includeIPv6Addrs为true才能使用此选项。

默认：false

（可选）您可以启用此选项来检测和报告IPv6链路本地地址。如果核心设备的网络没有动态主机配置协议 (DHCP) 或静态分配的 IP 地址，则使用此选项。必须将设置includeIPv4Addrs为false和设置includeIPv6Addrs为true才能使用此选项。

默认：false

includeIPv4Addrs

（可选）默认值设置为true。您可以启用此选项来发布在核心设备上找到IPv4的地址。

默认：true

includeIPv6Addrs

（可选）您可以启用此选项来发布在核心设备上找到IPv6的地址。设置includeIPv4Addrs为false可使用此选项。

默认：false

2.1.x
defaultPort

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

默认：8883

includeIPv4LoopbackAddrs

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

默认：false

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

默认：false

2.0.x
includeIPv4LoopbackAddrs

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

默认：false

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

默认：false

本地日志文件

该组件使用与 Greengrass nucleus 组件相同的日志文件。

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
查看此组件的日志

  • 在核心设备上运行以下命令以实时查看此组件的日志文件。替换/greengrass/v2或 C:\greengrass\v2 包含 Amazon IoT Greengrass 根文件夹的路径。

    Linux
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait

更改日志

下表描述了该组件的每个版本中的更改。

版本

更改

2.2.0

Greengrass nucleus 版本 2.13.0 版本的版本已更新。

新功能

  • 增加了对IPv6的支持。现在，您可以使用IPv6进行本地消息传递。

2.1.9
错误修复和改进

  • 将获取的 IP 步骤调整为仅发送调试日志级别的日志。

2.1.8

 Greengrass nucleus 版本 2.12.0 版本的版本已更新。

2.1.7

 Greengrass nucleus 版本 2.11.0 版本的版本已更新。

2.1.6

 Greengrass nucleus 版本 2.10.0 版本的版本已更新。

2.1.5

 Greengrass nucleus 版本 2.9.0 版本的版本已更新。

2.1.4

 Greengrass nucleus 版本 2.8.0 版本的版本已更新。

2.1.3

Greengrass nucleus 版本 2.7.0 版本的版本已更新。

2.1.2
错误修复和改进

  • 改进了此组件在某些情况下记录的错误消息。

  • Greengrass nucleus 版本 2.6.0 版本的版本已更新。

2.1.1

Greengrass nucleus 版本 2.5.0 版本的版本已更新。

2.1.0
改进

  • 添加defaultPort参数，使您能够使用非默认MQTT代理端口。

  • 更新以使日志消息更加清晰。

2.0.2

Greengrass nucleus 版本 2.4.0 版本的版本已更新。

2.0.1

Greengrass nucleus 版本 2.3.0 版本的版本已更新。

2.0.0

初始版本。