配置 Amazon IoT Greengrass 核心软件

C Amazon IoT Greengrass ore 软件提供了可用于配置软件的选项。您可以创建部署以在每台 Amazon IoT Greengrass 核心设备上配置核心软件。

部署 Greengrass Nucleus 组件

Amazon IoT Greengrass 将 C Amazon IoT Greengrass ore 软件作为组件提供，您可以将其部署到 Greengrass 核心设备上。您可以创建一个部署，将同一配置应用于多个 Greengrass 核心设备。有关更多信息，请参阅Greengrass Nucleus 和更新 Amazon IoT Greengrass 核心软件 (OTA)。

将 Greengrass Nucleus 配置为系统服务

要执行以下操作，您必须在设备的初始化系统中将 C Amazon IoT Greengrass ore 软件配置为系统服务：

将核心配置为系统服务（Linux）

Linux 设备支持不同的初始化系统，例如 initd、systemd 和 SystemV。在安装 Amazon IoT Greengrass Core 软件时，您可以使用--setup-system-service true参数将 nucleus 作为系统服务启动，并将其配置为在设备启动时启动。安装程序使用 systemd 将 Amazon IoT Greengrass 核心软件配置为系统服务。

您还可以手动配置核心，使其作为系统服务运行。以下示例是用于 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

配置系统服务后，您可以运行以下命令来配置启动设备以及启动或停止 Amazon IoT Greengrass Core 软件。

将核心配置为系统服务（Windows）

在安装 Amazon IoT Greengrass Core 软件时，您可以使用--setup-system-service true参数将 nucleus 作为 Windows 服务启动，并将其配置为在设备启动时启动。

配置服务后，您可以运行以下命令来配置启动设备以及启动或停止 Amazon IoT Greengrass Core 软件。必须运行命令提示符或以管理员 PowerShell 身份运行这些命令。

使用 JVM 选项控制内存分配

如果您在内存有限的设备 Amazon IoT Greengrass 上运行，则可以使用 Java 虚拟机 (JVM) 选项来控制最大堆大小、垃圾收集模式和编译器选项，这些选项控制 Amazon IoT Greengrass 核心软件使用的内存量。JVM 中的堆大小决定了在垃圾回收发生之前或应用程序耗尽内存之前，应用程序可以使用的内存量。最大堆大小指定了在占用大量内存的活动期间扩展堆时，JVM 可分配的最大内存量。

要控制内存分配，请创建一个新部署或修改包含核心组件的现有部署，然后在核心组件配置的 jvmOptions 配置参数中指定您的 JVM 选项。

根据您的要求，您可以在减少内存分配或最小内存分配的情况下运行 C Amazon IoT Greengrass ore 软件。

减少内存分配

要在减少内存分配的情况下运行 Amazon IoT Greengrass Core 软件，我们建议您使用以下示例配置合并更新在 nucleus 配置中设置 JVM 选项：

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

最低内存分配

要以最少的内存分配运行 Amazon IoT Greengrass Core 软件，我们建议您使用以下示例配置合并更新在 nucleus 配置中设置 JVM 选项：

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

这些示例配置合并更新使用了以下 JVM 选项：

有关创建配置合并更新的信息，请参阅更新组件配置。

配置运行组件的用户

Amazon IoT Greengrass Core 软件可以以不同于运行该软件的系统用户和组的身份运行组件进程。这可以提高安全性，因为您可以以 root 用户或管理员用户身份运行 C Amazon IoT Greengrass ore 软件，而无需将这些权限授予在核心设备上运行的组件。

下表显示了 Amazon IoT Greengrass 核心软件可以以您指定的用户身份运行的组件类型。有关更多信息，请参阅 组件类型。

您必须先创建组件用户，然后才能在部署配置中指定该用户。在基于 Windows 的设备上，您还必须将用户的用户名和密码存储在账户的凭据管理器实例中。 LocalSystem 有关更多信息，请参阅 在 Windows 设备上设置组件用户。

在基于 Linux 的设备上配置组件用户时，您还可以选择指定组。您使用以下格式指定由半角冒号（:）分隔的用户和组：user:group。如果您未指定群组，则 Amazon IoT Greengrass Core 软件将默认为该用户的主群组。您可以使用名称或 ID 来标识用户和组。

在基于 Linux 的设备上，您还能够以不存在的系统用户（也称为未知用户）身份运行组件，以提高安全性。Linux 进程可以向同一用户运行的任何其它进程发出信号。未知用户不会运行其它进程，因此您能够以未知用户身份运行组件，以防止组件向核心设备上的其它组件发出信号。要以未知用户身份运行组件，请指定一个核心设备上不存在的用户 ID。您还可以指定一个不存在的组 ID，以便以未知组身份运行。

您可以为每个组件和每个核心设备配置用户。

在 Windows 设备上设置组件用户

配置默认组件用户

您可以使用某个部署在核心设备上配置默认用户。在此部署中，您更新核心组件配置。

创建一个部署，通过该部署为 aws.greengrass.Nucleus 组件指定以下配置更新。

以下示例定义了将 ggc_user 配置为默认用户和将 ggc_group 配置为默认组的基于 Linux 的设备的部署。merge 配置更新需要序列化 JSON 对象。

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

配置组件的系统资源限制

您可以配置每个组件进程可在核心设备上使用的最大 CPU 和 RAM 用量。

下表显示了支持系统资源限制的组件类型。有关更多信息，请参阅 组件类型。

您可以为每个组件和每个核心设备配置系统资源限制。

配置默认系统资源限制

您可以部署 Greengrass Nucleus 组件，以为核心设备配置默认系统资源限制。要配置默认的系统资源限制，请创建一个部署，通过该部署为 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 或网络代理进行连接

