配置 AWS IoT Greengrass 核心

通过端口 443 配置 MQTT

此功能需要AWS IoT GreengrassCore v1.7 或更高版本。

此过程使 Greengrass 核心能够使用端口 443 与 AWS IoT Core 进行 MQTT 消息传递。

1. 运行以下命令以停止 Greengrass 守护程序：

   cd /greengrass-root/ggc/core/
   sudo ./greengrassd stop

2. 打开 greengrass-root/config/config.json 以作为 su 用户进行编辑。

3. 在 coreThing 对象中，添加 iotMqttPort 属性，并将该属性的值设置为 443，如以下示例所示。

   {
       "coreThing" : {
           "caPath" : "root.ca.pem",
           "certPath" : "12345abcde.cert.pem",
           "keyPath" : "12345abcde.private.key",
           "thingArn" : "arn:aws:iot:us-west-2:123456789012:thing/core-thing-name",
           "iotHost" : "abcd123456wxyz-ats.iot.us-west-2.amazonaws.com",
           "iotMqttPort" : 443,
           "ggHost" : "greengrass-ats.iot.us-west-2.amazonaws.com",
           "keepAlive" : 600
       },
       ...
   }

4. 启动守护程序。

   cd /greengrass-root/ggc/core/
   sudo ./greengrassd start

通过端口 443 配置 HTTPS

此功能需要AWS IoT GreengrassCore v1.8 或更高版本。

该过程将核心配置为使用 443 进行 HTTPS 通信。

1. 运行以下命令以停止 Greengrass 守护程序：

   cd /greengrass-root/ggc/core/
   sudo ./greengrassd stop

2. 打开 greengrass-root/config/config.json 以作为 su 用户进行编辑。

3. 在 coreThing 对象中，添加 iotHttpPort 和 ggHttpPort 属性，如以下示例所示。

   {
       "coreThing" : {
           "caPath" : "root.ca.pem",
           "certPath" : "12345abcde.cert.pem",
           "keyPath" : "12345abcde.private.key",
           "thingArn" : "arn:aws:iot:us-west-2:123456789012:thing/core-thing-name",
           "iotHost" : "abcd123456wxyz-ats.iot.us-west-2.amazonaws.com",
           "iotHttpPort" : 443,
           "ggHost" : "greengrass-ats.iot.us-west-2.amazonaws.com",
           "ggHttpPort" : 443,
           "keepAlive" : 600
       },
       ...
   }

4. 启动守护程序。

   cd /greengrass-root/ggc/core/
   sudo ./greengrassd start

配置网络代理

此功能需要AWS IoT GreengrassCore v1.7 或更高版本。

该过程允许 AWS IoT Greengrass 通过 HTTP 或 HTTPS 网络代理连接到 Internet。

1. 运行以下命令以停止 Greengrass 守护程序：

   cd /greengrass-root/ggc/core/
   sudo ./greengrassd stop

2. 打开 greengrass-root/config/config.json 以作为 su 用户进行编辑。

3. 在coreThing对象中，添加networkProxy对象，如以下示例所示。

   {
       "coreThing" : {
           "caPath" : "root.ca.pem",
           "certPath" : "12345abcde.cert.pem",
           "keyPath" : "12345abcde.private.key",
           "thingArn" : "arn:aws:iot:us-west-2:123456789012:thing/core-thing-name",
           "iotHost" : "abcd123456wxyz-ats.iot.us-west-2.amazonaws.com",
           "ggHost" : "greengrass-ats.iot.us-west-2.amazonaws.com",
           "keepAlive" : 600,
           "networkProxy": {
               "noProxyAddresses" : "http://128.12.34.56,www.mywebsite.com",
               "proxy" : {
                   "url" : "https://my-proxy-server:1100",
                   "username" : "Mary_Major",
                   "password" : "pass@word1357"
               }
           }
       },
       ...
   }

4. 启动守护程序。

   cd /greengrass-root/ggc/core/
   sudo ./greengrassd start

配置写入目录

1. 运行以下命令以停止 AWS IoT Greengrass 守护程序：

   cd /greengrass-root/ggc/core/
   sudo ./greengrassd stop

2. 打开 greengrass-root/config/config.json 以作为 su 用户进行编辑。

