管理核心裝置端點 - AWS IoT Greengrass

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

管理核心裝置端點

當您使用雲端探索時,您會將核心裝置的 MQTT 代理程式端點儲存在AWS IoT Greengrass雲端服務中。用戶端裝置會連線AWS IoT Greengrass以擷取這些端點和其關聯核心裝置的其他資訊。

對於每個核心裝置,您可以自動或手動管理端點。

  • 使用 IP 偵測器自動管理端點

    如果您的網路設定非複雜,例如用戶端裝置與核心裝置位於相同網路上的位置,則可以部署 IP 偵測器元件以自動為您管理核心裝置端點。例如,如果核心設備位於將 MQTT 代理端口轉發到核心設備的路由器後面,則無法使用 IP 檢測器組件。

    如果您部署到物件群組,IP 偵測器元件也很有用,因為它會管理物件群組中所有核心裝置的端點。如需詳細資訊,請參閱 使用 IP 偵測器自動管理端點

  • 手動管理端點

    如果您無法使用 IP 偵測器元件,則必須手動管理核心裝置端點。您可以使用主控台或 API 更新這些端點。如需詳細資訊,請參閱 手動管理端點

使用 IP 偵測器自動管理端點

如果您有簡單的網路設定 (例如與核心裝置位於相同網路上的用戶端裝置),則可以部署 IP 偵測器元件以執行下列作業:

  • 監控 Greengrass 核心裝置的區域網路連線資訊。此資訊包括核心裝置的網路端點,以及 MQTT 代理程式運作所在的連接埠。

  • 向AWS IoT Greengrass雲服務報告核心設備的連接信息。

IP 偵測器元件會覆寫您手動設定的端點。

重要

核心裝置的AWS IoT原則必須允greengrass:UpdateConnectivityInfo許使用 IP 偵測器元件的權限。如需詳細資訊,請參閱 資料平面操作的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 偵測器元件。您可以指定下列任何一個組態選項:

      • 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 偵測器元件,請建立包含在components物件aws.greengrass.clientdevices.IPDetector中的部署文件,並指定元件的組態更新。遵循中建立部署的指示建立新部署或修訂既有部署。

建立部署文件時,您可以指定下列任一選項來設定 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 代理程式在核心裝置上運作的連接埠。

您可以在預設使用連接埠 8883 的 Moquette MQTT 代理程式元件上設定此連接埠。

中繼資料 (Metadata)

提供給連線至此端點的用戶端裝置的其他中繼資料。

管理端點 (主控台)

您可以使用AWS IoT Greengrass主控台來檢視、更新和移除核心裝置的端點。

管理核心裝置 (主控台) 的端點
  1. 選擇核心裝置

  2. 選擇要管理的核心裝置。

  3. 在核心裝置的詳細資料頁面上,選擇 [用戶端裝置] 索引標籤。

  4. MQTT 代理程式端點區段中,您可以查看核心裝置的 MQTT 代理程式端點。選擇「管理端點」。

  5. 在「管理端點」模式中,新增或移除核心裝置的 MQTT 代理程式端點。

  6. 選擇更新

管理端點 (AWS CLI)

您可以使用 AWS Command Line Interface (AWS CLI) 管理核心裝置的端點。

注意

由於中的用戶端裝置支援與回溯相容AWS IoT Greengrass V1,因AWS IoT Greengrass V2此您可以使用AWS IoT Greengrass V2或 AWS IoT Greengrass V1 API 作業來管理核心裝置端點。

取得核心裝置的端點 (AWS CLI)
更新核心裝置的端點 (AWS CLI)

管理端點 (API)

您可以使用 AWS API 管理核心裝置的端點。

注意

由於中的用戶端裝置支援與回溯相容AWS IoT Greengrass V1,因AWS IoT Greengrass V2此您可以使用AWS IoT Greengrass V2或 AWS IoT Greengrass V1 API 作業來管理核心裝置端點。

取得核心裝置 (AWSAPI) 的端點
更新核心裝置 (AWSAPI) 的端點