本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
本機除錯主控台
本機偵錯主控台元件 (aws.greengrass.LocalDebugConsole
) 提供本機儀表板,可顯示 AWS IoT Greengrass 核心裝置及其元件的相關資訊。您可以使用此儀表板來偵錯核心裝置並管理本機元件。
我們建議您僅在開發環境中使用此元件,而不是在生產環境中使用。此元件可讓您存取通常在生產環境中不需要的資訊和作業。只將此元件部署到您需要的核心裝置,以遵循最低權限原則。
版本
此元件具有下列版本:
-
2.4.x 版本
-
2.3.x 版本
-
2.2.x 版本
-
2.1.x
-
2.0.x
Type
這個組件是一個插件組件(aws.greengrass.plugin
)。Greengrass 核在與核相同的 Java 虛擬機器(JVM)中運行此組件。當您在核心裝置上變更此元件的版本時,核心會重新啟動。
此組件使用與 Greengrass 核相同的日誌文件。如需詳細資訊,請參閱監控AWS IoT Greengrass日誌。
如需詳細資訊,請參閱元件類型。
作業系統
要求
此元件具有下列需求:
相依性
部署元件時, AWS IoT Greengrass 也會部署其相依性的相容版本。這表示您必須符合元件及其所有相依性的需求,才能成功部署元件。本節列出此元件之已發行版本的相依性,以及定義每個相依性之元件版本的語意版本條件約束。您也可以在AWS IoT Greengrass 主控台中檢視元件每個版本的相依性。在元件詳細資料頁面上,尋找 [相依性] 清單。
- 2.4.3
-
下表列出此元件 2.4.3 版的相依性。
- 2.4.3
-
下表列出此元件 2.4.3 版的相依性。
- 2.4.1 – 2.4.2
-
下表列出此元件 2.4.1 至 2.4.2 版的相依性。
- 2.4.0
-
下表列出此元件 2.4.0 版的相依性。
- 2.3.0 and 2.3.1
-
下表列出此元件 2.3.0 和 2.3.1 版的相依性。
- 2.2.9
-
下表列出此元件 2.2.9 版的相依性。
- 2.2.8
-
下表列出此元件 2.2.8 版的相依性。
- 2.2.7
-
下表列出此元件 2.2.7 版的相依性。
- 2.2.6
-
下表列出此元件 2.2.6 版的相依性。
- 2.2.5
-
下表列出此元件 2.2.5 版的相依性。
- 2.2.4
-
下表列出此元件 2.2.4 版的相依性。
- 2.2.3
-
下表列出此元件 2.2.3 版的相依性。
- 2.2.2
-
下表列出此元件 2.2.2 版的相依性。
- 2.2.1
-
下表列出此元件 2.2.1 版的相依性。
- 2.2.0
-
下表列出此元件 2.2.0 版的相依性。
- 2.1.0
-
下表列出此元件 2.1.0 版的相依性。
- 2.0.x
-
下表列出此元件 2.0.x 版的相依性。
如需有關元件相依性的詳細資訊,請參閱元件方案參考。
組態
此元件提供下列組態參數,您可以在部署元件時自訂這些參數。
- v2.1.x - v2.4.x
-
httpsEnabled
-
(選擇性) 您可以啟用本機除錯主控台的HTTPS通訊。如果您啟用HTTPS通訊,本機偵錯主控台會建立自我簽署憑證。Web 瀏覽器會針對使用自我簽署憑證的網站顯示安全性警告,因此您必須手動驗證憑證。然後,您可以繞過警告。如需詳細資訊,請參閱用量。
預設:true
port
-
(選擇性) 用來提供本機除錯主控台的連接埠。
預設:1441
websocketPort
-
(選擇性) 用於本機除錯主控台的 websocket 連接埠。
預設:1442
bindHostname
-
(選擇性) 用於本機除錯主控台的主機名稱。
如果您在 Docker 容器中執行 AWS IoT Greengrass Core 軟體,請將此參數設定為0.0.0.0
,以便您可以在 Docker 容器外開啟本機偵錯主控台。
預設:localhost
範例:組態合併更新
下列範例組態指定在非預設連接埠上開啟本機偵錯主控台並停用HTTPS。
{
"httpsEnabled": false,
"port": "10441",
"websocketPort": "10442"
}
- v2.0.x
-
port
-
(選擇性) 用來提供本機除錯主控台的連接埠。
預設:1441
websocketPort
-
(選擇性) 用於本機除錯主控台的 websocket 連接埠。
預設:1442
bindHostname
-
(選擇性) 用於本機除錯主控台的主機名稱。
如果您在 Docker 容器中執行 AWS IoT Greengrass Core 軟體,請將此參數設定為0.0.0.0
,以便您可以在 Docker 容器外開啟本機偵錯主控台。
預設:localhost
範例:組態合併更新
下列範例組態指定在非預設連接埠上開啟本機偵錯主控台。
{
"port": "10441",
"websocketPort": "10442"
}
用量
若要使用本機偵錯主控台,請從 Greeng CLI rass 建立工作階段。當您建立工作階段時,Greengrass 會CLI提供使用者名稱和暫時密碼,讓您用來登入本機偵錯主控台。
請依照下列指示,在核心裝置或開發電腦上開啟本機偵錯主控台。
- v2.1.x - v2.4.x
-
在 2.1.0 及更新版本中,本機偵錯主控台預設會使HTTPS用。啟用HTTPS時,本機偵錯主控台會建立自我簽署憑證以保護連線安全。當您因為此自我簽署憑證而開啟本機偵錯主控台時,Web 瀏覽器會顯示安全性警告。當您使用 Greengrass 建立工作階段時CLI,輸出會包含憑證的指紋,因此您可以驗證憑證是否合法且連線是安全的。
您可以停用HTTPS。如需詳細資訊,請參閱本機偵錯主控台組態。
開啟本機除錯主控台
-
(選擇性) 若要檢視開發電腦上的本機偵錯主控台,您可以轉寄主控台的連接埠SSH。但是,您必須先在核心設備的SSH配置文件中啟用該AllowTcpForwarding
選項。此選項預設為啟用。在您的開發電腦上執行下列命令,以檢視開發電腦localhost:1441
上的儀表板。
ssh -L 1441:localhost:1441 -L 1442:localhost:1442 username
@core-device-ip-address
-
建立工作階段以使用本機偵錯主控台。當您建立工作階段時,您會產生用來驗證的密碼。本機偵錯主控台需要密碼來提高安全性,因為您可以使用此元件來檢視重要資訊並在核心裝置上執行作業。如果您在元件組態HTTPS中啟用,本機偵錯主控台也會建立憑證來保護連線的安全。HTTPS依預設為啟用。
使用建 AWS IoT Greengrass CLI立工作階段。此命令會產生一個隨機 43 個字元的密碼,該密碼會在 8 小時後過期。更換/greengrass/v2
或 C:\greengrass\v2
與 AWS 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 小時的會話。之後,您必須產生新密碼才能再次檢視本機偵錯主控台。
-
開啟並登入儀表板。在 Greengrass 核心裝置上檢視儀表板,或在您的開發電腦上檢視儀表板 (如果您將連接埠轉寄過來)。SSH執行以下任意一項:
- v2.0.x
-
開啟本機除錯主控台
-
(選擇性) 若要檢視開發電腦上的本機偵錯主控台,您可以轉寄主控台的連接埠SSH。但是,您必須先在核心設備的SSH配置文件中啟用該AllowTcpForwarding
選項。此選項預設為啟用。在您的開發電腦上執行下列命令,以檢視開發電腦localhost:1441
上的儀表板。
ssh -L 1441:localhost:1441 -L 1442:localhost:1442 username
@core-device-ip-address
-
建立工作階段以使用本機偵錯主控台。當您建立工作階段時,您會產生用來驗證的密碼。本機偵錯主控台需要密碼來提高安全性,因為您可以使用此元件來檢視重要資訊並在核心裝置上執行作業。
使用建 AWS IoT Greengrass CLI立工作階段。此命令會產生一個隨機 43 個字元的密碼,該密碼會在 8 小時後過期。更換/greengrass/v2
或 C:\greengrass\v2
與 AWS 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
調試視圖組件創建會話持續 4 小時,然後你必須生成一個新的密碼再次查看本地調試控制台。
-
在核心裝置http://localhost:1441
上開啟,或在您的開發電腦上開啟它 (如果您將連接埠轉寄過來) SSH。
-
使用先前列印的get-debug-password
命令的使用者名稱和密碼登入網站。
本機除錯主控台隨即開啟。
本機記錄檔
此元件使用與 Greengrass 核元件相同的記錄檔。
- Linux
-
/greengrass/v2
/logs/greengrass.log
- Windows
-
C:\greengrass\v2
\logs\greengrass.log
變更記錄
下表說明元件每個版本的變更。
版本
|
變更
|
2.4.3
|
版本更新了 Greengrass 2.13.0 版本。
|
2.4.2
|
|
2.4.1
|
版本更新了 Greengrass 2.12.0 版本。 |
2.4.0
|
|
2.3.1
|
版本更新 Greengrass 2.11.0 版本釋放。 |
2.3.0
|
版本更新了 Greengrass 2.10.0 版本。 |
2.2.7
|
版本更新 Greengrass 2.9.0 版本釋放。 |
2.2.6
|
版本更新 Greengrass 2.8.0 版本發布。 |
2.2.5
|
版本更新了 Greengrass 核 2.7.0 版本釋放。
|
2.2.4
|
版本更新 Greengrass 2.6.0 版本發布。
|
2.2.3
|
|
2.2.2
|
版本更新 Greengrass 2.4.0 版本的版本。
|
2.2.1
|
版本更新了 Greengrass 核 2.3.0 版本。
|
2.2.0
|
版本更新了 Greengrass 核 2.2.0 版本。
|
2.1.0
|
|
2.0.3
|
初始版本。
|