如何在CodeBuild中获取CodePipeline源S3对象的自定义元数据并设为环境变量？

方案1：优化版AWS CLI + jq提取（最直接） #

你当前使用aws s3api head-object的思路完全可行，这里提供更简洁的优化方式：

• 借助CodeBuild的服务角色（需提前配置s3:GetObject权限），无需指定--profile参数
• 使用jq工具提取自定义元数据字段，直接导出为环境变量

单字段提取示例 #

# 提取名为`my-custom-key`的自定义元数据（注意S3元数据键会自动转为小写）
CUSTOM_META=$(aws s3api head-object --bucket your-bucket-name --key path/to/your-object.zip | jq -r '.Metadata["my-custom-key"]')

# 导出为环境变量，后续构建步骤可直接引用
export MY_CUSTOM_VARIABLE=$CUSTOM_META

多字段批量导出示例 #

# 将所有自定义元数据导出为前缀为`S3_META_`的环境变量（键名转为大写）
aws s3api head-object --bucket your-bucket-name --key path/to/your-object.zip | jq -r '.Metadata | to_entries[] | "export S3_META_\(.key | ascii_upcase)=\(.value)"' > s3-metadata-env.sh
source s3-metadata-env.sh

方案2：CodePipeline Lambda前置动作（集成化程度更高） #

如果希望元数据在CodeBuild启动前就完成注入，可以在CodePipeline中添加一个Lambda前置动作（放在S3源动作与CodeBuild动作之间）：

• Lambda函数调用s3api head-object获取目标对象的自定义元数据
• 通过CodePipeline API修改后续CodeBuild动作的环境变量配置，将元数据传入
• CodeBuild执行时可直接使用预设好的环境变量

该方案的优势是构建脚本更简洁，但需要额外维护Lambda函数及相关IAM权限。

方案3：结合CodeBuild源版本上下文（版本化对象专属） #

如果你的S3对象开启了版本控制，CodePipeline会将对象的VersionId传入CodeBuild的CODEBUILD_RESOLVED_SOURCE_VERSION环境变量，利用这个变量可以精准获取当前构建对应版本的元数据：

# 基于当前构建的源版本ID获取元数据
CUSTOM_META=$(aws s3api head-object --bucket your-bucket-name --key path/to/your-object.zip --version-id $CODEBUILD_RESOLVED_SOURCE_VERSION | jq -r '.Metadata["my-custom-key"]')
export MY_CUSTOM_VARIABLE=$CUSTOM_META

此方式能避免因对象更新导致的元数据不一致问题，仅适用于开启版本控制的S3存储桶。

方案对比 #

内容的提问来源于stack exchange，提问作者Jatin Mehrotra