如何在AWS Lambda中获取AWS CodeBuild环境变量CODEBUILD_RESOLVED_SOURCE_VERSION

方法一：CodeBuild直接更新Lambda环境变量 #

CodeBuild本身内置了环境变量CODEBUILD_RESOLVED_SOURCE_VERSION，它就是触发本次构建的Git提交SHA值，无需额外拉取。你可以通过AWS CLI在构建过程中直接更新Lambda的环境变量：

1. 配置权限：给CodeBuild的服务角色添加lambda:UpdateFunctionConfiguration权限，确保它能修改Lambda配置。
2. 编写buildspec.yml命令：
   • 如果Lambda没有其他环境变量，直接设置：

     aws lambda update-function-configuration \
       --function-name 你的Lambda函数名 \
       --environment "Variables={GIT_COMMIT_SHA=$CODEBUILD_RESOLVED_SOURCE_VERSION}"
     

   • 如果Lambda已有其他环境变量，需要先获取现有变量并合并，避免覆盖（需确保CodeBuild环境安装了jq工具）：

     # 获取现有环境变量
     EXISTING_VARS=$(aws lambda get-function-configuration --function-name 你的Lambda函数名 --query 'Environment.Variables' --output json)
     # 合并新的SHA变量
     UPDATED_VARS=$(echo "$EXISTING_VARS" | jq --arg sha "$CODEBUILD_RESOLVED_SOURCE_VERSION" '.GIT_COMMIT_SHA = $sha')
     # 更新Lambda配置
     aws lambda update-function-configuration \
       --function-name 你的Lambda函数名 \
       --environment "Variables=$UPDATED_VARS"
     

方法二：通过基础设施即代码（IaC）传递 #

如果你的Lambda是用CloudFormation或CDK部署的，可以在CodeBuild中把SHA作为参数传递给部署命令，让IaC工具自动设置环境变量：

用CloudFormation的情况 #

1. 在buildspec.yml中传递SHA参数：

   aws cloudformation update-stack \
     --stack-name 你的CloudFormation栈名 \
     --template-body file://你的模板文件.yml \
     --parameters ParameterKey=GitCommitSha,ParameterValue=$CODEBUILD_RESOLVED_SOURCE_VERSION
   

2. 在CloudFormation模板中引用该参数配置Lambda：

   Resources:
     MyLambdaFunction:
       Type: AWS::Lambda::Function
       Properties:
         Environment:
           Variables:
             GIT_COMMIT_SHA: !Ref GitCommitSha
         # 其他Lambda配置（代码包、角色等）
   

用CDK的情况 #

1. 在buildspec.yml中通过上下文参数传递SHA：

   cdk deploy --context gitCommitSha=$CODEBUILD_RESOLVED_SOURCE_VERSION
   

2. 在CDK代码中获取上下文并设置到Lambda：

   import * as lambda from 'aws-cdk-lib/aws-lambda';
   import { Stack, StackProps } from 'aws-cdk-lib';
   import { Construct } from 'constructs';
   
   export class MyStack extends Stack {
     constructor(scope: Construct, id: string, props?: StackProps) {
       super(scope, id, props);
       
       const gitCommitSha = this.node.tryGetContext('gitCommitSha');
       
       new lambda.Function(this, 'MyLambda', {
         runtime: lambda.Runtime.NODEJS_18_X,
         code: lambda.Code.fromAsset('lambda'),
         handler: 'index.handler',
         environment: {
           GIT_COMMIT_SHA: gitCommitSha,
           // 其他环境变量
         }
       });
     }
   }
   

注意事项 #

• 权限配置是核心：确保CodeBuild角色拥有对应操作的权限（Lambda更新或CloudFormation栈更新）。
• 避免环境变量丢失：直接更新Lambda时，一定要合并现有变量，不要直接覆盖。
• CODEBUILD_RESOLVED_SOURCE_VERSION的有效性：这个变量只在CodeBuild构建过程中存在，对应触发构建的Git提交，无需额外执行git rev-parse HEAD之类的命令。

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