Terraform上传本地文件至GitHub仓库遇404及文件名过长问题求助

排查404错误根源 #

之前的404问题大概率是令牌权限不足或资源配置路径错误：

• 令牌必须包含repo权限（私有仓库需repo完整范围，公开仓库至少public_repo），仅添加workflows权限不足以操作仓库文件，因为读写仓库内容需要仓库级别的权限。
• 检查github_repository_file资源的repository字段是否完全匹配仓库全名（格式为用户名/仓库名），file字段的路径是否符合GitHub仓库的结构（避免带本地相对路径前缀，比如本地文件是./scripts/deploy.yaml，仓库内路径只需写scripts/deploy.yaml）。

解决“文件名过长”错误 #

GitHub对仓库内文件的完整路径总长度（含分支、目录路径、文件名）限制为255个字符，你遇到的问题是因为Terraform传递给GitHub API的文件路径超出了这个限制：

• 简化仓库内的文件路径：比如本地文件在./long/directory/structure/very-long-filename.yaml，可在Terraform中把file字段设为configs/deploy.yaml，缩短路径长度。
• 避免直接复用本地文件的绝对路径：如果用path.module拼接路径，可能会把本地的长目录结构带入仓库路径，手动指定仓库内的短路径即可。

正确配置示例 #

resource "github_repository_file" "static_config" {
  repository     = "your-username/your-target-repo"
  branch         = "main"
  file           = "configs/deploy.yaml" # 仓库内的短路径
  content        = file("${path.module}/local-files/deploy.yaml") # 本地文件的实际路径
  commit_message = "Add static config via Terraform"
}

额外注意事项 #

• 本地文件校验：用yamllint校验时直接对本地文件运行yamllint local-files/deploy.yaml即可，确保文件合法后再传入Terraform。
• 权限验证：可用curl快速验证令牌权限：

  curl -H "Authorization: token YOUR_GITHUB_TOKEN" https://api.github.com/repos/your-username/your-target-repo/contents/
  

  能正常返回仓库内容则说明权限配置正确。

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