3. 添加 writeDirectory 以作为参数并指定目标目录路径，如以下示例所示。

   {
       "coreThing": {
           "caPath": "root-CA.pem",
           "certPath": "hash.pem.crt",
           ...
       },
       ...
       "writeDirectory" : "/write-directory"
   }

   注意

   您可以更新writeDirectory设置所需的频率。在更新该设置后，AWS IoT Greengrass 在下次启动时使用新指定的写入目录，但不会从以前的写入目录中迁移内容。

4. 现已配置您的写入目录，您可以选择将 greengrass-root 目录指定为只读目录。有关说明，请参阅将 Greengrass 根目录指定为只读目录。

   否则，启动 AWS IoT Greengrass 守护程序：

   cd /greengrass-root/ggc/core/
   sudo ./greengrassd start

将 Greengrass 根目录指定为只读目录

只有在要将 Greengrass 根目录设为只读目录时，才请按照以下步骤操作。在开始执行之前，必须配置写入目录。

1. 授予对所需目录的访问权限：

   1. 为 config.json 所有者授予读写权限。

      sudo chmod 0600 /greengrass-root/config/config.json

   2. 将 ggc_user 指定为 certs 和 system Lambda 目录的所有者。

      sudo chown -R ggc_user:ggc_group /greengrass-root/certs/
      sudo chown -R ggc_user:ggc_group /greengrass-root/ggc/packages/1.11.3/lambda/

      注意

      默认情况下，ggc_user 和 ggc_group 帐户用于运行系统 Lambda 函数。如果您已配置组级别的默认访问身份来使用不同的账户，则应改为向该用户 (UID) 和组 (GID) 授予权限。

2. 使用所需的方法将 greengrass-root 目录指定为只读目录。

   注意

   要将 greengrass-root 目录指定为只读目录，一种方法是以只读方式挂载该目录。不过，要将无线 (OTA) 更新应用于挂载的目录中的 AWS IoT Greengrass 核心软件，必须先卸载该目录，然后在更新后重新安装该目录。您可以将这些 umount 和 mount 操作添加到 ota_pre_update 和 ota_post_update 脚本中。有关 OTA 更新的更多信息，请参阅Greengrass OTA 更新代理和使用 OTA 更新的托管 Respawn。

3. 启动守护程序。

   cd /greengrass-root/ggc/core/
   sudo ./greengrassd start

   如果未正确设置步骤 1 中的权限，则不会启动守护程序。

1. 获取目标 Greengrass 组和组版本的 ID。此过程假定这是最新的组和组版本。以下查询返回最近创建的组。

   aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"

   或者，您也可以按名称查询。系统不要求组名称是唯一的，所以可能会返回多个组。

   aws greengrass list-groups --query "Groups[?Name=='MyGroup']"

   注意

   您还可以在中找到这些值。AWS IoT控制台。组 ID 显示在组的设置页面上。组版本 ID 显示在组的部署页面上。

2. 从输出中的目标组复制 Id 和 LatestVersion 值。

3. 获取最新的组版本。

   • 将 group-id 替换为复制的 Id。

   • 将 latest-group-version-id 替换为复制的 LatestVersion。

   aws greengrass get-group-version \
   --group-id group-id \
   --group-version-id latest-group-version-id

4. 从输出中的 Definition 对象复制 CoreDefinitionVersionArn 以及所有其他组组件（FunctionDefinitionVersionArn 除外）的 ARN。在创建新的组版本时，将使用这些值。

5. 在输出的 FunctionDefinitionVersionArn 中，复制函数定义的 ID。该 ID 是 ARN 中的 functions 段后面的 GUID，如以下示例所示。

   arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/bcfc6b49-beb0-4396-b703-6dEXAMPLEcu5/versions/0f7337b4-922b-45c5-856f-1aEXAMPLEsf6

   注意

   或者，您可以通过运行create-function-definition命令，然后从输出中复制 ID。

