設定 AWS IoT Greengrass 核心軟體

Core AWS IoT Greengrass 軟體提供可用來設定軟體的選項。您可以建立部署來設定每個 AWS IoT Greengrass 核心裝置上的核心軟體。

部署 Greengrass 核元件

AWS IoT Greengrass 提供 AWS IoT Greengrass Core 軟體做為元件，您可以將其部署到 Greengrass 核心裝置。您可以建立部署，將相同的組態套用至多個 Greengrass 核心裝置。如需詳細資訊，請參閱 Greengrass 核 和 更新AWS IoT Greengrass核心軟件（OTA）。

將 Greengrass 核設定為系統服務

您必須將 AWS IoT Greengrass Core 軟體設定為裝置初始化系統中的系統服務，才能執行下列動作：

將 核設定為系統服務 (Linux)

Linux 裝置支援不同的 Init 系統，例如 initd、Systemd 和 SystemV。當您安裝 AWS IoT Greengrass Core 軟體時，您可以使用 --setup-system-service true引數來啟動做為系統服務的 核，並將其設定為在裝置開機時啟動。安裝程式會將 AWS IoT Greengrass Core 軟體設定為使用 系統化的系統服務。

您也可以手動設定 核以系統服務執行。以下範例為 systemd 的服務檔案：

[Unit]
Description=Greengrass Core

[Service]
Type=simple
PIDFile=/greengrass/v2/alts/loader.pid
RemainAfterExit=no
Restart=on-failure
RestartSec=10
ExecStart=/bin/sh /greengrass/v2/alts/current/distro/bin/loader

[Install]
WantedBy=multi-user.target

設定系統服務之後，您可以執行下列命令，以設定在開機時啟動裝置，以及啟動或停止 AWS IoT Greengrass Core 軟體。

將 核設定為系統服務 (Windows)

當您安裝 AWS IoT Greengrass Core 軟體時，您可以使用 --setup-system-service true引數來啟動做為 Windows 服務的 核，並將其設定為在裝置開機時啟動。

設定服務之後，您可以執行下列命令，以設定在開機時啟動裝置，以及啟動或停止 AWS IoT Greengrass Core 軟體。您必須以管理員 PowerShell 身分執行命令提示字元 或 ，才能執行這些命令。

使用 JVM 選項控制記憶體配置

如果您在記憶體有限的 AWS IoT Greengrass 裝置上執行，您可以使用 Java 虛擬機器 (JVM) 選項來控制堆積大小上限、垃圾收集模式和編譯器選項，以控制 AWS IoT Greengrass 核心軟體使用的記憶體量。中的堆積大小會JVM決定應用程式在垃圾收集發生之前或應用程式耗盡記憶體之前可以使用多少記憶體。堆積大小上限會指定在繁重活動期間擴展堆積時， JVM可以配置的記憶體數量上限。

若要控制記憶體配置，請建立新的部署或修改包含 核元件的現有部署，並在 核元件組態中的jvmOptions組態參數中指定您的JVM選項。

根據您的需求，您可以執行 AWS IoT Greengrass 核心軟體，減少記憶體配置或減少記憶體配置。

減少記憶體配置

若要在記憶體配置減少的情況下執行 AWS IoT Greengrass 核心軟體，建議您使用下列範例組態合併更新，在 核組態中設定JVM選項：

{
  "jvmOptions": "-XX:+UseSerialGC -XX:TieredStopAtLevel=1"
}

記憶體配置下限

若要執行具有最低記憶體配置 AWS IoT Greengrass 的核心軟體，建議您使用下列範例組態合併更新，在 核組態中設定JVM選項：

{
  "jvmOptions": "-Xmx32m -XX:+UseSerialGC -Xint"
}

這些範例組態合併更新使用以下JVM選項：

如需建立組態合併更新的資訊，請參閱 更新元件組態。

設定執行元件的使用者

AWS IoT Greengrass 核心軟體可以系統使用者身分執行元件程序，而群組與執行軟體的 不同。這可提高安全性，因為您可以以根或管理員使用者身分執行 AWS IoT Greengrass 核心軟體，而無需將這些許可授予在核心裝置上執行的元件。

下表指出 AWS IoT Greengrass Core 軟體可以以您指定的使用者身分執行的元件類型。如需詳細資訊，請參閱元件類型。

您必須先建立元件使用者，才能在部署組態中指定它。在以 Windows 為基礎的裝置上，您還必須將使用者的使用者名稱和密碼存放在 LocalSystem 帳戶的登入資料管理員執行個體中。如需詳細資訊，請參閱在 Windows 裝置上設定元件使用者。

當您在 Linux 型裝置上設定元件使用者時，您也可以選擇性地指定群組。您可以指定使用者和群組，並以冒號 (:) 分隔，格式如下：user:group。如果您未指定群組， AWS IoT Greengrass 核心軟體會預設為使用者的主要群組。您可以使用 名稱或 ID 來識別使用者和群組。

