本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
安装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核心软件
-
在您的设备上,下载Amazon IoT Greengrass核心软件转换为名为
greengrass-nucleus-latest.zip
.curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip
一旦下载此软件,即表示您同意Greengrass 核心软件许可协议
. -
解压缩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 软件。
-
(可选)运行以下命令,查看Amazon IoT GreengrassCore 软件。
java -jar ./
GreengrassCore
/lib/Greengrass.jar --version
安装 Amazon IoT Greengrass Core 软件
使用指定以下操作的参数运行安装程序:
-
从部分配置文件进行安装,该文件指定使用自定义置备插件来置备Amazon资源的费用。这些区域有:Amazon IoT Greengrass核心软件使用配置文件,用于指定设备上每个 Greengrass 组件的配置。安装程序将根据您提供的部分配置文件创建完整的配置文件,并且Amazon自定义置备插件创建的资源。
-
使用
ggc_user
系统用户和ggc_group
系统组以在核心设备上运行软件组件。如果此默认用户和组不存在,则安装程序将创建这些用户和组。 -
将软件安装为启动时运行的系统服务,如果您的设备具有systemd
init 系统。
有关可以指定的参数的详细信息,请参阅安装程序参数.
如果您运行Amazon IoT Greengrass在内存有限的设备上,您可以控制Amazon IoT GreengrassCore 软件使用。要控制内存分配,可以在jvmOptions
配置参数。有关更多信息,请参阅使用 JVM 选项控制内存分配。
安装Amazon IoT Greengrass核心软件
-
检查版本Amazon IoT GreengrassCore 软件。
-
Replace
绿色草原
将替换为包含软件的文件夹的路径。
java -jar ./
GreengrassCore
/lib/Greengrass.jar --version -
-
使用文本编辑器创建名为
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: ""然后,执行以下操作:
-
Replace
2.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: "" -
-
运行安装程序。指定
--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. -
-
通过查看根文件夹中的文件来验证安装。
ls
/greengrass/v2
如果安装成功,则根文件夹包含多个文件夹,例如
config
、packages
, 和logs
.
如果您安装了Amazon IoT Greengrass核心软件作为系统服务,安装程序会为您运行该软件。否则,必须手动运行该软件。有关更多信息,请参阅运行Amazon IoT GreengrassCore 软件。
有关如何配置和使用软件和Amazon IoT Greengrass中,请参阅: