如何在IAC配置中设置AWS CodeBuild执行完整git克隆

1. CodeBuild项目IAC定义（codebuild.yaml）配置 #

CodeBuild默认执行深度为1的浅克隆，你可以直接在项目资源定义的Source属性下修改GitCloneDepth字段实现完整克隆，该字段值设为0时代表拉取仓库全量提交历史：

# CloudFormation 示例
Resources:
  MyBuildProject:
    Type: AWS::CodeBuild::Project
    Properties:
      Name: your-project-name
      Source:
        Type: CODECOMMIT # 可替换为GITHUB、BITBUCKET等对应源类型
        Location: <你的仓库地址>
        GitCloneDepth: 0 # 核心配置，0代表完整克隆

如果用Terraform定义CodeBuild项目，对应在source块中设置git_clone_depth = 0即可。

2. buildspec.yaml 补充配置（可选） #

如果你不方便修改项目层面的IAC定义，也可以在构建流程中手动执行命令取消浅克隆限制：

version: 0.2
phases:
  install:
    commands:
      # 拉取全量提交历史，取消浅克隆限制
      - git fetch --unshallow
      # 如需拉取所有分支的全量历史可以追加以下命令
      - git fetch --all

注意：如果仓库提交历史量级很大，完整克隆会增加构建启动耗时，你也可以根据实际业务需要调整GitCloneDepth为固定数值，只要数值大于等于你需要查询的文件修改日期对应的提交跨度，就可以正常获取到文件更新时间。

配置验证 #

你可以在构建阶段添加命令确认是否已经拿到全量历史：

build:
  commands:
    - git log --oneline | wc -l # 输出的提交数和仓库总提交数一致即为完整克隆生效

内容的提问来源于stack exchange，提问作者conner.xyz