如何用Terraform的github_repository管理已有GitHub仓库？

通过Terraform创建新仓库的配置和流程正常，但手动创建仓库后，尝试用相同的github_repository资源配置为其添加描述等元数据时，触发报错：

422 Validation Failed [{Resource:Repository Field:name Code:custom Message:name already exists on this account}]

需要在不重建仓库（避免丢失内容）的前提下，用Terraform管理已有仓库的元数据。

核心是将已有仓库导入Terraform的状态管理，让Terraform识别到该仓库已存在，后续仅执行元数据更新操作，步骤如下：

1. 调整Terraform配置匹配已有仓库 #

确保github_repository资源块的配置与手动创建的仓库属性一致，重点匹配name、owner，同时填写需要设置的元数据（如description、visibility等）：

# repositories.tf
resource "github_repository" "terraform-created-repo" {
  name        = "terraform-created-repo" # 必须和已有仓库名称完全一致
  description = "This is a description"  # 要设置的元数据
  visibility  = "internal"               # 要设置的元数据
  has_issues  = true                     # 要设置的元数据
  # 注意：手动创建的仓库auto_init通常为false，需移除或改为false，避免与实际状态冲突
  # auto_init = true 
}

2. 导入已有仓库到Terraform状态 #

执行terraform import命令，将已有仓库关联到Terraform的资源状态中，命令格式：

terraform import github_repository.<资源标识符> <仓库所有者>/<仓库名称>

对应示例的命令：

terraform import github_repository.terraform-created-repo organization-name/terraform-created-repo

注意：替换命令中的organization-name为实际的组织/账户名，确保provider配置的owner与之一致。

3. 验证配置与状态一致性 #

执行terraform plan，检查输出结果，确认Terraform仅会更新仓库元数据，不会执行销毁或重建操作。如果出现意外的销毁计划，需检查配置中的属性（如auto_init）是否与实际仓库状态一致，调整后重新plan。

4. 应用配置更新元数据 #

确认plan结果符合预期后，执行：

terraform apply

Terraform会将配置中的元数据同步到已有仓库，不会影响仓库内的已有内容。

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