本地调试控制台 - Amazon IoT Greengrass
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

本地调试控制台

本地调试控制台组件 (aws.greengrass.LocalDebugConsole) 提供了一个本地控制面板,其中显示有关您的Amazon IoT Greengrass核心设备及其组件。您可以使用此仪表板调试核心设备和管理本地组件。

重要

我们建议您只在开发环境中使用此组件,而不要在生产环境中使用。通过此组件,您可以访问在生产环境中通常不需要的信息和操作。遵循最低特权原则,只在您需要的核心设备上部署此组件。

版本

此组件具有以下版本:

  • 2.2.x

  • 2.1.x

  • 2.0.x

类型

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

该组件使用与Greengrass 核相同的日志文件。有关更多信息,请参阅 显示器Amazon IoT Greengrass圆木

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

操作系统

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

  • Linux

  • Windows

要求

此组件具有以下要求:

  • 您可以使用用户名和密码来登录控制面板。用户名,即debug,,是为你提供的。您必须使用Amazon IoT GreengrassCLI 创建临时密码,用于在核心设备上使用仪表板对您进行身份验证。您必须能够使用Amazon IoT Greengrass使用本地调试控制台的 CLI。有关更多信息,请参阅 。Greengrass CLI 要求. 有关如何生成密码和登录的更多信息,请参阅本地调试控制台组件用法.

附属物

部署组件时,Amazon IoT Greengrass还部署了其依赖项的兼容版本。这意味着您必须满足组件及其所有依赖项的要求才能成功部署该组件。本部分列出了的依赖项发布版本以及定义每个依赖项的组件版本的语义版本约束。您也可以在组件的每个版本中查看组件的依赖项Amazon IoT Greengrass控制台. 在组件详细信息页面上,查找依赖项list.

2.2.5

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

依赖关系 兼容的版本版本 依赖关系类型
Greengrass >=2.1.0 硬性
Greengrass >=2.1.0 硬性
2.2.4

下表列出了此组件版本 2.2.2.4 的依赖项。

依赖关系 兼容的版本版本 依赖关系类型
Greengrass >=2.1.0 硬性
Greengrass >=2.1.0 硬性
2.2.3

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

依赖关系 兼容的版本版本 依赖关系类型
Greengrass >=2.1.0 硬性
Greengrass >=2.1.0 硬性
2.2.2

下表列出了此组件版本 2.2.2.2 的依赖项。

依赖关系 兼容的版本版本 依赖关系类型
Greengrass >=2.1.0 硬性
Greengrass >=2.1.0 硬性
2.2.1

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

依赖关系 兼容的版本版本 依赖关系类型
Greengrass >=2.1.0 硬性
Greengrass >=2.1.0 硬性
2.2.0

下表列出了此组件版本 2.2.2.2.0 的依赖项。

依赖关系 兼容的版本版本 依赖关系类型
Greengrass >=2.1.0 硬性
Greengrass >=2.1.0 硬性
2.1.0

下表列出了此组件版本 2.1.0 的依赖项。

依赖关系 兼容的版本版本 依赖关系类型
Greengrass >=2.1.0 硬性
Greengrass >=2.1.0 硬性
2.0.x

下表列出了此组件 2.0.x 版的依赖关系。

依赖关系 兼容的版本版本 依赖关系类型
Greengrass >=2.0.3 软性
Greengrass >=2.0.3 软性

有关组件依赖项的更多信息,请参阅组件配方参考.

配置

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

v2.1.x - v2.2.x
httpsEnabled

(可选)您可以为本地调试控制台启用 HTTPS 通信。如果您启用 HTTTPS 通信,则本地调试控制台将创建自签名证书。Web 浏览器会针对使用自签名证书的 Web 站点显示安全警告,因此您必须手动验证证书。然后,你可以绕过警告。有关更多信息,请参阅用量

默认值:true

port

(可选)提供本地调试控制台的端口。

默认值:1441

websocketPort

(可选)用于本地调试控制台的 websocket 端口。

默认值:1442

bindHostname

(可选)用于本地调试控制台的主机名。

如果您运行Amazon IoT GreengrassDocker 容器中的核心软件,,将该参数设置为0.0.0.0,这样你就可以在 Docker 容器之外打开本地调试控制台。

默认值:localhost

例如:配置合并更新

以下示例配置指定在非默认端口上打开本地调试控制台并禁用 HTTPS。

{ "httpsEnabled": false, "port": "10441", "websocketPort": "10442" }
v2.0.x
port

