如何用最新Git标签触发Terraform配置的AWS CodeCommit流水线

Terraform 没有原生内置的 Git 标签读取能力，但有两类成熟方案可以实现自动获取最新 Git 标签的需求，同时可以根据你的实际触发场景选择更简单的实现逻辑，不需要硬编码标签值。

场景1：需要所有新标签创建时自动触发流水线（无需动态取标签值） #

如果你要实现的效果是后续每创建一个新的 Git 标签，就自动触发 AWS 流水线，根本不需要动态获取最新标签值传入变量——你当前的事件规则写死referenceName是冗余的，直接移除该匹配项即可捕获所有标签创建/更新事件：

{
  "source"      = ["aws.codecommit"]
  "detail-type" = ["CodeCommit Repository State Change"]
  "resources"   = [data.aws_codecommit_xxxxxxxxx]
  "detail" = {
    "event"         = ["referenceCreated", "referenceUpdated"]
    "referenceType" = ["tag"]
    # 移除referenceName配置，即可匹配所有标签事件
    # 如果需要过滤特定前缀的标签，可以用前缀匹配，比如只匹配v开头的版本号：
    # "referenceName" = [{"prefix" = "v"}]
  }
}

注：如果你的代码实际存储在Gitlab而非AWS CodeCommit，需要将事件源替换为Gitlab webhook对接EventBridge的配置，否则CodeCommit事件源无法捕获Gitlab上的标签创建动作。

这种方式配置完成后永久生效，不需要每次发布新标签就重跑 Terraform 更新规则，是标签触发流水线的标准配置方式。

场景2：执行Terraform时需要获取最新标签作为参数传入 #

如果你需要在执行terraform apply的时点，自动获取仓库当前最新的标签作为参数（比如部署时手动触发一次流水线跑最新标签版本），可以选以下两种实现方式：

方案1：通过external数据源调用本地Git命令 #

该方案无额外依赖，只要执行 Terraform 的环境（本地终端、CI Runner）安装了 Git、有仓库访问权限即可使用。
配置示例：

# 调用本地git命令获取最新标签，通过jq输出为Terraform可识别的JSON格式
data "external" "latest_git_tag" {
  program = ["bash", "-c", "git fetch --tags && git describe --tags --abbrev=0 | jq -R --slurp '{tag: .}'"]
}

# 事件规则中直接引用取到的标签值
{
  "source"      = ["aws.codecommit"]
  "detail-type" = ["CodeCommit Repository State Change"]
  "resources"   = [data.aws_codecommit_xxxxxxxxx]
  "detail" = {
    "event"         = ["referenceCreated", "referenceUpdated"]
    "referenceType" = ["tag"]
    "referenceName" = [data.external.latest_git_tag.result.tag]
  }
}

注意：执行前确保本地Git凭证配置正确，git fetch --tags会先拉取远程最新标签列表，避免拿到本地缓存的旧标签。

方案2：通过Gitlab Provider直接拉取远程标签 #

如果你的 Terraform 执行环境无法直接通过Git协议访问仓库，可以用官方Gitlab Provider调用API拉取标签列表，排序后取最新值。
配置示例：

# 先配置Gitlab Provider，token需要有对应项目的读权限
provider "gitlab" {
  token = var.gitlab_access_token
}

# 拉取项目所有标签，按更新时间倒序排列
data "gitlab_project_tags" "repo_tags" {
  project  = var.gitlab_project_id
  order_by = "updated"
  sort     = "desc"
}

# 取排序后的第一个值就是最新创建的标签，直接引用即可
# 如需按语义化版本排序，可以用semver函数对标签列表做二次排序后取最大值
locals {
  latest_tag = data.gitlab_project_tags.repo_tags.tags[0].name
}

后续在事件规则里将var.repository_tag_version替换为local.latest_tag即可。

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