快速安装

向设备提供 AWS 凭证

• 在您的设备上，通过执行以下操作之一来提供 AWS 凭证：

  • 使用 IAM 用户的长期凭证：

    1. 为您的 IAM 用户提供访问密钥 ID 和秘密访问密钥。有关如何检索长期凭证的更多信息，请参阅 IAM 用户指南中的管理 IAM 用户的访问密钥。

    2. 运行以下命令以向 AWS AWS IoT Greengrass 核心软件提供凭证。

       export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

  • （推荐）使用来自 IAM 角色的临时安全凭证：

    1. 提供您担任的 IAM 角色的访问密钥 ID、秘密访问密钥和会话令牌。有关如何检索这些凭证的更多信息，请参阅 IAM 用户指南中的将临时安全凭证与 AWS CLI 结合使用。

    2. 运行以下命令以向 AWS AWS IoT Greengrass 核心软件提供凭证。

       export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
       export AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=

下载 AWS AWS IoT Greengrass 核心软件 （Linux）

1. 在您的设备上，将 AWS AWS IoT Greengrass 核心软件下载到名为 的文件中greengrass-nucleus-latest-zip。

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

   下载此软件即表示您同意 Greengrass 核心软件许可协议。

2. 将 AWS AWS IoT Greengrass 核心软件解压缩到设备上的文件夹。Replace GreengrassCore 替换为您要使用的文件夹。

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

   提示

   您可以运行以下命令来查看 AWS AWS IoT Greengrass 核心软件版本。

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

安装 AWS AWS IoT Greengrass 核心软件 （Linux）

1. 运行 AWS AWS IoT Greengrass 核心安装程序。替换命令中的参数值，如下所示。

   1. /greengrass/v2：将 替换为用于安装 AWS AWS IoT Greengrass 核心软件的根文件夹的路径。

   2. GreengrassCore：如果您将安装程序解压缩到其他文件夹，请将此值替换为要使用的文件夹。

   3. region：将 替换为要在其中查找或创建资源的 AWS 区域。

   4. MyGreengrassCore：将 替换为 Greengrass 核心设备的 AWS AWS IoT 事物的名称。如果事物不存在，安装程序将创建它。安装程序将证书下载为 AWS AWS IoT 事物进行身份验证。

   5. MyGreengrassCoreGroup：将 替换为 Greengrass 核心设备的 AWS AWS IoT 事物组的名称。如果事物组不存在，安装程序将创建它并将事物添加到它。如果事物组存在并且具有活动部署，核心设备将下载并运行该部署指定的软件。

   6. MyGreengrassV2TokenExchangeRole：将 替换为允许 Greengrass 核心设备获取临时 AWS 凭证的 IAM 角色的名称。如果该角色不存在，安装程序将创建该角色，然后创建并附加名为 的策略MyGreengrassV2TokenExchangeRoleAccess。有关更多信息，请参阅授权核心设备与 AWS 服务交互。

   7. MyGreengrassCoreTokenExchangeRoleAlias：将 替换为允许 Greengrass 核心设备稍后获取临时凭证的 IAM 角色的别名。如果角色别名不存在，安装程序将创建别名并将其指向您指定的 IAM 角色。有关更多信息，请参阅授权核心设备与 AWS 服务交互。

   sudo -E java -Droot="/greengrass/v2" -Dlog.store=FILE \
     -jar ./GreengrassCore/lib/Greengrass.jar \
     --aws-region region \
     --thing-name MyGreengrassCore \
     --thing-group-name MyGreengrassCoreGroup \
     --tes-role-name MyGreengrassV2TokenExchangeRole \
     --tes-role-alias-name MyGreengrassCoreTokenExchangeRoleAlias \
     --component-default-user ggc_user:ggc_group \
     --provision true \
     --setup-system-service true

   如果成功，安装程序将打印以下消息：

   • 如果您指定 --provision，安装程序将打印 Successfully configured Nucleus with provisioned resource details （如果它已成功配置资源）。

   • 如果您指定 --deploy-dev-tools，安装程序将打印 Configured Nucleus to deploy aws.greengrass.Cli component （如果它已成功创建部署）。

   • 如果您指定 --setup-system-service true，安装程序将打印 Successfully set up Nucleus as a system service （如果它设置并将软件作为服务运行）。

   • 如果未指定 --setup-system-service true，Launched Nucleus successfully安装程序将在成功时输出并运行软件。

2. 如果您安装了 Greengrass 核心 v2 或更高版本，请跳过此步骤。如果您下载了最新版本的 软件，则已安装 v2 或更高版本。

   运行以下命令，为 AWS AWS IoT Greengrass 核心软件根文件夹设置所需的文件权限。Replace /greengrass/v2 替换为您在安装命令中指定的根文件夹，并替换 /greengrass 替换为您的根文件夹的父文件夹。

   sudo chmod 755 /greengrass/v2 && sudo chmod 755 /greengrass