在 Linux 型裝置上，您也可以以不存在的系統使用者身分執行元件，也稱為未知使用者，以提高安全性。Linux 程序可以發出由相同使用者執行的任何其他程序的訊號。未知使用者不會執行其他程序，因此您可以將元件執行為未知使用者，以防止元件在核心裝置上發出其他元件的訊號。若要以未知使用者身分執行元件，請指定核心裝置上不存在的使用者 ID。您也可以指定不存在的群組 ID，以做為未知群組執行。

您可以為每個元件和每個核心裝置設定使用者。

在 Windows 裝置上設定元件使用者

設定預設元件使用者

您可以使用部署在核心裝置上設定預設使用者。在此部署中，您會更新 核元件組態。

建立 部署，指定aws.greengrass.Nucleus元件的下列組態更新。

下列範例定義以 Linux 為基礎的裝置的部署，將 設定為ggc_user預設使用者和ggc_group預設群組。merge 組態更新需要序列化JSON物件。

{
  "components": {
    "aws.greengrass.Nucleus": {
      "version": "2.14.0",
      "configurationUpdate": {
        "merge": "{\"runWithDefault\":{\"posixUser\":\"ggc_user:ggc_group\"}}"
      }
    }
  }
}

設定元件的系統資源限制

您可以設定每個元件程序在核心裝置上可以使用的最大數量CPU和RAM用量。

下表顯示支援系統資源限制的元件類型。如需詳細資訊，請參閱元件類型。

您可以為每個元件和每個核心裝置設定系統資源限制。

設定預設系統資源限制

您可以部署 Greengrass 核元件，以設定核心裝置的預設系統資源限制。若要設定預設系統資源限制，請建立 部署，指定aws.greengrass.Nucleus元件的下列組態更新。

{
  "runWithDefault": {
    "systemResourceLimits": {
      "cpu": cpuTimeLimit,
      "memory": memoryLimitInKb
    }
  }
}

下列範例定義了將CPU時間限制設定為 的部署2，相當於 4 個CPU核心裝置上的 50% 用量。此範例也會將記憶體用量設定為 100 MB。

{
  "components": {
    "aws.greengrass.Nucleus": {
      "version": "2.14.0",
      "configurationUpdate": {
        "merge": "{\"runWithDefault\":{\"systemResourceLimits\":\"cpus\":2,\"memory\":102400}}}"
      }
    }
  }
}

連線至連接埠 443 或透過網路代理

AWS IoT Greengrass 核心裝置 AWS IoT Core 使用MQTT具有TLS用戶端身分驗證的訊息通訊協定與 通訊。根據慣例， MQTT 上的 TLS使用連接埠 8883。不過，作為安全措施，限制性環境可能會將傳入和傳出流量限制為少量TCP連接埠。例如，企業防火牆可能會為HTTPS流量開啟連接埠 443，但關閉其他用於較不常見通訊協定的連接埠，例如MQTT流量的連接埠 8883。其他限制性環境可能需要所有流量通過代理，才能連線至網際網路。

若要在這些案例中啟用通訊， AWS IoT Greengrass 提供下列組態選項：

MQTT 透過連接埠 443 設定

您可以在現有核心裝置上MQTT透過連接埠 443 設定 ，或在新核心裝置上安裝 AWS IoT Greengrass 核心軟體時設定 。

在現有核心裝置上MQTT透過連接埠 443 設定

您可以使用部署，在單一核心裝置或一組核心裝置上MQTT透過連接埠 443 設定 。在此部署中，您會更新 核元件組態。當您更新其mqtt組態時，核會重新啟動。

若要MQTT透過連接埠 443 設定 ，請建立 部署，指定 aws.greengrass.Nucleus元件的下列組態更新。

{
  "mqtt": {
    "port": 443
  }
}

下列範例定義MQTT透過連接埠 443 設定的部署。merge 組態更新需要序列化JSON物件。

{
  "components": {
    "aws.greengrass.Nucleus": {
      "version": "2.14.0",
      "configurationUpdate": {
        "merge": "{\"mqtt\":{\"port\":443}}"
      }
    }
  }
}

在安裝期間MQTT透過連接埠 443 設定

當您在核心裝置上安裝 AWS IoT Greengrass Core 軟體時，可以透過MQTT連接埠 443 設定 。使用--init-config安裝程式引數透過MQTT連接埠 443 設定 。您可以在使用手動佈建、機群佈建或自訂佈建安裝 時指定此引數。

HTTPS 透過連接埠 443 設定

此功能需要 v2Greengrass 核.0.4 或更新版本。

您可以在現有核心裝置上HTTPS透過連接埠 443 設定 ，或在新核心裝置上安裝 AWS IoT Greengrass 核心軟體時設定 。

在現有核心裝置上HTTPS透過連接埠 443 設定

您可以使用部署，在單一核心裝置或一組核心裝置上HTTPS透過連接埠 443 設定 。在此部署中，您會更新 核元件組態。

若要HTTPS透過連接埠 443 設定 ，請建立 部署，指定 aws.greengrass.Nucleus元件的下列組態更新。

