# confluentinc/confluent-kubernetes-examples architecture

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

- Interactive diagram: https://gitdiagram.com/confluentinc/confluent-kubernetes-examples
- Repository: https://github.com/confluentinc/confluent-kubernetes-examples

## Overview

This repository is a catalog of Confluent for Kubernetes (CFK) scenario workflows, not a deployment controller or runtime library. Users choose an example, adapt its Kubernetes configuration, then use Helm and kubectl against a Kubernetes cluster to deploy or manage Confluent Platform. The examples cover quickstarts, security, networking, blueprints, scheduling, hybrid deployments, and operations. The README documents the overall workflow and several capabilities; links among individual scenario directories are not established by the sampled evidence.

Main entry points: [`README.md`](https://github.com/confluentinc/confluent-kubernetes-examples/blob/master/README.md) (Scenario catalog), [`quickstart-deploy`](https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/quickstart-deploy) (Quickstarts), [`blueprints`](https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/blueprints) (Deployment blueprints), [`advanced-configuration/pod-overlay`](https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/advanced-configuration/pod-overlay) (Pod overlays)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_deployment["Deployment scenarios"]
  node_quickstart["Quickstarts"]
  node_blueprints["Deployment blueprints"]
end

subgraph group_configuration["Platform configuration"]
  node_security["Security scenarios"]
  node_networking["Network access"]
  node_podoverlay["Pod overlays"]
  node_scheduling["Workload scheduling"]
  node_gateway["Gateway scenarios"]
end

subgraph group_operations["Operations"]
  node_monitoring["Monitoring scenarios"]
  node_recovery["KRaft recovery"]
  node_troubleshooting["Troubleshooting"]
end

subgraph group_integrations["Integrations"]
  node_flink["Flink scenarios"]
  node_hybrid["Hybrid deployments"]
  node_connectors["Connector examples"]
end

node_user(("Engineer"))
node_catalog["Scenario catalog<br/>[README.md]"]
node_kubernetes{{"Kubernetes cluster"}}
node_cfk{{"CFK operator"}}

node_user -->|"browses"| node_catalog
node_catalog -->|"offers scenario"| node_quickstart
node_catalog -->|"offers scenario"| node_blueprints
node_catalog -->|"lists examples"| node_security
node_catalog -->|"lists examples"| node_networking
node_catalog -->|"describes example"| node_podoverlay
node_catalog -->|"describes example"| node_scheduling
node_catalog -->|"lists scenarios"| node_hybrid
node_catalog -->|"lists scenarios"| node_monitoring
node_catalog -.-> node_gateway
node_catalog -.-> node_flink
node_catalog -.-> node_connectors
node_catalog -.-> node_recovery
node_catalog -.-> node_troubleshooting
node_quickstart -->|"deploys to"| node_kubernetes
node_blueprints -->|"configures deployments"| node_cfk
node_podoverlay -->|"extends pod specs"| node_cfk

click node_catalog "https://github.com/confluentinc/confluent-kubernetes-examples/blob/master/README.md"
click node_quickstart "https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/quickstart-deploy"
click node_blueprints "https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/blueprints"
click node_security "https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/security"
click node_networking "https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/networking"
click node_podoverlay "https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/advanced-configuration/pod-overlay"
click node_scheduling "https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/scheduling"
click node_gateway "https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/gateway"
click node_flink "https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/flink"
click node_hybrid "https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/hybrid"
click node_connectors "https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/connector"
click node_monitoring "https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/monitoring"
click node_recovery "https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/kraft/dynamic-quorum/disaster-recovery"
click node_troubleshooting "https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/troubleshooting"

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_quickstart,node_blueprints toneBlue
class node_security,node_networking,node_podoverlay,node_scheduling,node_gateway toneAmber
class node_monitoring,node_recovery,node_troubleshooting toneMint
class node_flink,node_hybrid,node_connectors toneRose
class node_user,node_kubernetes,node_cfk toneIndigo
class node_catalog toneTeal
```

## Components

### Deployment scenarios

- [Quickstarts](https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/quickstart-deploy): `quickstart-deploy`
- [Deployment blueprints](https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/blueprints): `blueprints`

### Platform configuration

- [Security scenarios](https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/security): `security`
- [Network access](https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/networking): `networking`
- [Pod overlays](https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/advanced-configuration/pod-overlay): `advanced-configuration/pod-overlay`
- [Workload scheduling](https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/scheduling): `scheduling`
- [Gateway scenarios](https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/gateway): `gateway`

### Operations

- [Monitoring scenarios](https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/monitoring): `monitoring`
- [KRaft recovery](https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/kraft/dynamic-quorum/disaster-recovery): `kraft/dynamic-quorum/disaster-recovery`
- [Troubleshooting](https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/troubleshooting): `troubleshooting`

### Integrations

- [Flink scenarios](https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/flink): `flink`
- [Hybrid deployments](https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/hybrid): `hybrid`
- [Connector examples](https://github.com/confluentinc/confluent-kubernetes-examples/tree/master/connector): `connector`

### Other components

- **Engineer**
- [Scenario catalog](https://github.com/confluentinc/confluent-kubernetes-examples/blob/master/README.md): `README.md`
- **Kubernetes cluster**
- **CFK operator**

## Connections

- Engineer → Scenario catalog: browses (evidence: `README.md`)
- Scenario catalog → Quickstarts: offers scenario (evidence: `README.md`)
- Scenario catalog → Deployment blueprints: offers scenario (evidence: `README.md`)
- Scenario catalog → Security scenarios: lists examples (evidence: `README.md`)
- Scenario catalog → Network access: lists examples (evidence: `README.md`)
- Scenario catalog → Pod overlays: describes example (evidence: `README.md`)
- Scenario catalog → Workload scheduling: describes example (evidence: `README.md`)
- Scenario catalog → Hybrid deployments: lists scenarios (evidence: `README.md`)
- Scenario catalog → Monitoring scenarios: lists scenarios (evidence: `README.md`)
- Scenario catalog → Gateway scenarios
- Scenario catalog → Flink scenarios
- Scenario catalog → Connector examples
- Scenario catalog → KRaft recovery
- Scenario catalog → Troubleshooting
- Quickstarts → Kubernetes cluster: deploys to (evidence: `README.md`)
- Deployment blueprints → CFK operator: configures deployments (evidence: `README.md`)
- Pod overlays → CFK operator: extends pod specs (evidence: `README.md`)
