Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

配置 Amazon IoT Greengrass 核心软件

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

部署 Greengrass nucleus 组件

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

将 Greengrass 核心配置为系统服务

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

将核心配置为系统服务 (Linux)

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

您也可以手动将 nucleus 配置为作为系统服务运行。以下示例是用于 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 软件。

将 nucleus 配置为系统服务 (Windows)

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

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

Windows Command Prompt (CMD)

• 检查服务状态

  sc query "greengrass"

• 使原子核能够在设备启动时启动。

  sc config "greengrass" start=auto

• 在设备启动时阻止原子核启动。

  sc config "greengrass" start=disabled

• 启动 Amazon IoT Greengrass 核心软件。

  sc start "greengrass"

• 停止 C Amazon IoT Greengrass ore 软件。

  sc stop "greengrass"

  注意

  在 Windows 设备上， Amazon IoT Greengrass 酷睿软件在关闭 Greengrass 组件进程时会忽略此关闭信号。如果您运行此命令时， Amazon IoT Greengrass Core 软件忽略了关机信号，请等待几秒钟，然后重试。

PowerShell

• 检查服务状态

  Get-Service -Name "greengrass"

• 使原子核能够在设备启动时启动。

  Set-Service -Name "greengrass" -Status stopped -StartupType automatic

• 在设备启动时阻止原子核启动。

  Set-Service -Name "greengrass" -Status stopped -StartupType disabled

• 启动 Amazon IoT Greengrass 核心软件。

  Start-Service -Name "greengrass"

• 停止 C Amazon IoT Greengrass ore 软件。

  Stop-Service -Name "greengrass"

  注意

  在 Windows 设备上， Amazon IoT Greengrass 酷睿软件在关闭 Greengrass 组件进程时会忽略此关闭信号。如果您运行此命令时， Amazon IoT Greengrass Core 软件忽略了关机信号，请等待几秒钟，然后重试。

使用JVM选项控制内存分配

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

要控制内存分配，请创建新部署或修改包含 nucleus 组件的现有部署，然后在 nuc leus 组件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 设备上设置组件用户

配置默认组件用户

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

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

Linux

{
  "runWithDefault": {
    "posixUser": "ggc_user:ggc_group"
  }
}

Windows

{
  "runWithDefault": {
    "windowsUser": "ggc_user"
  }
}

注意

您指定的用户必须存在，并且该用户的用户名和密码必须存储在您的 Windows 设备上该 LocalSystem 帐户的凭据管理器实例中。有关更多信息，请参阅 在 Windows 设备上设置组件用户。

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

{
  "components": {
    "aws.greengrass.Nucleus": {
      "version": "2.13.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.13.0",
      "configurationUpdate": {
        "merge": "{\"runWithDefault\":{\"systemResourceLimits\":\"cpus\":2,\"memory\":102400}}}"
      }
    }
  }
}

通过端口 443 或网络代理进行连接

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

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

MQTT通过端口 443 进行配置

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

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

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

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

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

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

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

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

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

HTTPS通过端口 443 进行配置

此功能需要 Greengrass 核 v2.0.4 或更高版本。

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

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

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

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

{
  "greengrassDataPlanePort": 443
}

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

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

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

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

配置网络代理

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

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

您可以使用部署在单核设备或一组核心设备上配置网络代理。在此部署中，您将更新 n ucleus 组件配置。当您更新其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.13.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 核心设置为。greengrassDataPlaneEndpoint iotdata可以在部署或安装期间使用安装--init-config程序参数设置此选项。

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

配置MQTT超时和缓存设置

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

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