6. 在函数定义中添加一个函数定义版本。

   • 使用为函数定义复制的 替换 function-definition-idId。

   • 将 arbitrary-function-id 替换为函数名称，如 spooler-function。

   • 将要在该版本中包含的任何 Lambda 函数添加到functions数组。您可以使用get-function-definition-version命令从现有的函数定义版本中获取 Greengrass Lambda 函数。

   警告

   确保为 GG_CONFIG_MAX_SIZE_BYTES 指定大于或等于 262144 的值。较小的大小将导致 AWS IoT Greengrass 核心软件无法启动。

   aws greengrass create-function-definition-version \
   --function-definition-id function-definition-id \
   --functions '[{"FunctionArn": "arn:aws:lambda:::function:GGCloudSpooler:1","FunctionConfiguration": {"Environment": {"Variables":{"GG_CONFIG_MAX_SIZE_BYTES":"2621440","GG_CONFIG_STORAGE_TYPE":"FileSystem"}},"Executable": "spooler","MemorySize": 32768,"Pinned": true,"Timeout": 3},"Id": "arbitrary-function-id"}]'

   注意

   如果您之前设置 GG_CONFIG_SUBSCRIPTION_QUALITY 环境变量以支持与 AWS IoT Core 的持久性会话，请将其包含在此函数实例中。

7. 从输出中复制函数定义版本的 Arn。

8. 创建一个包含系统 Lambda 函数的组版本。

   • 将 group-id 替换为组的 Id。

   • 将 core-definition-version-arn 替换为从最新组版本中复制的 CoreDefinitionVersionArn。

   • 使用为新函数定义版本复制的 替换 function-definition-version-arnArn。

   • 替换从最新组版本中复制的其他组组件（例如 SubscriptionDefinitionVersionArn 或 DeviceDefinitionVersionArn）的 ARN。

   • 删除任何未使用的参数。例如，如果组版本不包含任何资源，请删除 --resource-definition-version-arn。

   aws greengrass create-group-version \
   --group-id group-id \
   --core-definition-version-arn core-definition-version-arn \
   --function-definition-version-arn function-definition-version-arn \
   --device-definition-version-arn device-definition-version-arn \
   --logger-definition-version-arn logger-definition-version-arn \
   --resource-definition-version-arn resource-definition-version-arn \
   --subscription-definition-version-arn subscription-definition-version-arn

9. 从输出中复制 Version。这是新组版本的 ID。

10. 用新组版本替换组。

    • 使用为组复制的 替换 group-idId。

    • 使用为新组版本复制的 替换 group-version-idVersion。

    aws greengrass create-deployment \
    --group-id group-id \
    --group-version-id group-version-id \
    --deployment-type NewDeployment

1. 获取目标 Greengrass 组和组版本的 ID。此过程假定这是最新的组和组版本。以下查询返回最近创建的组。

   aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"

   或者，您也可以按名称查询。系统不要求组名称是唯一的，所以可能会返回多个组。

   aws greengrass list-groups --query "Groups[?Name=='MyGroup']"

   注意

   您还可以在中找到这些值。AWS IoT控制台。组 ID 显示在组的设置页面上。组版本 ID 显示在组的部署页面上。

2. 从输出中的目标组复制 Id 和 LatestVersion 值。

3. 获取最新的组版本。

   • 将 group-id 替换为复制的 Id。

   • 将 latest-group-version-id 替换为复制的 LatestVersion。

   aws greengrass get-group-version \
   --group-id group-id \
   --group-version-id latest-group-version-id

4. 从输出中的 Definition 对象复制 CoreDefinitionVersionArn 以及所有其他组组件（FunctionDefinitionVersionArn 除外）的 ARN。在创建新的组版本时，将使用这些值。

5. 在输出的 FunctionDefinitionVersionArn 中，复制函数定义的 ID。该 ID 是 ARN 中的 functions 段后面的 GUID，如以下示例所示。

   arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/bcfc6b49-beb0-4396-b703-6dEXAMPLEcu5/versions/0f7337b4-922b-45c5-856f-1aEXAMPLEsf6

   注意

   或者，您可以通过运行create-function-definition命令，然后从输出中复制 ID。

6. 在函数定义中添加一个函数定义版本。

   • 使用为函数定义复制的 替换 function-definition-idId。

   • 将 arbitrary-function-id 替换为函数名称，如 spooler-function。

   • 将要在该版本中包含的任何 Lambda 函数添加到functions数组。您可以使用get-function-definition-version命令从现有的函数定义版本中获取 Greengrass Lambda 函数。

   aws greengrass create-function-definition-version \
   --function-definition-id function-definition-id \
   --functions '[{"FunctionArn": "arn:aws:lambda:::function:GGCloudSpooler:1","FunctionConfiguration": {"Environment": {"Variables":{"GG_CONFIG_SUBSCRIPTION_QUALITY":"AtLeastOncePersistent"}},"Executable": "spooler","MemorySize": 32768,"Pinned": true,"Timeout": 3},"Id": "arbitrary-function-id"}]'

   注意

   如果您之前设置了GG_CONFIG_STORAGE_TYPE或者GG_CONFIG_MAX_SIZE_BYTES环境变量定义存储设置，将它们包含在此函数实例中。