{
  "greengrassDataPlanePort": 443
}

下列範例定義HTTPS透過連接埠 443 設定的部署。merge 組態更新需要序列化JSON物件。

{
  "components": {
    "aws.greengrass.Nucleus": {
      "version": "2.14.0",
      "configurationUpdate": {
        "merge": "{\"greengrassDataPlanePort\":443}"
      }
    }
  }
}

在安裝期間HTTPS透過連接埠 443 設定

當您在核心裝置上安裝 AWS IoT Greengrass Core 軟體時，您可以透過HTTPS連接埠 443 設定 。使用--init-config安裝程式引數透過HTTPS連接埠 443 設定 。您可以在使用手動佈建、機群佈建或自訂佈建安裝 時指定此引數。

設定網路代理

遵循本節中的程序，設定 Greengrass 核心裝置透過 HTTP或 HTTPS 網路代理連線到網際網路。如需核心裝置使用的端點和連接埠的詳細資訊，請參閱 允許裝置流量透過 Proxy 或防火牆。

在現有的核心裝置上設定網路代理

您可以使用部署在單一核心裝置上或一組核心裝置上設定網路代理。在此部署中，您會更新 核元件組態。當您更新其networkProxy組態時，核會重新啟動。

若要設定網路代理，請為合併下列組態更新的aws.greengrass.Nucleus元件建立部署。此組態更新包含 networkProxy 物件。

{
  "networkProxy": {
    "noProxyAddresses": "http://192.168.0.1,www.example.com",
    "proxy": {
      "url": "https://my-proxy-server:1100"
    }
  }
}

下列範例定義了設定網路代理的部署。merge 組態更新需要序列化JSON物件。

{
  "components": {
    "aws.greengrass.Nucleus": {
      "version": "2.14.0",
      "configurationUpdate": {
        "merge": "{\"networkProxy\":{\"noProxyAddresses\":\"http://192.168.0.1,www.example.com\",\"proxy\":{\"url\":\"https://my-proxy-server:1100\",\"username\":\"Mary_Major\",\"password\":\"pass@word1357\"}}}"
      }
    }
  }
}

在安裝期間設定網路代理

您可以在核心裝置上安裝 AWS IoT Greengrass 核心軟體時設定網路代理。使用--init-config安裝程式引數來設定網路代理。您可以在使用手動佈建、機群佈建或自訂佈建安裝 時指定此引數。

讓核心裝置信任HTTPS代理

當您將核心裝置設定為使用HTTPS代理時，您必須將代理伺服器憑證鏈新增至核心裝置的 ，讓它信任HTTPS代理。否則，當核心裝置嘗試透過代理路由流量時，可能會發生錯誤。將代理伺服器 CA 憑證新增至核心裝置的 Amazon 根 CA 憑證檔案。

networkProxy 物件

使用 networkProxy 物件，指定網路代理的相關資訊。此物件包含下列資訊：

使用由私有 CA 簽署的裝置憑證

如果您使用的是自訂私有憑證授權機構 (CA)，您必須將 Greengrass 核greengrassDataPlaneEndpoint設定為 iotdata。您可以使用--init-config安裝程式引數在部署或安裝期間設定此選項。

您可以自訂裝置連線的 Greengrass 資料平面端點。您可以將此組態選項設定為 iotdata ，將 Greengrass 資料平面端點設定為與 IoT 資料端點相同的端點，您可以使用 來指定iotDataEndpoint。

設定MQTT逾時和快取設定

在 AWS IoT Greengrass 環境中，元件可以使用 MQTT 與 通訊 AWS IoT Core。Core AWS IoT Greengrass 軟體會管理元件MQTT的訊息。當核心裝置失去與 的連線時 AWS 雲端，軟體會快取MQTT訊息，以便在連線還原時稍後重試。您可以設定訊息逾時和快取大小等設定。如需詳細資訊，請參閱 Greengrass 核元件的 mqtt和 mqtt.spooler組態參數。

AWS IoT Core 對其MQTT訊息代理程式施加服務配額。這些配額可能適用於您在核心裝置與 之間傳送的訊息 AWS IoT Core。如需詳細資訊，請參閱 中的AWS IoT Core 訊息代理程式服務配額AWS 一般參考。

在IPv6網路上設定 Greengrass Nucleus

Greengrass Nucleus AWS IoT Core 透過 Greengrass 與 APIs進行通訊。Greengrass IPv6 APIs支援雙堆疊環境。

若要為 啟用雙堆疊端點IPv6：

在部署期間設定此選項，或使用--init-config安裝程式引數手動佈建。如需詳細資訊，請參閱使用 Amazon S3 雙堆疊端點。

{
    "jvmOptions": "-Daws.useDualstackEndpoint=true",
    "s3EndpointType":"DUALSTACK"
}

---
system:
  ...
services:
  aws.greengrass.Nucleus:
    ...
    configuration:
      ...
      jvmOptions: "-Daws.useDualstackEndpoint=true -Djava.net.preferIPv6Addresses=true"
      s3EndpointType: "DUALSTACK"