IPv6用于本地消息传递 - AWS IoT Greengrass
配置要使用的 IP 检测器 IPv6

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

IPv6用于本地消息传递

您可以配置 IP 检测器组件IPv6以用于发送本地消息。

注意

必须有 IP 检测器 v2.2.0 或更高版本IPv6才能用于发送本地消息。

您可以部署 IP 检测器组件来检测和使用IPv6地址。您必须更新 IP 检测器组件的配置才能IPv6代替IPv4。有关更多信息，请参阅 使用 IP 探测器自动管理端点。

配置要使用的 IP 检测器 IPv6

如果您的网络设置很简单，例如客户端设备与核心设备位于同一网络上，则可以部署 IP 检测器组件以IPv6用于本地消息传递。

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

重要

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

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

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

  • 创建和修改部署以包含 IP 检测器。您可以使用控制台 AWS CLI、或 AWS API来管理部署。有关更多信息，请参阅 创建部署。

  1. 在AWS 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 检测器组件。您可以指定以下任一配置选项。将 includeIPv4Addrs 设置为 false，将 includeIPv6Addrs 设置为 true。然后，您可以更新其他IPv6配置选项。

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

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

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

      • includeIPv6LoopbackAddrs—（可选）您可以启用此选项来检测和报告IPv6环回地址。这些是 IP 地址，例如localhost，设备可以与自己通信的地方。在核心设备和客户端设备在同一系统上运行的测试环境中使用此选项。必须将设置includeIPv4Addrs为false和设置includeIPv6Addrstrue才能使用此选项。必须有 IP 探测器 v2.2.0 或更高版本才能使用此选项。

      • includeIPv6LinkLocalAddrs—（可选）您可以启用此选项来检测和报告IPv6链接本地地址。如果核心设备的网络没有动态主机配置协议 (DHCP) 或静态分配的 IP 地址，则使用此选项。必须将设置includeIPv4Addrs为false和设置includeIPv6Addrstrue才能使用此选项。必须有 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,
  "includeIPv6LoopbackAddrs": true,
  "includeIPv6LinkLocalAddrs": true,
  "includeIPv4Addrs": false,
  "includeIPv6Addrs": true
}

    3. 选择 “确认” 关闭模式，然后选择 “下一步”。

  8. 在配置高级设置页面上，保留默认配置设置，然后选择下一步。

  9. 在 检查 页上，选择 部署。

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

要部署 IP 检测器组件，请创建包含aws.greengrass.clientdevices.IPDetector在components对象中的部署文档，并指定该组件的配置更新。按照中的创建部署说明创建新部署或修改现有部署。

在创建部署文档时，您可以指定以下任一选项来配置 IP 检测器组件：

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

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

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

  • includeIPv6LoopbackAddrs—（可选）您可以启用此选项来检测和报告IPv6环回地址。这些是 IP 地址，例如localhost，设备可以与自己通信的地方。在核心设备和客户端设备在同一系统上运行的测试环境中使用此选项。必须将设置includeIPv4Addrs为false和设置includeIPv6Addrstrue才能使用此选项。必须有 IP 探测器 v2.2.0 或更高版本才能使用此选项。

  • includeIPv6LinkLocalAddrs—（可选）您可以启用此选项来检测和报告IPv6链接本地地址。如果核心设备的网络没有动态主机配置协议 (DHCP) 或静态分配的 IP 地址，则使用此选项。必须将设置includeIPv4Addrs为false和设置includeIPv6Addrstrue才能使用此选项。必须有 IP 探测器 v2.2.0 或更高版本才能使用此选项。

  • includeIPv4Addrs—（可选）默认值设置为 true。您可以启用此选项来发布在核心设备上找到IPv4的地址。必须有 IP 探测器 v2.2.0 或更高版本才能使用此选项。

  • includeIPv6Addrs—（可选）您可以启用此选项以发布在核心设备上找到IPv6的地址。设置includeIPv4Addrs为false可使用此选项。必须有 IP 探测器 v2.2.0 或更高版本才能使用此选项。

以下示例部分部署文档指定要使用IPv6。

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