# googlecloudplatform/k8s-config-connector architecture

> Architecture diagram of the GitHub repository googlecloudplatform/k8s-config-connector, 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/googlecloudplatform/k8s-config-connector
- Repository: https://github.com/googlecloudplatform/k8s-config-connector

## Overview

Config Connector lets users declare Google Cloud resources as Kubernetes objects; controllers create, update, and continually reconcile cloud state to match those declarations. The graph follows that user-to-resource path and separates the Kubernetes API, reconciliation framework, and cloud-service integrations. Controller and emulator coverage is grouped at supported directory paths; the sampled controller excerpts show concrete BigQuery and Asset operations, while the README documents the overall reconciliation workflow. Other controller wiring is not shown, so those relationships are documented at the product level rather than inferred from imports.

Main entry points: [`pkg/controller/direct`](https://github.com/googlecloudplatform/k8s-config-connector/tree/master/pkg/controller/direct) (Direct controllers), [`apis`](https://github.com/googlecloudplatform/k8s-config-connector/tree/master/apis) (Resource APIs), [`cmd/manager/main.go`](https://github.com/googlecloudplatform/k8s-config-connector/blob/master/cmd/manager/main.go) (Controller manager), [`pkg/controller/direct/bigquerydataset/bigquerydataset_controller.go`](https://github.com/googlecloudplatform/k8s-config-connector/blob/master/pkg/controller/direct/bigquerydataset/bigquerydataset_controller.go) (BigQuery dataset)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Kubernetes interface"]
  node_manifests["Resource config"]
  node_crds["Resource APIs"]
  node_resource_types["Resource schemas"]
end

subgraph group_reconcile["Reconciliation"]
  node_manager["Controller manager<br/>[main.go]"]
  node_direct_framework["Direct framework"]
  node_direct_controllers["Direct controllers"]
  node_bigquery_dataset["BigQuery dataset"]
  node_bigquery_table["BigQuery table"]
  node_asset_query["Asset saved query"]
  node_other_controllers["Other sampled controllers"]
end

subgraph group_cloud["Cloud resources"]
  node_gcp{{"Google Cloud APIs"}}
  node_gcp_resources[("Managed resources")]
end

subgraph group_emulation["API emulation"]
  node_mock_services["Mock service handlers"]
  node_mock_storage[("Mock state storage")]
end

node_operator(("Config author"))

node_operator -->|"declares"| node_manifests
node_manifests -->|"applies as"| node_crds
node_crds -->|"defines"| node_resource_types
node_crds -->|"reconciles"| node_manager
node_manager -.->|"runs"| node_direct_framework
node_direct_framework -.->|"dispatches"| node_direct_controllers
node_direct_controllers -.->|"includes"| node_bigquery_dataset
node_direct_controllers -.->|"includes"| node_bigquery_table
node_direct_controllers -.->|"includes"| node_asset_query
node_direct_controllers -.->|"includes"| node_other_controllers
node_bigquery_dataset -->|"creates, updates, deletes"| node_gcp
node_bigquery_table -->|"gets, updates, deletes"| node_gcp
node_asset_query -->|"gets, creates, deletes"| node_gcp
node_gcp -->|"synchronizes state"| node_gcp_resources
node_mock_services -->|"reads and writes"| node_mock_storage

click node_crds "https://github.com/googlecloudplatform/k8s-config-connector/tree/master/apis"
click node_resource_types "https://github.com/googlecloudplatform/k8s-config-connector/blob/master/apis/storageinsights/v1alpha1/storageinsightsdatasetconfig_types.go"
click node_manager "https://github.com/googlecloudplatform/k8s-config-connector/blob/master/cmd/manager/main.go"
click node_direct_framework "https://github.com/googlecloudplatform/k8s-config-connector/tree/master/pkg/controller/direct"
click node_direct_controllers "https://github.com/googlecloudplatform/k8s-config-connector/tree/master/pkg/controller/direct"
click node_bigquery_dataset "https://github.com/googlecloudplatform/k8s-config-connector/blob/master/pkg/controller/direct/bigquerydataset/bigquerydataset_controller.go"
click node_bigquery_table "https://github.com/googlecloudplatform/k8s-config-connector/blob/master/pkg/controller/direct/bigquery/bigquerytable_controller.go"
click node_asset_query "https://github.com/googlecloudplatform/k8s-config-connector/blob/master/pkg/controller/direct/asset/assetsavedquery_controller.go"
click node_other_controllers "https://github.com/googlecloudplatform/k8s-config-connector/tree/master/pkg/controller/direct"
click node_mock_services "https://github.com/googlecloudplatform/k8s-config-connector/tree/master/mockgcp"
click node_mock_storage "https://github.com/googlecloudplatform/k8s-config-connector/tree/master/mockgcp/pkg/storage"

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_manifests,node_crds,node_resource_types toneBlue
class node_manager,node_direct_framework,node_direct_controllers,node_bigquery_dataset,node_bigquery_table,node_asset_query,node_other_controllers toneAmber
class node_gcp,node_gcp_resources toneMint
class node_mock_services,node_mock_storage toneRose
class node_operator toneIndigo
```

## Components

### Kubernetes interface

- **Resource config**
- [Resource APIs](https://github.com/googlecloudplatform/k8s-config-connector/tree/master/apis): `apis`
- [Resource schemas](https://github.com/googlecloudplatform/k8s-config-connector/blob/master/apis/storageinsights/v1alpha1/storageinsightsdatasetconfig_types.go): `apis/storageinsights/v1alpha1/storageinsightsdatasetconfig_types.go`

### Reconciliation

- [Controller manager](https://github.com/googlecloudplatform/k8s-config-connector/blob/master/cmd/manager/main.go): `cmd/manager/main.go`
- [Direct framework](https://github.com/googlecloudplatform/k8s-config-connector/tree/master/pkg/controller/direct): `pkg/controller/direct`
- [Direct controllers](https://github.com/googlecloudplatform/k8s-config-connector/tree/master/pkg/controller/direct): `pkg/controller/direct`
- [BigQuery dataset](https://github.com/googlecloudplatform/k8s-config-connector/blob/master/pkg/controller/direct/bigquerydataset/bigquerydataset_controller.go): `pkg/controller/direct/bigquerydataset/bigquerydataset_controller.go`
- [BigQuery table](https://github.com/googlecloudplatform/k8s-config-connector/blob/master/pkg/controller/direct/bigquery/bigquerytable_controller.go): `pkg/controller/direct/bigquery/bigquerytable_controller.go`
- [Asset saved query](https://github.com/googlecloudplatform/k8s-config-connector/blob/master/pkg/controller/direct/asset/assetsavedquery_controller.go): `pkg/controller/direct/asset/assetsavedquery_controller.go`
- [Other sampled controllers](https://github.com/googlecloudplatform/k8s-config-connector/tree/master/pkg/controller/direct): `pkg/controller/direct`

### Cloud resources

- **Google Cloud APIs**
- **Managed resources**

### API emulation

- [Mock service handlers](https://github.com/googlecloudplatform/k8s-config-connector/tree/master/mockgcp): `mockgcp`
- [Mock state storage](https://github.com/googlecloudplatform/k8s-config-connector/tree/master/mockgcp/pkg/storage): `mockgcp/pkg/storage`

### Other components

- **Config author**

## Connections

- Config author → Resource config: declares (evidence: `README.md`)
- Resource config → Resource APIs: applies as (evidence: `README.md`)
- Resource APIs → Resource schemas: defines (evidence: `README.md`)
- Resource APIs → Controller manager: reconciles (evidence: `README.md`)
- Controller manager → Direct framework: runs
- Direct framework → Direct controllers: dispatches
- Direct controllers → BigQuery dataset: includes (evidence: `pkg/controller/direct/bigquerydataset/bigquerydataset_controller.go`)
- Direct controllers → BigQuery table: includes (evidence: `pkg/controller/direct/bigquery/bigquerytable_controller.go`)
- Direct controllers → Asset saved query: includes (evidence: `pkg/controller/direct/asset/assetsavedquery_controller.go`)
- Direct controllers → Other sampled controllers: includes
- BigQuery dataset → Google Cloud APIs: creates, updates, deletes (evidence: `pkg/controller/direct/bigquerydataset/bigquerydataset_controller.go`)
- BigQuery table → Google Cloud APIs: gets, updates, deletes (evidence: `pkg/controller/direct/bigquery/bigquerytable_controller.go`)
- Asset saved query → Google Cloud APIs: gets, creates, deletes (evidence: `pkg/controller/direct/asset/assetsavedquery_controller.go`)
- Google Cloud APIs → Managed resources: synchronizes state (evidence: `README.md`)
- Mock service handlers → Mock state storage: reads and writes (evidence: `mockgcp/mockclouddeploy/deliverypipeline.go`)