7. 从输出中复制函数定义版本的 Arn。

8. 创建一个包含系统 Lambda 函数的组版本。

   • 将 group-id 替换为组的 Id。

   • 将 core-definition-version-arn 替换为从最新组版本中复制的 CoreDefinitionVersionArn。

   • 使用为新函数定义版本复制的 替换 function-definition-version-arnArn。

   • 替换从最新组版本中复制的其他组组件（例如 SubscriptionDefinitionVersionArn 或 DeviceDefinitionVersionArn）的 ARN。

   • 删除任何未使用的参数。例如，如果组版本不包含任何资源，请删除 --resource-definition-version-arn。

   aws greengrass create-group-version \
   --group-id group-id \
   --core-definition-version-arn core-definition-version-arn \
   --function-definition-version-arn function-definition-version-arn \
   --device-definition-version-arn device-definition-version-arn \
   --logger-definition-version-arn logger-definition-version-arn \
   --resource-definition-version-arn resource-definition-version-arn \
   --subscription-definition-version-arn subscription-definition-version-arn

9. 从输出中复制 Version。这是新组版本的 ID。

10. 用新组版本替换组。

    • 使用为组复制的 替换 group-idId。

    • 使用为新组版本复制的 替换 group-version-idVersion。

    aws greengrass create-deployment \
    --group-id group-id \
    --group-version-id group-version-id \
    --deployment-type NewDeployment

11. （可选）增加maxWorkItemCount属性。这可以帮助核心处理增加的 MQTT 流量和与本地目标的通信。

配置核心用于本地 MQTT 流量的端口号

1. 运行以下命令以停止 Greengrass 守护程序：

   cd /greengrass-root/ggc/core/
   sudo ./greengrassd stop

2. 打开 greengrass-root/config/config.json 以作为 su 用户进行编辑。

3. 在coreThing对象中，添加ggMqttPort属性并将值设置为要使用的端口号。有效值为 1024 到 65535。以下示例将端口号设置为9000.

   {
       "coreThing" : {
           "caPath" : "root.ca.pem",
           "certPath" : "12345abcde.cert.pem",
           "keyPath" : "12345abcde.private.key",
           "thingArn" : "arn:aws:iot:us-west-2:123456789012:thing/core-thing-name",
           "iotHost" : "abcd123456wxyz-ats.iot.us-west-2.amazonaws.com",
           "ggHost" : "greengrass-ats.iot.us-west-2.amazonaws.com",
           "ggMqttPort" : 9000,
           "keepAlive" : 600
       },
       ...
   }

4. 启动守护程序。

   cd /greengrass-root/ggc/core/
   sudo ./greengrassd start

5. 如果自动 IP 检测为核心启用，则配置完成。

   如果未启用自动 IP 检测，则必须更新内核的连接信息。这样，Greengrass 设备就可以在发现操作期间接收正确的端口号，以获取核心连接信息。您可以使用AWS IoT控制台或AWS IoT GreengrassAPI 更新核心连接信息。在此过程中，您仅更新端口号。核心的本地 IP 地址保持不变。

   更新核心（控制台）的连接信息

   1. 在组配置页面上，选择核心，然后选择核心。

   2. 在核心详细信息页面上，选择连接，然后选择编辑.

   3. 选择添加其他连接中，输入您当前的本地 IP 地址和新端口号。以下示例将端口号设置9000用于 IP 地址192.168.1.8.

      

   4. 删除过时的终端节点，然后选择更新

   更新核心的连接信息 (API)

   • 使用UpdateConnectivityInfoaction. 以下示例使用update-connectivity-info中的AWS CLI设置端口号9000用于 IP 地址192.168.1.8.

     aws greengrass update-connectivity-info \
         --thing-name "MyGroup_Core" \
         --connectivity-info "[{\"Metadata\":\"\",\"PortNumber\":9000,\"HostAddress\":\"192.168.1.8\",\"Id\":\"localIP_192.168.1.8\"},{\"Metadata\":\"\",\"PortNumber\":8883,\"HostAddress\":\"127.0.0.1\",\"Id\":\"localhost_127.0.0.1_0\"}]"

   注意

   还可以配置核心用于与 AWS IoT Core 进行 MQTT 消息传递的端口。有关更多信息，请参阅 通过端口 443 或网络代理进行连接。

1. 获取目标 Greengrass 组和组版本的 ID。此过程假定这是最新的组和组版本。以下查询返回最近创建的组。

   aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"

   或者，您也可以按名称查询。系统不要求组名称是唯一的，所以可能会返回多个组。

   aws greengrass list-groups --query "Groups[?Name=='MyGroup']"

   注意

   您还可以在中找到这些值。AWS IoT控制台。组 ID 显示在组的设置页面上。组版本 ID 显示在组的部署页面上。

2. 从输出中的目标组复制 Id 和 LatestVersion 值。

3. 获取最新的组版本。

   • 将 group-id 替换为复制的 Id。

   • 将 latest-group-version-id 替换为复制的 LatestVersion。

   aws greengrass get-group-version \
   --group-id group-id \
   --group-version-id latest-group-version-id

4. 从输出中的 Definition 对象复制 CoreDefinitionVersionArn 以及所有其他组组件（FunctionDefinitionVersionArn 除外）的 ARN。在创建新的组版本时，将使用这些值。

5. 从输出中的 FunctionDefinitionVersionArn，复制函数定义的 ID 和函数定义版本：

   arn:aws:greengrass:region:account-id:/greengrass/groups/function-definition-id/versions/function-definition-version-id

   注意

   您可以选择性地通过运行create-function-definition命令，然后从输出中复制 ID。

6. 使用 get-function-definition-version 命令可获取当前定义状态。使用函数定义 ID你复制的函数定义。例如，实例.

   aws greengrass get-function-definition-version
   --function-definition-id function-definition-id
   --function-definition-version-id function-definition-version-id
                   

   记下列出的函数配置。在创建新函数定义版本时，您需要包含这些内容，以防丢失当前定义设置。

7. 在函数定义中添加一个函数定义版本。

   • 使用为函数定义复制的 替换 function-definition-idId。例如，实例.

   • 将 arbitrary-function-id 替换为函数名称，如 auto-detection-function。

   • 将要在该版本中包含的所有 Lambda 函数添加到functions数组中列出的任何数组，例如上一步中列出的任何值。

   aws greengrass create-function-definition-version \
   --function-definition-id function-definition-id \
   --functions '[{"FunctionArn":"arn:aws:lambda:::function:GGIPDetector:1","Id":"arbitrary-function-id","FunctionConfiguration":{"Pinned":true,"MemorySize":32768,"Timeout":3}}]'\
   --region us-west-2

8. 从输出中复制函数定义版本的 Arn。

9. 创建一个包含系统 Lambda 函数的组版本。

   • 将 group-id 替换为组的 Id。

   • 将 core-definition-version-arn 替换为从最新组版本中复制的 CoreDefinitionVersionArn。

   • 使用为新函数定义版本复制的 替换 function-definition-version-arnArn。

   • 替换从最新组版本中复制的其他组组件（例如 SubscriptionDefinitionVersionArn 或 DeviceDefinitionVersionArn）的 ARN。

   • 删除任何未使用的参数。例如，如果组版本不包含任何资源，请删除 --resource-definition-version-arn。

   aws greengrass create-group-version \
   --group-id group-id \
   --core-definition-version-arn core-definition-version-arn \
   --function-definition-version-arn function-definition-version-arn \
   --device-definition-version-arn device-definition-version-arn \
   --logger-definition-version-arn logger-definition-version-arn \
   --resource-definition-version-arn resource-definition-version-arn \
   --subscription-definition-version-arn subscription-definition-version-arn

10. 从输出中复制 Version。这是新组版本的 ID。

11. 用新组版本替换组。

    • 使用为组复制的 替换 group-idId。

    • 使用为新组版本复制的 替换 group-version-idVersion。

    aws greengrass create-deployment \
    --group-id group-id \
    --group-version-id group-version-id \
    --deployment-type NewDeployment