如何配置让GCP Cloud Function基于Git标签自动重部署？

问题根源 #

当你将配置从commit_sha切换到tag_name后，Terraform无法自动识别标签的重新创建或指向的更新——因为标签是可变的Git引用，而非固定唯一的提交哈希值。即使Cloud Build触发了代码重新构建，Terraform会认为Cloud Function的配置没有发生变化，因此不会触发重部署操作。

解决方案 #

你需要让Terraform能够感知到标签的更新，以下是几种可行的修改方案：

方案1：引入标签对应的最新提交SHA作为触发依据 #

通过外部数据源获取目标标签当前指向的最新提交SHA，将其传入source_version字段，同时结合lifecycle规则强制触发更新：

# 获取标签对应的最新提交SHA
data "external" "latest_tag_sha" {
  program = ["bash", "-c", "gcloud source repos describe ${var.xxx_repo_name} --project=${var.project} --format='value(tags.${var.xxx_tag_name}.commitSha)'"]
}

resource "google_cloudfunctions_function" "your_function" {
  # 保留原有其他配置（如name、region、available_memory_mb等）
  
  build_config {
    runtime     = var.xxx_runtime
    entry_point = var.xxx_entry_point
    source {
      repo_source {
        project_id     = var.project
        repo_name      = var.xxx_repo_name
        tag_name       = var.xxx_tag_name
        source_version = data.external.latest_tag_sha.result.sha
      }
    }
  }

  # 强制当SHA变化时重新部署
  lifecycle {
    replace_triggered_by = [data.external.latest_tag_sha.result.sha]
  }
}

方案2：添加随标签更新的可变元数据字段 #

在Cloud Function资源中添加version_label或description字段，将标签信息与时间戳绑定，让Terraform检测到配置变化：

resource "google_cloudfunctions_function" "your_function" {
  # 保留原有其他配置
  
  # 用标签名+时间戳作为版本标识，每次标签更新时触发变更
  version_label = "tag-${var.xxx_tag_name}-${timestamp()}"

  build_config {
    runtime     = var.xxx_runtime
    entry_point = var.xxx_entry_point
    source {
      repo_source {
        project_id   = var.project
        repo_name    = var.xxx_repo_name
        tag_name     = var.xxx_tag_name
      }
    }
  }
}

方案3：利用GCP数据源跟踪标签状态 #

使用google_source_repo_tag数据源直接获取标签的详细信息，让Terraform感知标签的更新：

data "google_source_repo_tag" "target_tag" {
  project = var.project
  repo    = var.xxx_repo_name
  tag     = var.xxx_tag_name
}

resource "google_cloudfunctions_function" "your_function" {
  # 保留原有其他配置
  
  build_config {
    runtime     = var.xxx_runtime
    entry_point = var.xxx_entry_point
    source {
      repo_source {
        project_id   = var.project
        repo_name    = var.xxx_repo_name
        tag_name     = var.xxx_tag_name
      }
    }
  }

  # 当标签指向的提交或标签本身更新时，重新部署
  lifecycle {
    replace_triggered_by = [data.google_source_repo_tag.target_tag.id]
  }
}

核心逻辑 #

本质是让Terraform能够捕获到"标签更新"这个事件——因为标签本身是可变引用，Terraform默认不会跟踪其指向内容的变化，所以必须引入一个随标签更新而变化的标识，让Terraform识别到配置需要更新，从而触发Cloud Function的重部署。

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