# hashicorp/terraform-provider-google architecture

> Architecture diagram of the GitHub repository hashicorp/terraform-provider-google, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hashicorp/terraform-provider-google
- Repository: https://github.com/hashicorp/terraform-provider-google

## Overview

This repository implements the Terraform Google Cloud provider: Terraform configuration is handled by the provider, which registers resource and data-source schemas and manages Google Cloud resources through service-specific implementations and shared transport. The README documents the provider’s purpose; source-index references and excerpts support the registration and shared-runtime relationships shown. Several service implementations were not sampled, so their individual API-call details are not expanded.

Main entry points: [`google/transport/transport.go`](https://github.com/hashicorp/terraform-provider-google/blob/main/google/transport/transport.go) (HTTP transport), [`main.go`](https://github.com/hashicorp/terraform-provider-google/blob/main/main.go) (Plugin entry), [`google/provider/provider.go`](https://github.com/hashicorp/terraform-provider-google/blob/main/google/provider/provider.go) (SDK provider), [`google/registry/registry.go`](https://github.com/hashicorp/terraform-provider-google/blob/main/google/registry/registry.go) (Schema registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Provider entry"]
  node_main["Plugin entry<br/>[main.go]"]
  node_sdk_provider["SDK provider<br/>[provider.go]"]
  node_fw_provider["Framework provider"]
end

subgraph group_framework["Provider frameworks"]
end

subgraph group_services["Cloud services"]
  node_service_registration["Service registration"]
  node_service_schemas["Service schemas"]
  node_appengine["App Engine version"]
  node_blockchain["Blockchain nodes"]
  node_delivery_pipeline["Delivery pipeline"]
  node_compute_pool["Compute storage pool"]
  node_data_pipeline["Data pipeline"]
  node_search_engine["Search engine"]
  node_eventarc_pipeline["Eventarc pipeline"]
  node_healthcare_job["Healthcare job"]
  node_netapp_pool["NetApp storage pool"]
  node_oracle_vault["Oracle storage vault"]
  node_storage_bucket["Storage bucket"]
  node_batch_job["Storage batch job"]
  node_transfer_job["Storage transfer job"]
  node_private_cloud["VMware private cloud"]
end

subgraph group_runtime["Shared runtime"]
  node_registry["Schema registry<br/>[registry.go]"]
  node_transport["HTTP transport<br/>[transport.go]"]
end

node_terraform(("Terraform"))
node_google_cloud{{"Google Cloud"}}

node_terraform -->|"starts plugin"| node_main
node_main -->|"wires provider"| node_sdk_provider
node_main -->|"wires provider"| node_fw_provider
node_sdk_provider -->|"uses schemas"| node_registry
node_fw_provider -->|"uses schemas"| node_registry
node_sdk_provider -->|"loads services"| node_service_registration
node_service_registration -->|"imports services"| node_service_schemas
node_service_schemas -.->|"registers schemas"| node_registry
node_appengine -->|"uses transport"| node_transport
node_blockchain -->|"uses transport"| node_transport
node_delivery_pipeline -->|"uses DCL client"| node_transport
node_compute_pool -->|"uses transport"| node_transport
node_data_pipeline -->|"uses transport"| node_transport
node_search_engine -->|"uses transport"| node_transport
node_eventarc_pipeline -->|"uses transport"| node_transport
node_healthcare_job -->|"uses transport"| node_transport
node_netapp_pool -->|"uses transport"| node_transport
node_oracle_vault -->|"uses transport"| node_transport
node_storage_bucket -->|"uses transport"| node_transport
node_batch_job -->|"uses transport"| node_transport
node_transfer_job -->|"uses transport"| node_transport
node_private_cloud -->|"uses transport"| node_transport
node_transport -.->|"sends requests"| node_google_cloud

click node_main "https://github.com/hashicorp/terraform-provider-google/blob/main/main.go"
click node_sdk_provider "https://github.com/hashicorp/terraform-provider-google/blob/main/google/provider/provider.go"
click node_fw_provider "https://github.com/hashicorp/terraform-provider-google/blob/main/google/fwprovider/framework_provider.go"
click node_registry "https://github.com/hashicorp/terraform-provider-google/blob/main/google/registry/registry.go"
click node_service_registration "https://github.com/hashicorp/terraform-provider-google/blob/main/google/provider/provider_register_services.go"
click node_service_schemas "https://github.com/hashicorp/terraform-provider-google/tree/main/google/services"
click node_appengine "https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/appengine/resource_app_engine_flexible_app_version.go"
click node_blockchain "https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/blockchainnodeengine/resource_blockchain_node_engine_blockchain_nodes.go"
click node_delivery_pipeline "https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/clouddeploy/delivery_pipeline_internal.go"
click node_compute_pool "https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/compute/resource_compute_storage_pool.go"
click node_data_pipeline "https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/datapipeline/resource_data_pipeline_pipeline.go"
click node_search_engine "https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/discoveryengine/resource_discovery_engine_search_engine.go"
click node_eventarc_pipeline "https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/eventarc/resource_eventarc_pipeline.go"
click node_healthcare_job "https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/healthcare/resource_healthcare_pipeline_job.go"
click node_netapp_pool "https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/netapp/resource_netapp_storage_pool.go"
click node_oracle_vault "https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/oracledatabase/resource_oracle_database_exascale_db_storage_vault.go"
click node_storage_bucket "https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/storage/resource_storage_bucket.go"
click node_batch_job "https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/storagebatchoperations/resource_storage_batch_operations_job.go"
click node_transfer_job "https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/storagetransfer/resource_storage_transfer_job.go"
click node_private_cloud "https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/vmwareengine/resource_vmwareengine_private_cloud.go"
click node_transport "https://github.com/hashicorp/terraform-provider-google/blob/main/google/transport/transport.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_sdk_provider,node_fw_provider toneBlue
class node_service_registration,node_service_schemas,node_appengine,node_blockchain,node_delivery_pipeline,node_compute_pool,node_data_pipeline,node_search_engine,node_eventarc_pipeline,node_healthcare_job,node_netapp_pool,node_oracle_vault,node_storage_bucket,node_batch_job,node_transfer_job,node_private_cloud toneMint
class node_registry,node_transport toneRose
class node_terraform,node_google_cloud toneIndigo
```

## Components

### Provider entry

- [Plugin entry](https://github.com/hashicorp/terraform-provider-google/blob/main/main.go): `main.go`
- [SDK provider](https://github.com/hashicorp/terraform-provider-google/blob/main/google/provider/provider.go): `google/provider/provider.go`
- [Framework provider](https://github.com/hashicorp/terraform-provider-google/blob/main/google/fwprovider/framework_provider.go): `google/fwprovider/framework_provider.go`

### Cloud services

- [Service registration](https://github.com/hashicorp/terraform-provider-google/blob/main/google/provider/provider_register_services.go): `google/provider/provider_register_services.go`
- [Service schemas](https://github.com/hashicorp/terraform-provider-google/tree/main/google/services): `google/services`
- [App Engine version](https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/appengine/resource_app_engine_flexible_app_version.go): `google/services/appengine/resource_app_engine_flexible_app_version.go`
- [Blockchain nodes](https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/blockchainnodeengine/resource_blockchain_node_engine_blockchain_nodes.go): `google/services/blockchainnodeengine/resource_blockchain_node_engine_blockchain_nodes.go`
- [Delivery pipeline](https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/clouddeploy/delivery_pipeline_internal.go): `google/services/clouddeploy/delivery_pipeline_internal.go`
- [Compute storage pool](https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/compute/resource_compute_storage_pool.go): `google/services/compute/resource_compute_storage_pool.go`
- [Data pipeline](https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/datapipeline/resource_data_pipeline_pipeline.go): `google/services/datapipeline/resource_data_pipeline_pipeline.go`
- [Search engine](https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/discoveryengine/resource_discovery_engine_search_engine.go): `google/services/discoveryengine/resource_discovery_engine_search_engine.go`
- [Eventarc pipeline](https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/eventarc/resource_eventarc_pipeline.go): `google/services/eventarc/resource_eventarc_pipeline.go`
- [Healthcare job](https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/healthcare/resource_healthcare_pipeline_job.go): `google/services/healthcare/resource_healthcare_pipeline_job.go`
- [NetApp storage pool](https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/netapp/resource_netapp_storage_pool.go): `google/services/netapp/resource_netapp_storage_pool.go`
- [Oracle storage vault](https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/oracledatabase/resource_oracle_database_exascale_db_storage_vault.go): `google/services/oracledatabase/resource_oracle_database_exascale_db_storage_vault.go`
- [Storage bucket](https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/storage/resource_storage_bucket.go): `google/services/storage/resource_storage_bucket.go`
- [Storage batch job](https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/storagebatchoperations/resource_storage_batch_operations_job.go): `google/services/storagebatchoperations/resource_storage_batch_operations_job.go`
- [Storage transfer job](https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/storagetransfer/resource_storage_transfer_job.go): `google/services/storagetransfer/resource_storage_transfer_job.go`
- [VMware private cloud](https://github.com/hashicorp/terraform-provider-google/blob/main/google/services/vmwareengine/resource_vmwareengine_private_cloud.go): `google/services/vmwareengine/resource_vmwareengine_private_cloud.go`

### Shared runtime

- [Schema registry](https://github.com/hashicorp/terraform-provider-google/blob/main/google/registry/registry.go): `google/registry/registry.go`
- [HTTP transport](https://github.com/hashicorp/terraform-provider-google/blob/main/google/transport/transport.go): `google/transport/transport.go`

### Other components

- **Terraform**
- **Google Cloud**

## Connections

- Terraform → Plugin entry: starts plugin (evidence: `README.md`)
- Plugin entry → SDK provider: wires provider (evidence: `main.go`)
- Plugin entry → Framework provider: wires provider (evidence: `main.go`)
- SDK provider → Schema registry: uses schemas (evidence: `google/provider/provider.go`)
- Framework provider → Schema registry: uses schemas (evidence: `google/fwprovider/framework_provider.go`)
- SDK provider → Service registration: loads services (evidence: `google/provider/provider_register_services.go`)
- Service registration → Service schemas: imports services (evidence: `google/provider/provider_register_services.go`)
- Service schemas → Schema registry: registers schemas
- App Engine version → HTTP transport: uses transport (evidence: `google/services/appengine/resource_app_engine_flexible_app_version.go`)
- Blockchain nodes → HTTP transport: uses transport (evidence: `google/services/blockchainnodeengine/resource_blockchain_node_engine_blockchain_nodes.go`)
- Delivery pipeline → HTTP transport: uses DCL client (evidence: `google/services/clouddeploy/delivery_pipeline_internal.go`)
- Compute storage pool → HTTP transport: uses transport (evidence: `google/services/compute/resource_compute_storage_pool.go`)
- Data pipeline → HTTP transport: uses transport (evidence: `google/services/datapipeline/resource_data_pipeline_pipeline.go`)
- Search engine → HTTP transport: uses transport (evidence: `google/services/discoveryengine/resource_discovery_engine_search_engine.go`)
- Eventarc pipeline → HTTP transport: uses transport (evidence: `google/services/eventarc/resource_eventarc_pipeline.go`)
- Healthcare job → HTTP transport: uses transport (evidence: `google/services/healthcare/resource_healthcare_pipeline_job.go`)
- NetApp storage pool → HTTP transport: uses transport (evidence: `google/services/netapp/resource_netapp_storage_pool.go`)
- Oracle storage vault → HTTP transport: uses transport (evidence: `google/services/oracledatabase/resource_oracle_database_exascale_db_storage_vault.go`)
- Storage bucket → HTTP transport: uses transport (evidence: `google/services/storage/resource_storage_bucket.go`)
- Storage batch job → HTTP transport: uses transport (evidence: `google/services/storagebatchoperations/resource_storage_batch_operations_job.go`)
- Storage transfer job → HTTP transport: uses transport (evidence: `google/services/storagetransfer/resource_storage_transfer_job.go`)
- VMware private cloud → HTTP transport: uses transport (evidence: `google/services/vmwareengine/resource_vmwareengine_private_cloud.go`)
- HTTP transport → Google Cloud: sends requests
