如何配置recipe.YAML将C/C++编译文件部署至AWS Greengrass V2

C/C++编译产物和Python脚本的核心差异是二进制需要匹配设备架构、具备执行权限、自带/预装依赖库，不需要配置解释器运行时，只要按下面步骤配置就能正常部署运行，以下以helloworld.out为例说明。

前置检查（必须先做，否则部署必失败） #

• 确认二进制架构匹配：你编译出的helloworld.out必须和Greengrass核心设备的CPU架构、操作系统版本完全一致，比如核心设备是armv7l架构的Linux设备，就不能用x86_64环境下编译的二进制，否则运行时会报Exec format error。最稳妥的方式是直接在同架构同系统的环境下编译，交叉编译的产物必须先在同规格测试设备上验证可正常运行。
• 检查动态库依赖：将编译好的helloworld.out临时传到核心设备，执行ldd helloworld.out查看依赖的动态库，缺失的库要么提前安装到核心设备的系统库路径，要么和二进制一起打包进组件工件。

小技巧：编译时加-static参数做静态编译，把所有依赖库直接打包进二进制，能彻底避免动态库缺失问题，适合简单的单功能程序。

• 本地先给二进制加执行权限：执行chmod +x helloworld.out，避免打包过程中权限丢失。

recipe.yaml 核心配置修改 #

和Python组件的recipe相比，不需要声明Python运行时依赖，重点配置工件权限、启动路径、依赖环境即可，可直接参考下面的模板修改：

---
RecipeFormatVersion: "2020-01-25"
ComponentName: com.example.HelloWorldCpp
ComponentVersion: "1.0.0"
ComponentDescription: "C/C++编译的HelloWorld测试组件"
ComponentPublisher: "YourName"
# 依赖项仅保留Greengrass核心运行时，不需要加Python等解释器依赖
ComponentDependencies:
  aws.greengrass.Nucleus:
    VersionRequirement: ">=2.0.0 <3.0.0"
    DependencyType: HARD
Manifests:
  - Platform:
      os: linux
    Artifacts:
      - URI: "s3://你的组件工件存储桶路径/helloworld.out"
        # 必须给二进制加执行权限，否则拉取后无权限运行
        Permission:
          Read: OWNER
          Execute: OWNER
    Lifecycle:
      # 启动命令必须用Greengrass内置占位符写全路径，禁止写相对路径
      Run: "{artifacts:path}/helloworld.out"
      # 如果你打包了额外的动态库，加这行配置指定库搜索路径，静态编译可删掉
      Environment:
        LD_LIBRARY_PATH: "{artifacts:path}:{LD_LIBRARY_PATH}"

配置时注意几个关键点：

• 不要保留Python组件里常见的aws.greengrass.PythonRuntime类依赖，C/C++二进制不需要额外解释器。
• Artifacts块必须显式声明Execute: OWNER权限，Greengrass拉取工件时默认不会给执行权限，会直接报Permission denied。
• Run命令必须用{artifacts:path}占位符，Greengrass运行时会自动替换成核心设备上组件工件的实际绝对路径，写相对路径会找不到文件。
• 如果程序需要写临时文件、存日志，用{work:path}占位符指向组件可写工作目录，不要硬编码系统路径，避免权限不足。

GUI控制台部署步骤 #

1. 把准备好的helloworld.out（连带依赖的.so、配置文件如果有的话）上传到Greengrass核心设备有权限访问的S3存储桶。
2. 进入AWS控制台Greengrass服务页面，选择左侧「组件」菜单，点击「创建组件」，部署来源选择「从recipe创建组件」。
3. 上传你修改好的recipe.yaml，在工件映射步骤把S3上的helloworld.out和recipe里声明的URI对应上，提交创建组件，等组件状态变为「可用」。
4. 找到目标核心设备绑定的部署，点击「修订部署」，在组件选择页勾选你刚创建的com.example.HelloWorldCpp组件，后续步骤无特殊需求保持默认配置，提交部署。
5. 等待核心设备同步部署状态，部署完成后可以在核心设备的/greengrass/v2/logs/路径下找到对应组件的日志文件，看到程序正常输出、无报错即为运行成功。

常见踩坑排查 #

• 日志报Exec format error：100%是二进制架构和设备不匹配，重新对应架构编译即可。
• 日志报error while loading shared libraries: libxxx.so：对应动态库缺失，要么提前在核心设备安装对应系统包，要么把库文件打进工件配好LD_LIBRARY_PATH。
• 日志报Permission denied：要么是recipe里没给二进制加Execute权限，要么是你手动修改过Greengrass工作目录下的文件权限，改回recipe配置重新部署即可。

内容的提问来源于stack exchange，提问作者Linh.Pham