配置 AWS IoT Greengrass 核心

通过端口 443 配置 MQTT

此功能需要 AWS IoT Greengrass 核心 v1.7 or later。

此过程使 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 Greengrass 核心 v1.8 or later。

该过程将核心配置为使用 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 Greengrass 核心 v1.7 or later。

该过程允许 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.0/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 组和组版本的 IDs。此过程假定这是最新的组和组版本。以下查询返回最近创建的组。

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

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

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

   注意

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

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

3. 获取最新的组版本。

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

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

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

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

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. 在函数定义中添加一个函数定义版本。

   • Replace function-definition-id 替换为Id您为函数定义复制的 。

   • Replace 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 函数的组版本。

   • Replace group-id 替换为 Id（对于组）。

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

   • Replace function-definition-version-arn 替换为您为新函数定义版本复制的 Arn。

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

   • 删除任何未使用的参数。例如，如果组版本不包含任何资源，请删除 --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. 用新组版本替换组。

    • Replace group-id 替换为您为组复制的 Id。

    • Replace group-version-id 替换为您为新组版本复制的 Version。

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

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

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

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

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

   注意

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

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

3. 获取最新的组版本。

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

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

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

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

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. 在函数定义中添加一个函数定义版本。

   • Replace function-definition-id 替换为Id您为函数定义复制的 。

   • Replace 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 函数的组版本。

   • Replace group-id 替换为 Id（对于组）。

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

   • Replace function-definition-version-arn 替换为您为新函数定义版本复制的 Arn。

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

   • 删除任何未使用的参数。例如，如果组版本不包含任何资源，请删除 --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. 用新组版本替换组。

    • Replace group-id 替换为您为组复制的 Id。

    • Replace group-version-id 替换为您为新组版本复制的 Version。

    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 Greengrass API 更新核心连接信息。对于此过程，您仅更新端口号。核心的本地 IP 地址保持不变。

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

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

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

   3. 选择 Add another connection （添加另一个连接），输入您的当前本地 IP 地址和新端口号。以下示例设置 IP 地址 9000 的端口号192.168.1.8。

      

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

   更新核心的连接信息 （API）

   • 使用 UpdateConnectivityInfo 操作。以下示例update-connectivity-info在 中使用 AWS CLI 设置 IP 地址 9000 的端口号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 组和组版本的 IDs。此过程假定这是最新的组和组版本。以下查询返回最近创建的组。

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

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

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

   注意

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

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

3. 获取最新的组版本。

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

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

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

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

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 命令可获取当前定义状态。使用 function-definition-id 您为 函数定义复制的 。例如，4d941bc7-92a1-4f45-8d64-EXAMPLEf76c3.

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

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

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

   • Replace function-definition-id 替换为Id您为函数定义复制的 。例如，4d941bc7-92a1-4f45-8d64-EXAMPLEf76c3.

   • Replace 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 函数的组版本。

   • Replace group-id 替换为 Id（对于组）。

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

   • Replace function-definition-version-arn 替换为您为新函数定义版本复制的 Arn。

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

   • 删除任何未使用的参数。例如，如果组版本不包含任何资源，请删除 --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. 用新组版本替换组。

    • Replace group-id 替换为您为组复制的 Id。

    • Replace group-version-id 替换为您为新组版本复制的 Version。

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