将GitLab CI的Terraform流水线迁移至OpenTofu遇问题求助

错误1：plan job提示阶段不存在（配置B） #

报错信息：plan job: chosen stage does not exist; available stages are .pre, fmt, validate, plan, apply, .post
原因是你显式定义的stages列表和OpenTofu组件内部job绑定的阶段不兼容。该组件会自动生成完整的阶段链，手动指定stages可能导致内部job找不到对应阶段。
解决：

• 删除手动编写的stages: [fmt, validate, plan, apply]，让组件自动管理阶段；
• 若坚持自定义阶段，需确认组件内部所有job的stage名称，确保你的stages列表完全包含且顺序匹配（不推荐，直接使用组件默认配置更省心）。

错误2：fmt job继承锚点失败（配置C） #

报错信息：fmt: unknown keys in extends (.opentofu:fmt)
原因是你使用的OpenTofu组件未暴露.opentofu:fmt这类可继承的锚点，和旧版GitLab Terraform模板逻辑不同，该组件直接生成完整job，不提供可复用锚点供用户自定义。
解决：

• 不要手动定义fmt、validate这类job，组件会自动生成；
• 如需调整job行为，直接通过组件的inputs参数（如root_dir、opentofu_version）配置；
• 若必须自定义job，需完全重写配置，不要尝试继承组件内部未公开的锚点。

最终可用配置示例 #

结合你保留SAST-IaC、指定工作目录和状态名称的需求，可使用以下配置：

include:
  - component: gitlab.com/components/opentofu/validate-plan-apply@0.17.0
    inputs:
      opentofu_version: 1.6.1
      root_dir: provisioning
      state_name: iam
  - template: Jobs/SAST-IaC.latest.gitlab-ci.yml

# 如需添加全局变量或自定义脚本，可在此处配置
variables:
  TOFU_CACHE_KEY: iam

额外提示 #

• 本地tofu plan正常运行说明代码转换无问题，故障仅出在CI配置适配环节；
• SAST-IaC模板可与OpenTofu组件共存，会自动扫描指定目录下的IaC代码；
• 若需保留原Terraform模板中的build/deploy阶段划分，可通过组件参数调整job所属阶段，或在组件生成的job基础上添加自定义依赖。

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