安装Amazon IoT Greengrass具有自定义资源配置的核心软件 - Amazon IoT Greengrass
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

安装Amazon IoT Greengrass具有自定义资源配置的核心软件

此功能适用于 v2.4.0 及更高版本的Greengrass 核组件.

这些区域有:Amazon IoT Greengrass核心软件安装程序提供了一个 Java 接口,您可以在自定义插件中实现该接口,该插件需要Amazon资源的费用。您可以开发置备插件以使用自定义 X.509 客户端证书或运行其他安装进程不支持的复杂的置备步骤。有关更多信息,请参阅 。创建您自己的客户端证书中的Amazon IoT Core开发人员指南.

要在安装Amazon IoT Greengrass核心软件,您可以创建您提供给安装程序的 JAR 文件。安装程序运行该插件,并且该插件返回一个配置,该配置定义AmazonGreengrass 核心设备的资源。安装程序使用此信息配置Amazon IoT Greengrass设备上的核心软件。有关更多信息,请参阅开发自定义配置插件

重要

在您下载Amazon IoT Greengrass核心软件,请检查您的核心设备是否满足要求来安装并运行Amazon IoT GreengrassCore 软件 2.0.

Prerequisites

安装Amazon IoT Greengrass使用自定义预配置的核心软件,您必须具备以下内容:

  • 自定义置备插件的 JAR 文件,用于实现DeviceIdentityInterface. 自定义置备插件必须返回每个系统和核心配置参数的值。否则,您必须在安装期间在配置文件中提供这些值。有关更多信息,请参阅开发自定义配置插件

下载Amazon IoT GreengrassCore 软件

您可以从下载最新版本的Amazon IoT Greengrass来自以下位置的核心软件:

注意

您可以从下载特定版本的Amazon IoT Greengrass来自以下位置的核心软件。Replaceversion与要下载的版本。

https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-version.zip

下载Amazon IoT Greengrass核心软件

  1. 在您的设备上,下载Amazon IoT Greengrass核心软件转换为名为greengrass-nucleus-latest.zip.

    curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip

    一旦下载此软件,即表示您同意Greengrass 核心软件许可协议.

  2. 解压缩Amazon IoT Greengrass核心软件添加到设备上的文件夹中。Replace绿色草原与您要使用的文件夹。

    unzip greengrass-nucleus-latest.zip -d GreengrassCore && rm greengrass-nucleus-latest.zip
    重要

    如果您安装早于 v2.4.0 版本的 Greengrass 核心,请不要删除此文件夹后安装Amazon IoT GreengrassCore 软件。这些区域有:Amazon IoT Greengrass核心软件使用此文件夹中的文件来运行。

    如果您下载了最新版本的软件,请安装 v2.4.0 或更高版本,并且可以在安装Amazon IoT GreengrassCore 软件。

  3. (可选)运行以下命令,查看Amazon IoT GreengrassCore 软件。

    java -jar ./GreengrassCore/lib/Greengrass.jar --version

安装 Amazon IoT Greengrass Core 软件

使用指定以下操作的参数运行安装程序:

  • 从部分配置文件进行安装,该文件指定使用自定义置备插件来置备Amazon资源的费用。这些区域有:Amazon IoT Greengrass核心软件使用配置文件,用于指定设备上每个 Greengrass 组件的配置。安装程序将根据您提供的部分配置文件创建完整的配置文件,并且Amazon自定义置备插件创建的资源。

  • 使用ggc_user系统用户和ggc_group系统组以在核心设备上运行软件组件。如果此默认用户和组不存在,则安装程序将创建这些用户和组。

  • 将软件安装为启动时运行的系统服务,如果您的设备具有systemdinit 系统。

有关可以指定的参数的详细信息,请参阅安装程序参数.

注意

如果您运行Amazon IoT Greengrass在内存有限的设备上,您可以控制Amazon IoT GreengrassCore 软件使用。要控制内存分配,可以在jvmOptions配置参数。有关更多信息,请参阅使用 JVM 选项控制内存分配

