使用Terraform从模板创建GitLab项目时遇导入失败错误求助

通过Terraform从模板创建GitLab项目时，项目已成功创建但Terraform报错。相关配置代码如下：

resource "gitlab_project" "services_projects" {
  for_each = local.service_projects
  name                            = "${each.key}"
  default_branch                  = "main"
  description                     = ""
  issues_enabled                  = false
  merge_requests_enabled          = false
  namespace_id                    = "${gitlab_group.services_group.id}"
  snippets_enabled                = false
  visibility_level                = "private"
  wiki_enabled                    = false
  use_custom_template             = "${each.value.use_custom_template}"
  template_project_id             = "${each.value.template_project_id}"
  group_with_project_templates_id = var.group_with_project_templates_id
}

执行后项目实际已创建成功，但Terraform抛出错误：

module.services["test_tf_1"].gitlab_project.services_projects["values"]: Destruction complete after 5s
75module.services["test_tf_1"].gitlab_project.services_projects["values"]: Creating...
76╷
77│ Error: error while waiting for project "values" import to finish: unexpected state 'failed', wanted target 'finished'. last error: %!s(<nil>)
78│ 
79│   with module.services["test_tf_bb_1"].gitlab_project.services_projects["values"],
80│   on modules/gitlab/main.tf line 132, in resource "gitlab_project" "services_projects":
81│  132: resource "gitlab_project" "services_projects" {
82│ 
83╵

85
Cleaning up project directory and file based variables
00:01
87ERROR: Job failed: command terminated with exit code 1

怀疑错误和template_link有关，但不理解其概念，尝试创建也未解决问题。

错误原因分析 #

这个报错是Terraform等待GitLab完成模板导入时，发现导入状态变为failed但未获取到具体错误信息导致的。常见触发原因包括：

• 参数冲突：同时设置template_project_id（单个模板项目）和group_with_project_templates_id（组级模板库），GitLab无法确定模板来源，引发导入逻辑冲突。
• 权限不足：Terraform使用的GitLab令牌无模板项目读取权限，或无目标命名空间的项目创建权限。
• 模板项目异常：模板项目已归档、删除，或分支/文件存在访问限制，无法被复制导入。
• API延迟：模板导入是异步操作，Terraform等待超时或GitLab内部处理缓慢导致状态判断异常。

解决方法 #

1. 修正参数冲突 #

若使用单个模板项目创建新项目，仅保留template_project_id和use_custom_template = true，移除group_with_project_templates_id参数（该参数用于组级模板库，与单个模板项目导入逻辑互斥）。修改后的核心配置：

use_custom_template = each.value.use_custom_template
template_project_id = each.value.template_project_id
# 移除 group_with_project_templates_id 配置行

2. 验证权限配置 #

• 确保Terraform的GitLab令牌拥有：模板项目的read_repository权限、目标命名空间的create_projects权限。
• 检查模板项目未被归档，且令牌所属用户能正常访问该模板项目。

3. 延长超时时间 #

若因GitLab API处理缓慢导致超时，可增加创建超时配置：

resource "gitlab_project" "services_projects" {
  # 原有配置...
  timeouts {
    create = "10m" # 延长至10分钟，默认通常为5分钟
  }
}

4. 排查模板项目问题 #

• 手动通过GitLab UI使用该模板创建项目，确认模板本身是否可用（比如是否存在默认分支、文件是否正常）。
• 若模板为私有项目，确保令牌用户在模板项目的成员列表中。

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