(可选)提供本地调试控制台的端口。

默认值:1441

websocketPort

(可选)用于本地调试控制台的 websocket 端口。

默认值:1442

bindHostname

(可选)用于本地调试控制台的主机名。

如果您运行Amazon IoT GreengrassDocker 容器中的核心软件,,将该参数设置为0.0.0.0,这样你就可以在 Docker 容器之外打开本地调试控制台。

默认值:localhost

例如:配置合并更新

以下示例配置指定在非默认端口上打开本地调试控制台。

{ "port": "10441", "websocketPort": "10442" }

用量

要使用本地调试控制台,请从 Greengrass CLI 创建一个会话。创建会话时,Greengrass CLI 会提供用户名和临时密码,您可以使用这些用户名和临时密码登录到本地调试控制台。

按照以下说明在核心设备或开发计算机上打开本地调试控制台。

v2.1.x - v2.2.x

在版本 2.1.0 及更高版本中,本地调试控制台默认使用 HTTPTPS。启用 HTTPS 后,本地调试控制台将创建自签名证书来确保连接。由于此自签名证书,当您打开本地调试控制台时,Web 浏览器会显示安全警告。使用 Greengrass CLI 创建会话时,输出包含证书的指纹,因此您可以验证证书是否合法以及连接是否安全。

您可以禁用 HTTPS。有关更多信息,请参阅 。本地调试控制台配置.

打开本地调试控制台

  1. (可选)要在开发计算机上查看本地调试控制台,可以通过 SSH 转发控制台的端口。但您必须先启用AllowTcpForwarding选项位于核心设备的 SSH 配置文件中。默认情况下,此选项处于启用状态。在开发计算机上运行以下命令,查看控制面板localhost:1441在开发计算机上。

    ssh -L 1441:localhost:1441 -L 1442:localhost:1442 username@core-device-ip-address
    注意

    您可以更改默认端口14411442. 有关更多信息,请参阅 。本地调试控制台配置.

  2. 创建会话以使用本地调试控制台。创建会话时,会生成用于进行身份验证的密码。本地调试控制台需要密码才能提高安全性,因为您可以使用此组件在核心设备上查看重要信息并执行操作。如果您在组件配置中启用 HTTPS,本地调试控制台还会创建一个证书来保护连接。默认情况下,HTTPTPS 已启用。

    使用Amazon IoT GreengrassCLI 来创建会话。此命令会生成一个 43 个字符的随机密码,该密码将在 8 小时后过期。Replace/greengrass/v2要么C:\greengrass\v2还有通往Amazon IoT Greengrass V2根文件夹。

    Linux or UnixWindows
    Linux or Unix
    sudo /greengrass/v2/bin/greengrass-cli get-debug-password
    Windows
    C:\greengrass\v2\bin\greengrass-cli get-debug-password

    如果您已将本地调试控制台配置为使用 HTTPS,则命令输出与以下示例类似。打开本地调试控制台时,您可以使用证书指纹来验证连接是否安全。

    Username: debug Password: bEDp3MOHdj8ou2w5de_sCBI2XAaguy3a8XxREXAMPLE Password expires at: 2021-04-01T17:01:43.921999931-07:00 The local debug console is configured to use TLS security. The certificate is self-signed so you will need to bypass your web browser's security warnings to open the console. Before you bypass the security warning, verify that the certificate fingerprint matches the following fingerprints. SHA-256: 15 0B 2C E2 54 8B 22 DE 08 46 54 8A B1 2B 25 DE FB 02 7D 01 4E 4A 56 67 96 DA A6 CC B1 D2 C4 1B SHA-1: BC 3E 16 04 D3 80 70 DA E0 47 25 F9 90 FA D6 02 80 3E B5 C1

    调试视图组件创建一个持续 8 小时的会话。之后,您必须生成新的密码才能再次查看本地调试控制台。

  3. 打开并登录控制面板。在 Greengrass 核心设备或开发计算机上查看仪表板(如果您通过 SSH 转发端口)。请执行下列操作之一:

    • 如果您在本地调试控制台中启用了 HTTPS(默认设置),请执行以下操作:

      1. 打开https://localhost:1441在核心设备上;如果您通过 SSH 转发端口,则在开发计算机上。

        您的浏览器可能会显示有关安全证书无效的安全警告。

      2. 如果您的浏览器显示安全警告,请验证证书是否合法并绕过安全警告。执行以下操作:

        1. 找到证书的 SHA-256 或 SHA-1 指纹,并验证它是否与 SHA-256 或 SHA-1 指纹匹配get-debug-password命令先前已打印。您的浏览器可能会提供一个或两个指纹。请查阅浏览器的文档以查看证书及其指纹。在某些浏览器中,证书指纹称为指纹。

          注意

          否则,请转到步骤 2创建新的会话。如果证书指纹仍然不匹配,则说明您的连接可能不安全。

        2. 如果证书指纹匹配,请绕过浏览器的安全警告,打开本地调试控制台。请查阅浏览器的文档以绕过浏览器安全警告。

      3. 使用用户名和密码登录网站get-debug-password命令早些时候打印。

        本地调试控制台将打开。

      4. 如果本地调试控制台显示错误,指出它无法连接到 WebSocket 由于 TLS 握手失败,您必须绕过自签名安全警告 WebSocket URL.

        
                          这些区域有: WebSocket 本地调试控制台中出现 TLS 握手错误。

        执行以下操作:

        1. 打开https://localhost:1442在打开本地调试控制台的同一个浏览器中。

        2. 验证证书并绕过安全警告。

          绕过警告后,您的浏览器可能会显示 HTTP 404 页面。

        3. 打开https://localhost:1441

          本地调试控制台显示有关核心设备的信息。

    • 如果您在本地调试控制台中禁用 HTTPTPS,请执行以下操作:

      1. 打开http://localhost:1441在核心设备上,或者如果您通过 SSH 转发端口,请在开发计算机上将其打开。

      2. 使用用户名和密码登录网站get-debug-password命令先前已打印。

        本地调试控制台将打开。