安装Amazon IoT Greengrass核心软件

  1. 检查版本Amazon IoT GreengrassCore 软件。

    • Replace绿色草原将替换为包含软件的文件夹的路径。

    java -jar ./GreengrassCore/lib/Greengrass.jar --version
  2. 使用文本编辑器创建名为config.yaml以提供给安装程序。

    例如,在基于 Linux 的系统上,您可以运行以下命令来使用 GNU nano 创建config.yaml中的绿色草原folder。

    nano GreengrassCore/config.yaml

    将以下 YAML 内容复制到该文件中。

    --- system: rootpath: "/greengrass/v2" # The following values are optional. Return them from the provisioning plugin or set them here. # certificateFilePath: "" # privateKeyPath: "" # rootCaPath: "" # thingName: "" services: aws.greengrass.Nucleus: version: "2.4.0" configuration: # The following values are optional. Return them from the provisioning plugin or set them here. # awsRegion: "" # iotRoleAlias: "" # iotDataEndpoint: "" # iotCredEndpoint: "" com.example.CustomProvisioning: configuration: # You can specify configuration parameters to provide to your plugin. # pluginParameter: ""

    然后,执行以下操作:

    • Replace2.4.0版本的Amazon IoT GreengrassCore 软件。

    • 替换/绿草/v2与 Greengrass 根文件夹。

    • (可选)指定系统和核心配置值。如果您的置备插件未提供这些值,则必须设置这些值。

    • (可选)指定要提供给您的置备插件的配置参数。

    注意

    在此配置文件中,您可以自定义其他配置选项,例如要使用的端口和网络代理,如以下示例所示。有关更多信息,请参阅 。Greengrass 核配置.

    --- system: rootpath: "/greengrass/v2" # The following values are optional. Return them from the provisioning plugin or set them here. # certificateFilePath: "" # privateKeyPath: "" # rootCaPath: "" # thingName: "" services: aws.greengrass.Nucleus: version: "2.4.0" configuration: mqtt: port: 443 greengrassDataPlanePort: 443 networkProxy: noProxyAddresses: "http://192.168.0.1,www.example.com" proxy: url: "http://my-proxy-server:1100" username: "Mary_Major" password: "pass@word1357" # The following values are optional. Return them from the provisioning plugin or set them here. # awsRegion: "" # iotRoleAlias: "" # iotDataEndpoint: "" # iotCredEndpoint: "" com.example.CustomProvisioning: configuration: # You can specify configuration parameters to provide to your plugin. # pluginParameter: ""
  3. 运行安装程序。指定--trusted-plugin来提供您的自定义配置插件,并指定--init-config以提供配置文件。

    • Replace/绿草/v2与 Greengrass 根文件夹。

    • 替换绿色草原与您解压安装程序的文件夹一起使用。

    • 将自定义置备插件 JAR 文件的路径替换为插件 JAR 文件的路径。

    sudo -E java -Droot="/greengrass/v2" -Dlog.store=FILE \ -jar ./GreengrassCore/lib/Greengrass.jar \ --trusted-plugin /path/to/com.example.CustomProvisioning.jar \ --init-config ./GreengrassCore/config.yaml \ --component-default-user ggc_user:ggc_group \ --setup-system-service true

    如果您指定--setup-system-service true,安装程序将打印Successfully set up Nucleus as a system service(如果它将软件作为系统服务设置并运行)。否则,如果安装程序成功安装软件,则不会输出任何消息。

    注意

    您不能使用deploy-dev-tools参数在运行安装程序时部署本地开发工具--provision true参数。有关直接在设备上部署 Greengrass CLI 的信息,请参阅Greengrass.

  4. 通过查看根文件夹中的文件来验证安装。

    ls /greengrass/v2

    如果安装成功,则根文件夹包含多个文件夹,例如configpackages, 和logs.

如果您安装了Amazon IoT Greengrass核心软件作为系统服务,安装程序会为您运行该软件。否则,必须手动运行该软件。有关更多信息,请参阅运行Amazon IoT GreengrassCore 软件

有关如何配置和使用软件和Amazon IoT Greengrass中,请参阅: