管理核心裝置端點

當您使用雲端探索時，您會將核心裝置的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來管理部署。如需詳細資訊，請參閱建立部署。

在AWS IoT Greengrass 主控台瀏覽功能表中，選擇 [元件]。
在 [元件] 頁面上，選擇 [公用元件] 索引標籤，然後選擇aws.greengrass.clientdevices.IPDetector。
在 aws.greengrass.clientdevices.IPDetector 頁面中，選擇部署。
從 [新增至部署] 中，選擇要修訂的現有部署，或選擇建立新部署，然後選擇 [下一步]。
如果您選擇建立新部署，請為部署選擇目標核心裝置或物件群組。在 [指定目標] 頁面的 [部署目標] 下，選擇核心裝置或物件群組，然後選擇 [下一步]。
在 [選取元件] 頁面上，確認已選取aws.greengrass.clientdevices.IPDetector元件，然後選擇 [下一步]。
在 [設定元件] 頁面上，選取 aws.greengrass.clientdevices.IPDetector，然後執行下列動作：
1. 選擇設定元件。
2. 在 [設定aws.greengrass.clientdevices.IPDetector強制回應] 的 [組態更新] 下的 [要合併的組態] 中，您可以輸入組態更新以設定 IP 偵測器元件。您可以指定下列任一組態選項：
  - defaultPort— (選用) 此元件偵測到 IP 位址時要報告的MQTT代理人連接埠。如果將MQTT代理程式設定為使用與預設連接埠 8883 不同的連接埠，則必須指定此參數。
  - includeIPv4LoopbackAddrs— (選擇性) 您可以啟用此選項來偵測和報告IPv4回送位址。這些是 IP 位址，例如localhost裝置可以與自身通訊的位置。在核心裝置和用戶端裝置在相同系統上執行的測試環境中使用此選項。
  - includeIPv4LinkLocalAddrs— (選用) 您可以啟用此選項來偵測和報告IPv4連結本機位址。如果核心裝置的網路沒有動態主機設定通訊協定 (DHCP) 或靜態指派的 IP 位址，請使用此選項。
  - includeIPv6LoopbackAddrs— (選擇性) 您可以啟用此選項來偵測和報告IPv6回送位址。這些是 IP 位址，例如localhost裝置可以與自身通訊的位置。在核心裝置和用戶端裝置在相同系統上執行的測試環境中使用此選項。您必須includeIPv4Addrs將設定為false和，includeIPv6Addrs才true能使用此選項。您必須擁有 IP 偵測器 v2.2.0 或更新版本才能使用此選項。
  - includeIPv6LinkLocalAddrs— (選用) 您可以啟用此選項來偵測和報告IPv6連結本機位址。如果核心裝置的網路沒有動態主機設定通訊協定 (DHCP) 或靜態指派的 IP 位址，請使用此選項。您必須includeIPv4Addrs將設定為false和，includeIPv6Addrs才true能使用此選項。您必須擁有 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
}
```
3. 選擇 [確認] 關閉強制回應，然後選擇 [下一步]。
在設定進階設定頁面上，保留預設組態設定，然後選擇 下一步。
在 Review (檢閱) 頁面，選擇 Deploy (部署)。

部署最多可能需要一分鐘的時間才能完成。

若要部署 IP 偵測器元件，請建立包含在components物件aws.greengrass.clientdevices.IPDetector中的部署文件，並指定元件的組態更新。依照中建立部署的指示建立新部署或修訂既有部署。

建立部署文件時，您可以指定下列任一選項來設定 IP 偵測器元件：

defaultPort— (選用) 此元件偵測到 IP 位址時要報告的MQTT代理人連接埠。如果將MQTT代理程式設定為使用與預設連接埠 8883 不同的連接埠，則必須指定此參數。
includeIPv4LoopbackAddrs— (選擇性) 您可以啟用此選項來偵測和報告IPv4回送位址。這些是 IP 位址，例如localhost裝置可以與自身通訊的位置。在核心裝置和用戶端裝置在相同系統上執行的測試環境中使用此選項。
includeIPv4LinkLocalAddrs— (選用) 您可以啟用此選項來偵測和報告IPv4連結本機位址。如果核心裝置的網路沒有動態主機設定通訊協定 (DHCP) 或靜態指派的 IP 位址，請使用此選項。
includeIPv6LoopbackAddrs— (選擇性) 您可以啟用此選項來偵測和報告IPv6回送位址。這些是 IP 位址，例如localhost裝置可以與自身通訊的位置。在核心裝置和用戶端裝置在相同系統上執行的測試環境中使用此選項。您必須includeIPv4Addrs將設定為false和，includeIPv6Addrs才true能使用此選項。您必須擁有 IP 偵測器 v2.2.0 或更新版本才能使用此選項。
includeIPv6LinkLocalAddrs— (選用) 您可以啟用此選項來偵測和報告IPv6連結本機位址。如果核心裝置的網路沒有動態主機設定通訊協定 (DHCP) 或靜態指派的 IP 位址，請使用此選項。您必須includeIPv4Addrs將設定為false和，includeIPv6Addrs才true能使用此選項。您必須擁有 IP 偵測器 v2.2.0 或更新版本才能使用此選項。
includeIPv4Addrs— (選用) 預設值設定為 true。您可以啟用此選項，以發佈在核心裝置上找到的IPv4位址。您必須擁有 IP 偵測器 v2.2.0 或更新版本才能使用此選項。
includeIPv6Addrs— (選用) 您可以啟用此選項，以發佈在核心裝置上找到的IPv6位址。設定includeIPv4Addrs為false以使用此選項。您必須擁有 IP 偵測器 v2.2.0 或更新版本才能使用此選項。

下列範例部分部署文件會指定將連接埠 8883 報告為MQTT代理連接埠。


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