v2.0.x

打开本地调试控制台

  1. (可选)要在开发计算机上查看本地调试控制台,可以通过 SSH 转发控制台的端口。但您必须先启用AllowTcpForwarding选项位于核心设备的 SSH 配置文件中。默认情况下,此选项处于启用状态。在开发计算机上运行以下命令,查看控制面板localhost:1441在开发计算机上。

    ssh -L 1441:localhost:1441 -L 1442:localhost:1442 username@core-device-ip-address
    注意

    您可以更改默认端口14411442. 有关更多信息,请参阅 。本地调试控制台配置.

  2. 创建会话以使用本地调试控制台。创建会话时,会生成用于进行身份验证的密码。本地调试控制台需要密码才能提高安全性,因为您可以使用此组件在核心设备上查看重要信息并执行操作。

    使用Amazon IoT GreengrassCLI。此命令会生成一个 43 个字符的随机密码,该密码将在 8 小时后过期。Replace/greengrass/v2要么C:\greengrass\v2还有通往Amazon IoT Greengrass V2根文件夹。

    Linux or UnixWindows
    Linux or Unix
    sudo /greengrass/v2/bin/greengrass-cli get-debug-password
    Windows
    C:\greengrass\v2\bin\greengrass-cli get-debug-password

    命令输出类似于以下示例。

    Username: debug Password: bEDp3MOHdj8ou2w5de_sCBI2XAaguy3a8XxREXAMPLE Password will expire at: 2021-04-01T17:01:43.921999931-07:00

    debug view 组件创建的会话持续 4 小时,然后您必须生成新密码才能再次查看本地调试控制台。

  3. 打开http://localhost:1441在核心设备上,或者如果您通过 SSH 转发端口,请在开发计算机上将其打开。

  4. 使用用户名和密码登录网站get-debug-password命令先前已打印。

    本地调试控制台将打开。

本地日志文件

此组件使用的日志文件与Greengrass组件。

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log

查看此组件的日志

  • 在核心设备上运行以下命令以实时查看该组件的日志文件。Replace/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

更改日志

下表介绍了组件各个版本的更改。

Version

更改

2.2.5

版本已更新为Greengrass 核心版本 2.7.0。

2.2.4

版本已更新为Greengrass 核心版本 2.6.0。

2.2.3

错误修复和改进
  • 修复了在组件无法解密持有 SSL 私钥的密钥库时阻止启动的问题。

  • 版本已更新为Greengrass 核心版本 2.5.0。

2.2.2

版本已更新为Greengrass 核心版本 2.4.0。

2.2.1

版本已更新为Greengrass 核心版本 2.3.0。

2.2.0

版本已更新为Greengrass 核心版本 2.2.2.2.0。

2.1.0

新功能
  • 使用 HTTPS 保护与本地调试控制台的连接。默认情况下,HTTPTPS 已启用。

错误修复和改进
  • 您可以在配置编辑器中关闭闪存栏消息。

2.0.3

初始版本。