# kubernetes-sigs/cloud-provider-kind architecture

> Architecture diagram of the GitHub repository kubernetes-sigs/cloud-provider-kind, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kubernetes-sigs/cloud-provider-kind
- Repository: https://github.com/kubernetes-sigs/cloud-provider-kind

## Overview

cloud-provider-kind is a cloud provider for KIND clusters, supplying Kubernetes LoadBalancer support and Gateway API and Ingress handling. The primary workflow is to discover KIND clusters, connect to their Kubernetes APIs, watch Services, and provision proxy containers that expose them; the provider reports the resulting addresses through Kubernetes. Gateway and Ingress controllers are additional route-management branches. The graph reflects documented behavior and indexed dependencies; some controller internals are unsampled, so unverified subsystem wiring is omitted.

Main entry points: [`pkg/controller/controller.go`](https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/pkg/controller/controller.go) (Cluster controller), [`pkg/loadbalancer/server.go`](https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/pkg/loadbalancer/server.go) (LoadBalancer server), [`pkg/gateway/controller.go`](https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/pkg/gateway/controller.go) (Gateway controller), [`pkg/ingress/controller.go`](https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/pkg/ingress/controller.go) (Ingress controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Provider runtime"]
  node_entry["CLI entry<br/>[main.go]"]
  node_commands["Command setup<br/>[app.go]"]
  node_clusterloop["Cluster controller<br/>[controller.go]"]
end

subgraph group_service["LoadBalancer services"]
  node_cloudprovider["Cloud provider<br/>[cloud.go]"]
  node_lbserver["LoadBalancer server<br/>[server.go]"]
  node_proxyconfig["Proxy configuration<br/>[proxy.go]"]
end

subgraph group_routes["Route management"]
  node_gatewaycontroller["Gateway controller<br/>[controller.go]"]
  node_gatewayroutes["Gateway routes<br/>[httproute.go]"]
  node_gatewayresources["Gateway resources<br/>[gateway.go]"]
  node_crdmanager["Gateway CRDs<br/>[crd_manager.go]"]
  node_ingress["Ingress controller<br/>[controller.go]"]
end

subgraph group_infra["Runtime infrastructure"]
  node_proxycontainer["Proxy containers<br/>[container.go]"]
  node_tunnels["Port tunnels<br/>[tunnel.go]"]
end

node_operator(("Operator"))
node_kind[("KIND clusters")]
node_kubeapi[("Kubernetes API")]

node_operator -->|"runs"| node_entry
node_entry -->|"starts"| node_commands
node_commands -->|"runs"| node_clusterloop
node_clusterloop -->|"discovers"| node_kind
node_clusterloop -->|"connects"| node_kubeapi
node_clusterloop -->|"creates"| node_cloudprovider
node_clusterloop -->|"starts"| node_gatewaycontroller
node_clusterloop -->|"starts"| node_ingress
node_cloudprovider -->|"delegates to"| node_lbserver
node_lbserver -->|"updates"| node_proxyconfig
node_lbserver -->|"creates"| node_proxycontainer
node_lbserver -->|"manages"| node_tunnels
node_lbserver -.->|"reports status"| node_kubeapi
node_gatewaycontroller -->|"reconciles"| node_kubeapi
node_gatewaycontroller -.->|"processes"| node_gatewayroutes
node_gatewaycontroller -.->|"reconciles"| node_gatewayresources
node_ingress -->|"reconciles"| node_kubeapi
node_ingress -->|"creates"| node_gatewayresources
node_ingress -.->|"creates"| node_gatewayroutes
node_clusterloop -.->|"installs CRDs"| node_crdmanager

click node_entry "https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/main.go"
click node_commands "https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/cmd/app.go"
click node_clusterloop "https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/pkg/controller/controller.go"
click node_cloudprovider "https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/pkg/provider/cloud.go"
click node_lbserver "https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/pkg/loadbalancer/server.go"
click node_proxyconfig "https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/pkg/loadbalancer/proxy.go"
click node_proxycontainer "https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/pkg/container/container.go"
click node_tunnels "https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/pkg/tunnels/tunnel.go"
click node_gatewaycontroller "https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/pkg/gateway/controller.go"
click node_gatewayroutes "https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/pkg/gateway/httproute.go"
click node_gatewayresources "https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/pkg/gateway/gateway.go"
click node_crdmanager "https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/pkg/gateway/crd_manager.go"
click node_ingress "https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/pkg/ingress/controller.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_entry,node_commands,node_clusterloop toneBlue
class node_cloudprovider,node_lbserver,node_proxyconfig,node_kind,node_kubeapi toneAmber
class node_gatewaycontroller,node_gatewayroutes,node_gatewayresources,node_crdmanager,node_ingress toneMint
class node_proxycontainer,node_tunnels toneRose
class node_operator toneIndigo
```

## Components

### Provider runtime

- [CLI entry](https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/main.go): `main.go`
- [Command setup](https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/cmd/app.go): `cmd/app.go`
- [Cluster controller](https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/pkg/controller/controller.go): `pkg/controller/controller.go`

### LoadBalancer services

- [Cloud provider](https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/pkg/provider/cloud.go): `pkg/provider/cloud.go`
- [LoadBalancer server](https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/pkg/loadbalancer/server.go): `pkg/loadbalancer/server.go`
- [Proxy configuration](https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/pkg/loadbalancer/proxy.go): `pkg/loadbalancer/proxy.go`

### Route management

- [Gateway controller](https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/pkg/gateway/controller.go): `pkg/gateway/controller.go`
- [Gateway routes](https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/pkg/gateway/httproute.go): `pkg/gateway/httproute.go`
- [Gateway resources](https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/pkg/gateway/gateway.go): `pkg/gateway/gateway.go`
- [Gateway CRDs](https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/pkg/gateway/crd_manager.go): `pkg/gateway/crd_manager.go`
- [Ingress controller](https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/pkg/ingress/controller.go): `pkg/ingress/controller.go`

### Runtime infrastructure

- [Proxy containers](https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/pkg/container/container.go): `pkg/container/container.go`
- [Port tunnels](https://github.com/kubernetes-sigs/cloud-provider-kind/blob/main/pkg/tunnels/tunnel.go): `pkg/tunnels/tunnel.go`

### Other components

- **Operator**
- **KIND clusters**
- **Kubernetes API**

## Connections

- Operator → CLI entry: runs (evidence: `README.md`)
- CLI entry → Command setup: starts (evidence: `main.go`)
- Command setup → Cluster controller: runs (evidence: `cmd/app.go`)
- Cluster controller → KIND clusters: discovers (evidence: `README.md`)
- Cluster controller → Kubernetes API: connects (evidence: `pkg/controller/controller.go`)
- Cluster controller → Cloud provider: creates (evidence: `pkg/controller/controller.go`)
- Cluster controller → Gateway controller: starts (evidence: `pkg/controller/controller.go`)
- Cluster controller → Ingress controller: starts (evidence: `pkg/controller/controller.go`)
- Cloud provider → LoadBalancer server: delegates to (evidence: `pkg/provider/cloud.go`)
- LoadBalancer server → Proxy configuration: updates (evidence: `pkg/loadbalancer/server.go`)
- LoadBalancer server → Proxy containers: creates (evidence: `pkg/loadbalancer/server.go`)
- LoadBalancer server → Port tunnels: manages (evidence: `pkg/loadbalancer/server.go`)
- LoadBalancer server → Kubernetes API: reports status
- Gateway controller → Kubernetes API: reconciles (evidence: `pkg/gateway/controller.go`)
- Gateway controller → Gateway routes: processes
- Gateway controller → Gateway resources: reconciles
- Ingress controller → Kubernetes API: reconciles (evidence: `pkg/ingress/controller.go`)
- Ingress controller → Gateway resources: creates (evidence: `pkg/ingress/controller.go`)
- Ingress controller → Gateway routes: creates
- Cluster controller → Gateway CRDs: installs CRDs