Amazon IoT Greengrass 核心设备 Amazon IoT Core 使用带有 TLS 客户端身份验证的 MQTT 消息协议与之通信。按照惯例，基于 TLS 的 MQTT 使用端口 8883。但是，作为一项安全措施，限制性环境可能会将入站和出站流量限制到一个较小的 TCP 端口范围。例如，企业防火墙可能会为 HTTPS 流量打开端口 443，但关闭不常用协议使用的其他端口，例如用于 MQTT 流量的端口 8883。其它限制性环境可能要求所有流量经由代理连接到互联网。

为了在这些情况下启用通信， Amazon IoT Greengrass 提供了以下配置选项：

通过端口 443 配置 MQTT

您可以在现有核心设备上配置通过端口 443 的 MQTT，也可以在新的核心设备上安装 Amazon IoT Greengrass Core 软件时进行此配置。

在现有核心设备上配置通过端口 443 的 MQTT

您可以使用某个部署在单个核心设备或一组核心设备上配置通过端口 443 的 MQTT。在此部署中，您更新核心组件配置。当您更新核心的 mqtt 配置时，核心会重新启动。

要通过端口 443 配置 MQTT，请创建一个部署，通过该部署为 aws.greengrass.Nucleus 组件指定以下配置更新。

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

以下示例定义了一个部署，该部署配置了通过端口 443 的 MQTT。merge 配置更新需要序列化 JSON 对象。

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

在安装过程中通过端口 443 配置 MQTT

在核心设备上安装 Amazon IoT Greengrass 核心软件时，可以通过端口 443 配置 MQTT。使用 --init-config 安装程序参数配置通过端口 443 的 MQTT。在使用手动预置、实例集预置或自定义预置进行安装时，您可以指定此参数。

通过端口 443 配置 HTTPS

此功能需要 Greengrass Nucleus v2.0.40 或更高版本。

您可以在现有核心设备上配置通过端口 443 的 HTTPS，也可以在新的核心设备上安装 Amazon IoT Greengrass Core 软件时进行此配置。

在现有核心设备上配置通过端口 443 的 HTTPS

您可以使用某个部署在单个核心设备或一组核心设备上配置通过端口 443 的 HTTPS。在此部署中，您更新核心组件配置。

要通过端口 443 配置 HTTPS，请创建一个部署，通过该部署为 aws.greengrass.Nucleus 组件指定以下配置更新。

{
  "greengrassDataPlanePort": 443
}

以下示例定义了一个部署，该部署配置了通过端口 443 的 HTTPS。merge 配置更新需要序列化 JSON 对象。

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

在安装过程中配置通过端口 443 的 HTTPS

在核心设备上安装 Amazon IoT Greengrass 核心软件时，可以通过端口 443 配置 HTTPS。使用 --init-config 安装程序参数配置通过端口 443 的 HTTPS。在使用手动预置、实例集预置或自定义预置进行安装时，您可以指定此参数。

配置网络代理

按照本节中的步骤将 Greengrass 核心设备配置为经由 HTTP 或 HTTPS 网络代理连接到互联网。有关核心设备使用的端点和端口的更多信息，请参阅允许设备流量通过代理或防火墙。

在现有核心设备上配置网络代理

您可以使用某个部署在单个核心设备或一组核心设备上配置网络代理。在此部署中，您更新核心组件配置。当您更新核心的 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\"}}}"
      }
    }
  }
}

在安装过程中配置网络代理

在 Amazon IoT Greengrass 核心设备上安装 Core 软件时，可以配置网络代理。使用 --init-config 安装程序参数配置网络代理。在使用手动预置、实例集预置或自定义预置进行安装时，您可以指定此参数。

使核心设备信任 HTTPS 代理

将核心设备配置为使用 HTTPS 代理时，必须将代理服务器证书链添加到核心设备中，使其能够信任 HTTPS 代理。否则，核心设备在尝试通过代理路由流量时可能会遇到错误。将代理服务器 CA 证书添加到核心设备的 Amazon 根 CA 证书文件中。

networkProxy 对象

使用 networkProxy 对象指定有关网络代理的信息。该对象包含以下信息：

使用由私有 CA 签名的设备证书

如果您使用自定义私有证书颁发机构（CA），则必须将 Greengrass Nucleus 的 greengrassDataPlaneEndpoint 设置为 iotdata。您可以在部署或安装期间使用 --init-config 安装程序参数设置此选项。

您可以自定义设备连接的 Greengrass 数据面板端点。您可以将此配置选项设置为 iotdata，以将 Greengrass 数据面板端点设置为与 IoT 数据端点相同的端点，您可以使用 iotDataEndpoint 指定该端点。

配置 MQTT 超时和缓存设置

在 Amazon IoT Greengrass 环境中，组件可以使用 MQTT 进行 Amazon IoT Core通信。 Amazon IoT Greengrass 核心软件管理组件的 MQTT 消息。当核心设备与 Amazon Web Services 云断开连接时，软件会缓存 MQTT 消息，以便稍后在连接恢复后重试。您可以配置消息超时和缓存大小等设置。有关更多信息，请参阅 Greengrass Nucleus 组件的 mqtt 和 mqtt.spooler 配置参数。

Amazon IoT Core 对其 MQTT 消息代理施加服务配额。这些配额可能适用于您在核心设备和 Amazon IoT Core之间发送的消息。有关更多信息，请参阅 Amazon Web Services 一般参考 中的 Amazon IoT Core 消息代理服务配额。

在网络上配置 Greengrass Nucleus IPv6

Greengrass Nucleus 通过 Greengrass 与之交谈。 Amazon IoT Core APIs双栈环境下支持 APIs Greengr IPv6 ass。

要启用双栈端点，请执行以下操作： 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"