Terraform优化：仅在src目录变更时生成Cloud Function压缩包

核心思路 #

利用Terraform的archive_file数据源计算src目录的内容哈希，只有当哈希变化（也就是src里的文件内容/结构改动）时，才触发ZIP打包、GCS上传和Cloud Function更新，其他Terraform文件的修改不会触发这些操作。

具体配置步骤 #

1. 用archive_file生成带内容哈希的ZIP #

定义archive_file数据源打包src目录，它会自动计算目录内容的哈希值——只有src里的文件变了，这个哈希才会更新。示例代码：

data "archive_file" "function_zip" {
  type        = "zip"
  source_dir  = "${path.module}/src"  # 替换为你的src目录实际路径
  output_path = "${path.module}/function.zip"

  # 可选：排除不需要打包的文件，比如临时文件、系统缓存
  excludes = [".gitignore", ".DS_Store", "tmp/*"]
}

2. 上传ZIP到Cloud Storage时绑定哈希 #

在GCS存储桶对象配置中，把哈希值作为文件名的一部分，同时用lifecycle规则指定只有哈希变化时才更新该对象：

resource "google_storage_bucket_object" "function_archive" {
  name   = "function/${archive_file.function_zip.source_content_hash}.zip"  # 哈希当文件名后缀，避免缓存冲突
  bucket = google_storage_bucket.function_bucket.name
  source = archive_file.function_zip.output_path

  lifecycle {
    # 仅当src内容哈希变化时，重新上传ZIP
    replace_triggered_by = [archive_file.function_zip.source_content_hash]
  }
}

把哈希加到文件名里还有个额外好处：每次更新都是新文件，不用担心Cloud Function读取旧缓存的问题，旧版本ZIP也能在GCS中保留（如果开启了版本控制）。

3. 让Cloud Function仅在ZIP变更时更新 #

最后在Cloud Function配置中，绑定GCS对象的同时，用lifecycle规则指定只有哈希变化时才更新函数：

resource "google_cloudfunctions_function" "my_function" {
  name        = "my-cloud-function"
  runtime     = "python311"  # 替换为你的函数运行时版本
  entry_point = "main"       # 对应main.py里的入口函数名

  source_archive_bucket = google_storage_bucket.function_bucket.name
  source_archive_object = google_storage_bucket_object.function_archive.name

  trigger_http = true
  available_memory_mb = 256

  lifecycle {
    # 仅当src内容哈希变化时，更新Cloud Function
    replace_triggered_by = [archive_file.function_zip.source_content_hash]
  }
}

额外小贴士 #

• 若不想在本地生成ZIP文件，可改用null_resource结合gsutil zip命令直接打包上传，但archive_file更符合Terraform声明式风格，维护起来更简单。
• 给GCS存储桶开启版本控制，旧函数包可保留，方便后续回滚。
• 改完配置后运行terraform plan验证：修改非src目录的Terraform文件时，archive_file、google_storage_bucket_object和google_cloudfunctions_function这三个资源不会被标记为需要更新，只有改动src内的文件才会触发变更。

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