本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
Greengrass 核
Greengrass 核组件 (aws.greengrass.Nucleus) 是必需组件，也是运行Amazon IoT Greengrass设备上的核心软件。您可以配置此组件来自定义和更新您的Amazon IoT Greengrass远程核心软件。部署此组件以配置代理、设备角色和Amazon IoT核心设备上的事物配置。
当 nucleus 组件的版本发生变化时，或者当您更改某些配置参数时，Amazon IoT Greengrass核心软件（包括设备上的核心和所有其他组件）会重新启动以应用更改。
部署组件时，Amazon IoT Greengrass安装该组件所有依赖项的最新支持版本。正因为如此，新补丁版本的Amazon如果您向事物组添加新设备或更新针对这些设备的部署，则提供的公共组件可能会自动部署到您的核心设备。某些自动更新（例如 nucleus 更新）可能会导致您的设备意外重启。
为防止设备上运行的组件出现意外更新，我们建议您在以下情况下直接添加该组件的首选版本创建部署. 有关更新行为的更多信息Amazon IoT Greengrass核心软件，请参阅更新Amazon IoT Greengrass核心软件 (OTA).
版本
此组件有以下版本：
-
2.7.x
-
2.6.x
-
2.5.x
-
2.4.x
-
2.3.x
-
2.2.x
-
2.1.x
-
2.0.x
操作系统
此组件可以安装在运行以下操作系统的核心设备上：
Linux
Windows
有关更多信息，请参阅 支持的平台。
要求
设备必须满足某些要求才能安装和运行 Greengrass Nucleus 和Amazon IoT Greengrass核心软件。有关更多信息，请参阅 设备要求。
附属物
Greengrass 核不包含任何组件依赖关系。但是，有几个Amazon-提供的组件包括作为依赖项的核。有关更多信息，请参阅 Amazon-提供的组件。
有关组件依赖关系的更多信息，请参阅组件配方配方引用.
下载并安装
你可以下载一个安装程序，在你的设备上设置 Greengrass nucleus 组件。此安装程序将您的设备设置为 Greengrass 核心设备。您可以执行两种类型的安装：创建必需安装的快速安装Amazon为你提供资源，或者手动安装，你可以在其中创建Amazon自己动用资源。有关更多信息，请参阅 安装 Amazon IoT Greengrass Core 软件。
你也可以按照教程安装 Greengrass 核心并探索 Greengrass 组件开发。有关更多信息，请参阅 教程：Amazon IoT Greengrass V2 入门。
配置
此组件提供以下配置参数，您可以在部署组件时自定义这些参数。有些参数要求Amazon IoT Greengrass核心软件重新启动以生效。有关为何和如何配置此组件的详细信息，请参阅配置Amazon IoT GreengrassCore 软件.
iotRoleAlias-
这些区域有：Amazon IoT指向代币交换 IAM 角色的角色别名。这些区域有：Amazon IoT凭证提供者担任此角色是为了允许 Greengrass 核心设备与之交互Amazon服务。有关更多信息，请参阅 授权核心设备与Amazon服务。
当你运行Amazon IoT Greengrass核心软件带有
--provision true选项，软件提供角色别名并在核心组件中设置其值。 -
interpolateComponentConfiguration -
（可选）您可以启用 Greengrass 核进行插值组件配方配方变量在组件配置中和合并配置配置配置配置配置更新. 建议您将此选项设置为
true这样核心设备就可以运行在其配置中使用配方变量的 Greengrass 组件。此功能适用于此组件的 v2.6.0 及更高版本。
默认值：
false networkProxy-
（可选）用于所有连接的网络代理。有关更多信息，请参阅 通过端口 443 或网络代理进行连接。
重要 当您部署对此配置参数的更改时，Amazon IoT Greengrass要使更改生效，核心软件会重新启动。
此对象包含以下信息：
noProxyAddresses-
（可选）一个逗号分隔的免于代理服务器的 IP 地址或主机名列表。
proxy-
要连接的代理。此对象包含以下信息：
url-
代理服务器的 URL，格式为
scheme://userinfo@host:port.-
scheme— 该计划，必须是http要么https.重要 Greengrass 核心设备必须运行Greengrass 核v2.5.0 或更高版本可使用 HTTPS 代理。
如果您配置 HTTPS 代理，则必须将代理服务器 CA 证书添加到核心设备的 Amazon 根 CA 证书中。有关更多信息，请参阅 使核心设备信任 HTTPS 代理。
-
userinfo—（可选）用户名和密码信息。如果您在中指定了此信息url，Greengrass 核心设备忽略了username和password字段之间没有不同。 -
host— 代理服务器的主机名或 IP 地址。 -
port—（可选）端口号。如果您未指定端口，则 Greengrass 核心设备使用以下默认值：-
http— 80 -
https-443
-
-
username-
（可选）用于验证代理服务器的用户名。
password-
（可选）用于认证代理服务器的密码。
mqtt-
（可选）Greengrass 核心设备的 MQTT 配置。有关更多信息，请参阅 通过端口 443 或网络代理进行连接。
重要 当您部署对此配置参数的更改时，Amazon IoT Greengrass要使更改生效，核心软件会重新启动。
此对象包含以下信息：
port-
（可选）用于 MQTT 连接的端口。
默认值：
8883 keepAliveTimeoutMs-
（可选）两者之间的时间量（以毫秒为单位）
PING客户端为保持 MQTT 连接处于活动状态而发送的消息。默认值：
60000（60 秒） pingTimeoutMs-
（可选）客户端等待接收的时间（以毫秒为单位）
PINGACK来自服务器的消息。如果等待时间超过超时，核心设备将关闭并重新打开 MQTT 连接。默认值：
30000（30 秒） maxInFlightPublishes-
（可选）可以同时传输的最大未确认的 MQTT QoS 1 消息数。
此功能适用于此组件的 v2.1.0 及更高版本。
默认值：
5有效范围：最大值为 100
maxMessageSizeInBytes-
（可选）MQTT 消息的最大大小。如果消息超过此大小，Greengrass 核心会错误地拒绝该消息。
此功能适用于此组件的 v2.1.0 及更高版本。
默认值：
131072(128 KB)有效范围：最大值为
2621440(2.5 MB) maxPublishRetry-
（可选）重试发布失败的消息的最大次数。您可以指定到
-1无限次重试。此功能适用于此组件的 v2.1.0 及更高版本。
默认值：
100 spooler-
（可选）Greengrass 核心设备的 MQTT 假脱机程序配置。此对象包含以下信息：
maxSizeInBytes-
（可选）核心设备在内存中存储未处理的 MQTT 消息的最大大小。如果缓存已满，则核心设备会丢弃最旧的消息以添加新消息。
默认值：
2621440(2.5 MB) keepQos0WhenOffline-
（可选）您可以假脱机处理核心设备在离线时收到的 MQTT QoS 0 消息。如果将此选项设置为
true，核心设备会假脱机时无法发送的 QoS 0 消息。如果将此选项设置为false，核心设备会丢弃这些消息。除非线轴已满，否则核心设备始终会假脱机处理 QoS 1 消息。默认值：
false
-
jvmOptions -
（可选）用于运行 JVM 的选项Amazon IoT Greengrass核心软件。有关推荐运行时使用 JVM 选项的信息Amazon IoT Greengrass核心软件，请参阅使用 JVM 选项控制内存分配.
重要 当您部署对此配置参数的更改时，Amazon IoT Greengrass要使更改生效，核心软件会重新启动。
iotDataEndpoint-
这些区域有：Amazon IoT您的数据终端节点Amazon Web Services 账户.
当你运行Amazon IoT Greengrass核心软件带有
--provision true选项，该软件从中获取您的数据和凭据端点Amazon IoT并将它们设置在核组件中。 iotCredEndpoint-
这些区域有：Amazon IoT您的证书终端节点Amazon Web Services 账户.
当你运行Amazon IoT Greengrass核心软件带有
--provision true选项，该软件从中获取您的数据和凭据端点Amazon IoT并将它们设置在核组件中。 greengrassDataPlaneEndpoint-
此功能适用于 v2.7.0 及更高版本。
有关更多信息，请参阅 使用由私有 CA 签名的设备证书。
greengrassDataPlanePort-
此功能在此组件的 v2.0.4 及更高版本中可用。
（可选）用于数据平面连接的端口。有关更多信息，请参阅 通过端口 443 或网络代理进行连接。
重要 必须指定设备可以进行出站连接的端口。如果您指定了被屏蔽的端口，则设备将无法连接到Amazon IoT Greengrass接收部署。
从以下选项中进行选择：
-
443 -
8443
默认值：
8443 -
awsRegion-
这些区域有：Amazon Web Services 区域使用。
runWithDefault-
用于运行组件组件的系统用户。
重要 当您部署对此配置参数的更改时，Amazon IoT Greengrass要使更改生效，核心软件会重新启动。
此对象包含以下信息：
posixUser-
系统用户的名称或 ID，以及核心设备用于运行通用和 Lambda 组件的系统组（可选）。指定用户和群组，用冒号分隔 (
:) 采用以下格式格式：user:group. 该组是可选的。如果不指定组，Amazon IoT Greengrass核心软件为用户使用主组。举例来说，可以指定ggc_user或ggc_user:ggc_group。有关更多信息，请参阅 配置运行组件的用户。当你运行Amazon IoT Greengrass核心软件安装程序使用
--component-default-user选项，软件在 nucleus 组件中设置此参数。ggc_user:ggc_group windowsUser-
此功能适用于 v2.5.0 及更高版本。
用于在 Windows 核心设备上运行此组件的 Windows 用户的名称。用户必须存在于每台 Windows 核心设备上，并且其名称和密码必须存储在 LocalSystem 账户的凭证管理器实例。有关更多信息，请参阅 配置运行组件的用户。
当你运行Amazon IoT Greengrass核心软件安装程序使用
--component-default-user选项，软件在 nucleus 组件中设置此参数。ggc_user systemResourceLimits-
此功能适用于 v2.4.0 及更高版本。Amazon IoT Greengrass目前在 Windows 核心设备上不支持此功能。
默认情况下，系统资源限制适用于通用和非容器化的 Lambda 组件进程。创建部署时，可以覆盖单个组件的系统资源限制。有关更多信息，请参阅 配置组件的系统资源限制。
此对象包含以下信息：
cpus-
每个组件的进程可以在核心设备上使用的最大 CPU 时间。核心设备的总 CPU 时间等于该设备的 CPU 内核数。例如，在具有 4 个 CPU 内核的核心设备上，您可以将此值设置为
2将每个组件的进程限制为每个 CPU 内核的使用率为 50%。在具有 1 个 CPU 内核的设备上，可以将此值设置为0.25将每个组件的进程限制为 25% 的 CPU 使用率。如果您将此值设置为大于 CPU 内核数的数字，则Amazon IoT Greengrass核心软件不限制组件的 CPU 使用率。 memory-
每个组件的进程可以在核心设备上使用的最大内存量（以千字节为单位）。
logging-
（可选）核心设备的日志配置。有关如何配置和使用 Greengrass 日志的详细信息，请参阅显示器Amazon IoT Greengrass圆木.
此对象包含以下信息：
-
level -
（可选）要输出的最低日志消息级别。
从以下日志级别中进行选择，此处按级别顺序列出：
-
DEBUG -
INFO -
WARN -
ERROR
默认值：
INFO -
-
format -
（可选）日志的数据格式。从以下选项中进行选择：
-
TEXT— 如果您要以文本形式查看日志，请选择此选项。 -
JSON— 如果您要使用以下功能并使用以下功能并使用以下功能并选择此选项Greengrass CLI 日志命令或者以编程方式与日志交互。
默认值：
TEXT -
outputType-
（可选）日志的输出类型。从以下选项中进行选择：
-
FILE— 这个Amazon IoT Greengrass核心软件将日志输出到您在中指定的目录中的文件outputDirectory. -
CONSOLE— 这个Amazon IoT Greengrass核心软件将日志打印到stdout. 选择此选项可在核心设备打印日志时查看日志。
默认值：
FILE -
-
fileSizeKB -
（可选）每个日志文件的最大大小（以千字节为单位）。在日志文件超过此最大文件大小后，Amazon IoT Greengrass核心软件创建一个新的日志文件。
此参数仅在您指定时适用
FILE为了outputType.默认值：
1024 -
totalLogsSizeKB -
（可选）每个组件（包括 Greengrass 核）的日志文件的最大总大小（以千字节为单位）。Greengrass Nucleus 的日志文件还包括来自的日志插件组件. 当组件的日志文件总大小超过此最大大小后，Amazon IoT Greengrass核心软件会删除该组件最旧的日志文件。
此参数等同于日志管理器组件 磁盘空间限制参数 (
diskSpaceLimit），您可以为 Greengrass 核（系统）和每个组件指定该值。这些区域有：Amazon IoT Greengrass核心软件使用两个值中的最小值作为 Greengrass 原子核和每个组件的最大总对数大小。此参数仅在您指定时适用
FILE为了outputType.默认值：
10240 -
outputDirectory -
（可选）日志文件的输出目录。
此参数仅在您指定时适用
FILE为了outputType.默认值：
/greengrass/v2/logs/greengrass/v2是Amazon IoT Greengrass根文件夹。
-
-
fleetstatus -
此参数适用于 v2.1.0 及更高版本。
（可选）核心设备的队列状态配置。
此对象包含以下信息：
periodicStatusPublishIntervalSeconds-
（可选）核心设备将设备状态发布到Amazon Web Services 云.
最低：
86400（24 小时）默认值：
86400（24 小时）
-
telemetry -
（可选）核心设备的系统运行状况遥测配置。有关遥测指标以及如何处理遥测数据的更多信息，请参阅从以下位置收集系统运行状况遥测数据Amazon IoT Greengrass核心设备.
此对象包含以下信息：
enabled-
（可选）您可以启用或禁用遥测。
默认值：
true periodicAggregateMetricsIntervalSeconds-
（可选）核心设备汇总指标的时间间隔（以秒为单位）。
如果将此值设置为低于支持的最小值，则原子核改为使用默认值。
最低：
3600默认值：
3600 periodicPublishMetricsIntervalSeconds-
（可选）核心设备向其发布遥测指标的时间长度（以秒为单位）Amazon Web Services 云.
如果将此值设置为低于支持的最小值，则原子核改为使用默认值。
最低：
86400默认值：
86400
deploymentPollingFrequencySeconds-
（可选）轮询部署通知的时间段（以秒为单位）。
默认值：
15 componentStoreMaxSizeBytes-
（可选）组件存储区在磁盘上的最大大小，包括组件配方和构件。
默认值：
10000000000(10 GB) -
platformOverride -
（可选）标识核心设备平台的属性字典。使用它来定义自定义平台属性，组件配方可以使用这些属性来识别组件的正确生命周期和工件。例如，您可以定义硬件功能属性，以便仅部署组件运行所需的最少量工件。有关更多信息，请参阅 。清单平台参数在组件配方中。
您也可以使用此参数来覆盖
os和architecture核心设备的平台属性。 -
httpClient -
此参数在此组件的 v2.5.0 及更高版本中可用。
（可选）核心设备的 HTTP 客户端配置。这些配置选项适用于此组件发出的所有 HTTP 请求。如果核心设备在较慢的网络上运行，则可以延长这些超时持续时间以防止 HTTP 请求超时。
此对象包含以下信息：
connectionTimeoutMs-
（可选）在连接请求超时之前等待连接打开的时间（以毫秒为单位）。
默认值：
2000（2 秒） socketTimeoutMs-
（可选）连接超时之前等待数据通过打开的连接传输的时间（以毫秒为单位）。
默认值：
30000（30 秒）
例 示例：配置合并配置配置合并更新
{ "iotRoleAlias": "GreengrassCoreTokenExchangeRoleAlias", "networkProxy": { "noProxyAddresses": "http://192.168.0.1,www.example.com", "proxy": { "url": "http://my-proxy-server:1100", "username": "Mary_Major", "password": "pass@word1357" } }, "mqtt": { "port": 443 }, "greengrassDataPlanePort": 443, "jvmOptions": "-Xmx64m", "runWithDefault": { "posixUser": "ggc_user:ggc_group" } }
本地日志文件
此组件使用以下日志文件。
查看此组件的日志
-
在核心设备上运行以下命令以实时查看此组件的日志文件。Replace（替换）
/greengrass/v2要么C:\greengrass\v2用路径指向Amazon IoT Greengrass根文件夹。
更改日志
下表说明组件的每个版本中所做的更改。
|
Version |
更改 |
|---|---|
|
2.7.0 |
|
|
2.6.0 |
|
|
2.5.6 |
|
|
2.5.5 |
|
|
2.5.4 |
|
|
2.5.3 |
|
|
2.5.2 |
|
|
2.5.1 |
此版本不再可用。此版本中的改进可以在此组件的更高版本中获得。
|
|
2.5.0 |
|
|
2.4.0 |
|
|
2.3.0 |
|
|
2.2.0 |
|
|
2.1.0 |
|
|
2.0.5 |
|
|
2.0.4 |
|
|
2.0.3 |
初始版本。 |