GCP共享VPC的Terraform描述配置与子网创建问题排查

问题根源 #

你混淆了google_compute_shared_vpc_host_project的作用：这个资源仅用于将指定项目启用为共享VPC主机，它不会创建VPC网络本身。你的子网配置错误地引用了该资源的ID，而子网需要的是实际VPC网络的资源路径，因此出现URL格式错误或资源找不到的问题。

同时，共享VPC的描述本质是给底层的VPC网络添加描述，而非给共享主机项目配置。

修正方案 #

1. 正确创建带描述的共享VPC网络 #

先通过google_compute_network创建VPC并添加描述，再将项目启用为共享VPC主机：

# 创建共享VPC网络（这里配置描述）
resource "google_compute_network" "dev_shared_vpc" {
  provider                = google.as_network_admin
  name                    = "dev-shared-vpc" # 替换为你的VPC名称
  auto_create_subnetworks = false # 共享VPC建议手动创建子网
  description             = "开发环境共享VPC，用于非生产业务资源" # 自定义描述
  project                 = google_project.dev-shared-vpc-host.project_id
}

# 将项目启用为共享VPC主机
resource "google_compute_shared_vpc_host_project" "dev_shared_vpc_host" {
  provider = google.as_network_admin
  project  = google_project.dev-shared-vpc-host.project_id
}

2. 修正子网配置 #

子网需要引用VPC网络的资源路径，而非共享主机项目的ID。使用google_compute_network的self_link字段即可：

resource "google_compute_subnetwork" "dev_subnetwork" {
  provider      = google.as_network_admin
  name          = var.vpc_and_subnet_info.for_dev_env.subnetwork.name
  ip_cidr_range = var.vpc_and_subnet_info.for_dev_env.subnetwork.ip_cidr_range
  region        = var.region
  secondary_ip_range {
    range_name    = var.vpc_and_subnet_info.for_dev_env.subnetwork.secondary_ip_range.name
    ip_cidr_range = var.vpc_and_subnet_info.for_dev_env.subnetwork.secondary_ip_range.ip_cidr_range
  }
  # 正确引用VPC网络的资源路径
  network = google_compute_network.dev_shared_vpc.self_link
  # 可选：若需明确指定项目，确保与VPC项目一致
  # project = google_project.dev-shared-vpc-host.project_id
}

关键注意事项 #

• 权限要求：确保Terraform使用的服务账号拥有Shared VPC Admin和Compute Network Admin权限，才能创建共享VPC及子网。
• 现有共享VPC导入：如果已经手动创建了共享VPC，可使用data "google_compute_network"导入现有资源，而非重新创建：

  data "google_compute_network" "existing_dev_shared_vpc" {
    provider = google.as_network_admin
    name     = "existing-dev-shared-vpc"
    project  = google_project.dev-shared-vpc-host.project_id
  }
  

  后续子网直接引用data.google_compute_network.existing_dev_shared_vpc.self_link即可。

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