如何在Terraform中仅当源文件变更时构建Docker镜像（跨平台哈希问题）

你的问题核心是Mac与Linux环境下，Terraform生成的目录哈希值不一致，根源主要有两个：文件遍历顺序不稳定、文件内容（如换行符）存在跨平台差异。以下是几个可靠的解决方法：

1. 稳定文件遍历顺序 #

fileset返回的文件列表顺序不保证跨平台一致，直接拼接会导致哈希结果变化。通过sort()函数强制排序，确保不同系统下文件处理顺序统一：

dir_hash = sha256(join("", [for f in sort(fileset(path.root, "../modules/gcp_gke_cluster/files/email_sender/*")) : filesha256(f) if basename(f) != ".DS_Store"]))

2. 统一文件内容格式 #

Mac与Linux的文本文件换行符可能存在差异（比如部分文件在Mac上保存为CRLF，Linux上为LF），导致单个文件的filesha256结果不同。可以通过以下方式统一：

• 在项目根目录添加.gitattributes文件，强制指定文本文件的换行符为LF：

  *.py text eol=lf
  *.sh text eol=lf
  *.txt text eol=lf
  # 根据你的文件类型补充规则
  

• 在.gitignore中加入.DS_Store，避免Mac自动生成的隐藏文件被纳入哈希计算。

3. 基于归档文件生成哈希（最彻底） #

使用Terraform的archive_file数据源将目标目录打包为稳定的归档文件（如ZIP），再对归档文件计算哈希。这种方式会统一文件的权限、排序、格式，完全消除跨平台差异：

data "archive_file" "email_sender" {
  type        = "zip"
  source_dir  = "../modules/gcp_gke_cluster/files/email_sender"
  output_path = "${path.module}/email_sender_temp.zip"
  excludes    = [".DS_Store"]
}

locals {
  dir_hash_cluster_notifications = filesha256(data.archive_file.email_sender.output_path)
}

resource "null_resource" "docker_build" {
  triggers = {
    dir_hash = local.dir_hash_cluster_notifications
  }
}

注意：将output_path指定的临时归档文件加入.gitignore，避免提交到代码仓库。

内容的提问来源于stack exchange，提问作者Jack-of-some