配置 AWS IoT Greengrass 核心软件

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

部署 Greengrass Nucleus 组件

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

将 Greengrass Nucleus 配置为系统服务

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

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

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

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

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

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

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

使用JVM选项控制内存分配

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

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

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

减少内存分配

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

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

最低内存分配

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

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

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

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

配置运行组件的用户

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

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

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

在基于 Linux 的设备上配置组件用户时，您还可以选择指定组。您使用以下格式指定由半角冒号（:）分隔的用户和组：user:group。如果您未指定群组，则 AWS 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 或网络代理进行连接

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

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

MQTT通过端口 443 进行配置

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

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

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

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

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

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

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

安装期间MQTT通过端口 443 进行配置

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

HTTPS通过端口 443 进行配置

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

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

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

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

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

{
  "greengrassDataPlanePort": 443
}

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

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

安装期间HTTPS通过端口 443 进行配置

在 AWS IoT Greengrass 核心设备HTTPS上安装 Core 软件时，您可以通过端口 443 进行配置。使用--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\"}}}"
      }
    }
  }
}

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

在 AWS 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超时和缓存设置

在 AWS IoT Greengrass 环境中，组件可以MQTT用来与之通信 AWS IoT Core。C AWS IoT Greengrass ore 软件管理组件的MQTT消息。当核心设备失去与的连接时 AWS Cloud，软件会缓存MQTT消息，以便稍后在连接恢复后重试。您可以配置消息超时和缓存大小等设置。有关更多信息，请参阅 Greengrass Nucleus 组件的 mqtt 和 mqtt.spooler 配置参数。

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

在网络上配置 Greengrass Nucleus IPv6

Greengrass Nucleus 通过 Greengrass 与之交谈。 AWS 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"