GitLab CI中Terraform计划报告生成失败：路径配置差异及plan.cache生成方法咨询

针对你遇到的GitLab CI Terraform计划报告失败的问题，我来逐一解答：

1. artifacts:paths 和 artifacts:reports:terraform 的区别 #

• artifacts:paths 是用来存储通用作业产物的，它的作用就是把指定路径的文件上传到GitLab，你可以在作业页面下载这些文件，或者传递给后续的CI阶段使用。它只是单纯保存文件，不会对文件内容做任何解析。
• artifacts:reports:terraform 是GitLab专为Terraform打造的报告集成能力，GitLab会自动读取并解析你指定的JSON格式Terraform计划文件，然后把变更内容可视化展示到合并请求（MR）界面中，让你不用打开日志就能看到基础设施的变更。它的核心是让GitLab识别并渲染Terraform计划结果，而不是单纯存储文件，而且指定的文件必须是合法的Terraform JSON计划格式，否则会解析失败。

2. 生成正确的plan文件并解决报错 #

你的当前配置存在几个关键问题，导致了文件找不到和报告生成失败：

• 你用terraform plan -out=plan.json生成的是二进制的Terraform计划文件，并不是JSON格式，只是文件名改成了.json而已，这会让GitLab无法正确解析。
• terraform show -json plan.json只是把JSON内容输出到控制台，没有写入到文件中，所以reports:terraform指定的plan.json其实没有正确生成。
• artifacts:paths里指定的plan.cache根本没被生成过，自然会提示找不到文件。

针对Terraform v1.1.0（没有terraform plan -json参数），正确的配置应该是这样：

plan:
  stage: plan
  script:
    # 先初始化Terraform（如果之前没加的话，这一步很重要）
    - terraform init
    # 生成二进制计划文件，路径对应artifacts里的plan.cache
    - terraform plan -out=${TF_ROOT}/plan.cache
    # 将二进制计划转换成JSON格式，写入plan.json供GitLab解析
    - terraform show -json ${TF_ROOT}/plan.cache > ${TF_ROOT}/plan.json
  artifacts:
    name: plan
    paths:
      # 保存二进制plan文件，方便后续apply阶段复用
      - ${TF_ROOT}/plan.cache
    reports:
      # 指定JSON格式的plan文件，让GitLab生成MR变更报告
      terraform: ${TF_ROOT}/plan.json

额外说明： #

• 如果你的Terraform代码就在项目根目录，${TF_ROOT}可以替换成./，或者直接写文件名（比如plan.cache）。
• 确保CI环境中的Terraform版本确实是v1.1.0，避免版本不匹配的问题。
• 运行terraform plan前一定要先执行terraform init，初始化Terraform工作目录，否则计划命令会失败。

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