From 5dba35c0ed97286b1d218e2545bf868a8fec5ed0 Mon Sep 17 00:00:00 2001 From: Wei Cao Date: Wed, 8 Apr 2026 22:46:47 +0800 Subject: [PATCH] docs: simplify architecture diagrams by removing operator control plane section MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Remove the "Management Plane · KubeBlocks Operator" section from all 21 architecture diagram components (operator block, controller chips, CRD hierarchy chain) - Remove sidebar cards that added noise without architectural value: resource hierarchy cards, group replication info card (MySQL MGR), standalone characteristics and HA limitations (Milvus standalone), routing card (MongoDB sharding), orchestrator features card, cluster properties card (Redis cluster), use cases card (Redis standalone) - Redesign PgHA Patroni DCS card: move from right sidebar to a dedicated panel below the pod grid with a teal connector arrow, making it clear that all pods share the same DCS backend - Fix JSX comment syntax errors in Milvus, MinIO, and RocketMQ diagrams introduced during bulk edits --- .../03-architecture.mdx | 14 + .../03-architecture.mdx | 22 +- .../kubeblocks-for-kafka/03-architecture.mdx | 4 + .../kubeblocks-for-milvus/03-architecture.mdx | 22 ++ .../03-architecture.mdx | 12 +- .../kubeblocks-for-mysql/03-architecture.mdx | 20 +- .../kubeblocks-for-redis/03-architecture.mdx | 36 +- .../03-architecture.mdx | 13 + .../03-architecture.mdx | 8 + .../03-architecture.mdx | 22 +- .../kubeblocks-for-kafka/03-architecture.mdx | 4 + .../kubeblocks-for-milvus/03-architecture.mdx | 10 + .../kubeblocks-for-redis/03-architecture.mdx | 33 +- .../03-architecture.mdx | 13 + .../03-architecture.mdx | 8 + .../ClickhouseArchitectureDiagram.tsx | 162 +------- .../ElasticsearchArchitectureDiagram.tsx | 163 +-------- src/components/EtcdArchitectureDiagram.tsx | 165 +-------- src/components/KafkaArchitectureDiagram.tsx | 165 +-------- .../KafkaCombinedArchitectureDiagram.tsx | 136 +------ src/components/MilvusArchitectureDiagram.tsx | 160 -------- .../MilvusStandaloneArchitectureDiagram.tsx | 115 ------ src/components/MinioArchitectureDiagram.tsx | 157 -------- src/components/MongodbArchitectureDiagram.tsx | 164 --------- .../MongodbShardingArchitectureDiagram.tsx | 153 -------- src/components/MysqlArchitectureDiagram.tsx | 168 +-------- .../MysqlMGRArchitectureDiagram.tsx | 119 ------ .../MysqlOrchestratorArchitectureDiagram.tsx | 99 ----- src/components/PgHaArchitectureDiagram.tsx | 345 ++++++------------ src/components/QdrantArchitectureDiagram.tsx | 162 +------- .../RabbitmqArchitectureDiagram.tsx | 163 +-------- src/components/RedisArchitectureDiagram.tsx | 165 +-------- .../RedisClusterArchitectureDiagram.tsx | 145 -------- .../RedisStandaloneArchitectureDiagram.tsx | 226 ++++++++++++ .../RocketmqArchitectureDiagram.tsx | 158 -------- .../ZookeeperArchitectureDiagram.tsx | 166 +-------- 36 files changed, 567 insertions(+), 3130 deletions(-) create mode 100644 src/components/RedisStandaloneArchitectureDiagram.tsx diff --git a/docs/en/preview/kubeblocks-for-clickhouse/03-architecture.mdx b/docs/en/preview/kubeblocks-for-clickhouse/03-architecture.mdx index 69ecf65..f1ec718 100644 --- a/docs/en/preview/kubeblocks-for-clickhouse/03-architecture.mdx +++ b/docs/en/preview/kubeblocks-for-clickhouse/03-architecture.mdx @@ -101,6 +101,20 @@ For direct pod addressing (replication traffic, ClickHouse Keeper communication) {pod-name}.{cluster}-{shardComponentName}-headless.{namespace}.svc.cluster.local ``` +## Automatic Failover + +ClickHouse does not use a primary/replica role distinction at the application level — all replicas within a shard are equivalent and can serve queries. Recovery after a pod failure does not involve a role switch: + +1. **A replica pod crashes** — the failed pod stops serving queries for its shard +2. **CH Keeper detects the lost connection** (`topology: cluster` only) — remaining replicas continue serving if at least one replica is healthy; Keeper tracks which data parts each replica holds +3. **KubeBlocks restarts the failed pod** — the InstanceSet controller schedules a pod restart +4. **Recovered replica reconnects to CH Keeper** — the pod re-registers and fetches data parts it missed during downtime from peer replicas automatically +5. **ClusterIP service is unchanged** — all replicas are equivalent; no endpoint update is needed; the recovered pod resumes receiving traffic once it passes its readiness check + +:::note +Steps 2 and 4 require `topology: cluster` (CH Keeper deployed). In `topology: standalone`, no Keeper is present — inter-replica part synchronization is not available unless an external ZooKeeper or Keeper is configured. +::: + ## System Accounts KubeBlocks automatically manages the following ClickHouse system account. Passwords are auto-generated and stored in a Secret named `{cluster}-{component}-account-{name}`. diff --git a/docs/en/preview/kubeblocks-for-elasticsearch/03-architecture.mdx b/docs/en/preview/kubeblocks-for-elasticsearch/03-architecture.mdx index b7163bd..eebfd74 100644 --- a/docs/en/preview/kubeblocks-for-elasticsearch/03-architecture.mdx +++ b/docs/en/preview/kubeblocks-for-elasticsearch/03-architecture.mdx @@ -41,18 +41,32 @@ Every Elasticsearch pod runs three main containers (plus three init containers o Each pod mounts its own **PVC** for the Elasticsearch data directory (`/usr/share/elasticsearch/data`), providing independent persistent storage per node. -## Node Roles +## Node roles (Elasticsearch) -Elasticsearch supports multiple node roles, and KubeBlocks maps each role to a dedicated Component: +Elasticsearch nodes are configured with **roles** (master-eligible, data, ingest, coordinating, etc.). The sections below describe what each role means for **capacity and HA**. -| Node Role | Responsibility | +| Node role | Responsibility | |-----------|----------------| | **Master-eligible** | Participates in leader election; manages cluster state, index mappings, and shard allocation | | **Data** | Stores shard data; handles indexing and search requests for its assigned shards | | **Ingest** | Pre-processes documents before indexing via ingest pipelines | | **Coordinating** (optional) | Routes client requests to the appropriate data nodes and aggregates results | -In smaller deployments, a single node type can hold all roles. For production, dedicated master, data, and ingest components improve stability and resource isolation. +In smaller deployments, one process can hold several roles. In production, splitting roles across nodes improves stability. + +## Topologies and component names (ClusterDefinition) + +In the **kubeblocks-addons** Elasticsearch chart, **`spec.topology`** selects a layout. KubeBlocks creates **one Component per entry** in that topology; component **names** are short labels (`master`, `dit`, `mdit`, …), while the **Elasticsearch role set** is defined inside the image/config for each layout. + +| Topology (`spec.topology`) | Components created | Notes | +|---------------------------|-------------------|--------| +| `single-node` | `mdit` | Single-node layout | +| `multi-node` (chart default) | `master`, `dit` | Split layout: dedicated `master` Component plus `dit` Component for the remaining node group | +| `m-dit` | `master`, `dit` | Same component names as `multi-node`; chart distinguishes layouts for ordering/defaults | +| `mdit` | `mdit` | Combined multi-role naming under one component | +| `m-d-i-t` | `m`, `d`, `i`, `t` | Dedicated components per role family (master / data / ingest / coordinating) | + +Service names look like `{cluster}-{component}-http` — the **`{component}`** segment is the KubeBlocks Component name above (for example `mdit`, `master`, `dit`), not the long English phrase “master-eligible”. Use your Cluster’s `status` or `kubectl get component -n ` to see the exact names for a running cluster. ## High Availability via Cluster Coordination diff --git a/docs/en/preview/kubeblocks-for-kafka/03-architecture.mdx b/docs/en/preview/kubeblocks-for-kafka/03-architecture.mdx index 20358a2..1649cf9 100644 --- a/docs/en/preview/kubeblocks-for-kafka/03-architecture.mdx +++ b/docs/en/preview/kubeblocks-for-kafka/03-architecture.mdx @@ -21,6 +21,10 @@ KubeBlocks supports three Kafka deployment topologies: The `*_monitor` variants add a standalone `kafka-exporter` Component that scrapes Kafka-specific metrics (consumer group lag, partition offsets, topic throughput) and exposes them on port 9308 for Prometheus. +:::note +**Configuration templates and `configs`:** the Kafka `ComponentDefinition` treats main config slots (for example **`kafka-configuration-tpl`**) as **externally managed** in current addon charts. When you create a `Cluster`, you must **wire those slots** by setting **`configs`** on the matching component (or sharding template) to ConfigMaps whose keys match the template file names — typically the ConfigMaps shipped with the addon in **`kb-system`**, or your own copies in the application namespace. If provisioning fails with a message about missing templates, compare your manifest to the **Kafka examples** in [kubeblocks-addons](https://github.com/apecloud/kubeblocks-addons/tree/main/examples/kafka) for the same chart version. +::: + --- ## Combined Architecture (combined / combined_monitor) diff --git a/docs/en/preview/kubeblocks-for-milvus/03-architecture.mdx b/docs/en/preview/kubeblocks-for-milvus/03-architecture.mdx index e0c9277..75cbca1 100644 --- a/docs/en/preview/kubeblocks-for-milvus/03-architecture.mdx +++ b/docs/en/preview/kubeblocks-for-milvus/03-architecture.mdx @@ -114,6 +114,18 @@ Only the `proxy` container exposes port 19530 (gRPC) for client traffic. All com | **Segment redundancy** | Sealed segments persist in MinIO; a restarted QueryNode reloads them from object storage without data loss | | **MixCoord recovery** | MixCoord is stateless against etcd — it reloads all coordinator state from etcd on restart | +### MixCoord Recovery + +MixCoord is the only single-replica component in the Distributed topology. When it crashes, KubeBlocks automatically recovers it without data loss: + +1. **MixCoord pod crashes** — coordinator functions (DDL, segment lifecycle, query assignments, index scheduling) are temporarily unavailable +2. **KubeBlocks InstanceSet detects the pod failure** and schedules a restart +3. **New MixCoord pod starts** and reloads all coordinator state from etcd — no data is lost because MixCoord is fully stateless against etcd +4. **Worker nodes reconnect** — QueryNode, DataNode, and IndexNode pods reconnect to the restored MixCoord and resume their assigned work +5. **Cluster resumes serving requests** through the Proxy + +Worker nodes (QueryNode, DataNode, IndexNode) run multiple replicas and tolerate individual pod failures without coordinator involvement — KubeBlocks restarts the failed pod, and MixCoord reassigns its work to healthy replicas. + ### Traffic Routing | Service | Type | Port | Selector | @@ -121,3 +133,13 @@ Only the `proxy` container exposes port 19530 (gRPC) for client traffic. All com | `{cluster}-proxy` | ClusterIP | 19530 (gRPC), 9091 (metrics/health) | proxy pods | Client applications (Milvus SDK) connect to the proxy on port 19530 (gRPC). Port 9091 is the metrics/health endpoint — it is not a client-facing REST API. The proxy is the single entry point — it handles authentication, routing, and result aggregation across worker components. + +## System Accounts + +In the Milvus add-on, only the **in-cluster MinIO object-storage** Component (ComponentDefinition `milvus-minio`) declares KubeBlocks **`systemAccounts`**. Other Milvus stack components in this add-on (for example **etcd**, **milvus**, **proxy**, **mixcoord**, DataNode, QueryNode, IndexNode) do **not** define `systemAccounts` in their ComponentDefinitions. If you use an external object store instead of the bundled MinIO, this managed account does not apply to that store. + +For the bundled MinIO component (typically named **`minio`** in `componentSpecs`, for example in standalone topology), KubeBlocks creates one account. Passwords are auto-generated unless overridden at the Cluster level. Credentials are stored in a Secret named **`{cluster}-minio-account-admin`** when the component name is `minio` (substitute your Cluster `metadata.name` and the MinIO component’s `name`). + +| Account | Component (typical name) | Role | Purpose | +|---------|--------------------------|------|---------| +| `admin` | `minio` | Object store admin | MinIO root credentials; injected into MinIO pods as `MINIO_ACCESS_KEY` and `MINIO_SECRET_KEY` for S3-compatible access to buckets used by Milvus | diff --git a/docs/en/preview/kubeblocks-for-mongodb/03-architecture.mdx b/docs/en/preview/kubeblocks-for-mongodb/03-architecture.mdx index 76509c2..f5be7e7 100644 --- a/docs/en/preview/kubeblocks-for-mongodb/03-architecture.mdx +++ b/docs/en/preview/kubeblocks-for-mongodb/03-architecture.mdx @@ -62,7 +62,17 @@ MongoDB replica sets use **oplog-based replication** and a **majority-vote (Raft | **Election** | When the primary fails, secondaries vote; the candidate with the most up-to-date oplog and a majority of votes wins | | **Write concern** | `w:majority` ensures a write is durable on a quorum before acknowledging | -A 3-member replica set tolerates **1 failure**. Failover typically completes within **10–30 seconds**. +A 3-member replica set tolerates **1 failure**. + +### Automatic Failover + +1. **Primary pod crashes or becomes unreachable** — secondaries stop receiving heartbeat pings +2. **Election timeout** — after approximately 10 seconds (`electionTimeoutMillis`), one secondary calls for an election +3. **Majority vote** — the candidate with the most up-to-date oplog and a majority of votes wins and becomes the new primary +4. **KubeBlocks roleProbe detects the change** — `syncerctl getrole` returns `primary` for the new pod → `kubeblocks.io/role=primary` label is applied +5. **Service endpoints switch** — the `{cluster}-mongodb-mongodb` ClusterIP service automatically routes writes to the new primary + +Failover typically completes within **10–30 seconds**. ### Traffic Routing diff --git a/docs/en/preview/kubeblocks-for-mysql/03-architecture.mdx b/docs/en/preview/kubeblocks-for-mysql/03-architecture.mdx index b971bfa..46c51d5 100644 --- a/docs/en/preview/kubeblocks-for-mysql/03-architecture.mdx +++ b/docs/en/preview/kubeblocks-for-mysql/03-architecture.mdx @@ -61,6 +61,16 @@ Each pod also runs multiple init containers on startup: `init-syncer` (copies sy | **Failover trigger** | syncer roleProbe fails repeatedly → KubeBlocks selects replica with most advanced binlog position | | **Promotion** | KubeBlocks calls the switchover API to promote the chosen replica; remaining replicas repoint to new primary | +### Automatic Failover + +1. **Primary pod crashes** — replicas stop receiving binlog events +2. **syncer roleProbe fails** — `syncerctl getrole` returns an error repeatedly; detection takes approximately 30 seconds +3. **KubeBlocks marks the primary unavailable** and selects the replica with the most advanced binlog position as the promotion candidate +4. **Chosen replica is promoted** — KubeBlocks calls the switchover lifecycle action; the replica stops replicating and takes over as primary +5. **Remaining replicas repoint** to the new primary via `CHANGE REPLICATION SOURCE TO` +6. **Pod label updated** — `kubeblocks.io/role=primary` applied to the new primary pod +7. **Service endpoints switch** — the `{cluster}-mysql` ClusterIP service automatically routes writes to the new primary + Failover typically completes within **30–60 seconds**. ### Traffic Routing @@ -114,7 +124,15 @@ The roleProbe runs `/tools/syncerctl getrole` inside the `mysql` container. Each | **syncer role update** | syncer roleProbe detects the new primary role → updates `kubeblocks.io/role` label → ClusterIP service endpoints switch | | **Quorum tolerance** | 3-member group tolerates 1 failure; 5-member tolerates 2 | -Failover typically completes within **5–15 seconds**. Group-internal primary election is near-instant after expulsion; the subsequent `kubeblocks.io/role` label update and Service endpoint switch still depend on the syncer roleProbe cycle. +### Automatic Failover + +1. **Primary pod becomes unreachable** — group communication times out for the failed member +2. **GCS expulsion** — the remaining members detect the failure via the Group Communication System (GCS) and expel the unreachable member +3. **Group elects a new PRIMARY** — the remaining certified secondaries autonomously elect a new primary; no external coordinator is needed +4. **syncer roleProbe detects the new PRIMARY** — `syncerctl getrole` returns `primary` for the elected pod → `kubeblocks.io/role=primary` label updated +5. **Service endpoints switch** — the `{cluster}-mysql` ClusterIP service automatically routes writes to the new primary + +Failover typically completes within **5–15 seconds**. Group-internal primary election is near-instant after expulsion; the subsequent label update and service endpoint switch depend on the syncer roleProbe cycle. ### Traffic Routing diff --git a/docs/en/preview/kubeblocks-for-redis/03-architecture.mdx b/docs/en/preview/kubeblocks-for-redis/03-architecture.mdx index eadc0e6..24c6e4f 100644 --- a/docs/en/preview/kubeblocks-for-redis/03-architecture.mdx +++ b/docs/en/preview/kubeblocks-for-redis/03-architecture.mdx @@ -8,19 +8,41 @@ sidebar_label: Architecture import RedisArchitectureDiagram from '@/components/RedisArchitectureDiagram'; import RedisClusterArchitectureDiagram from '@/components/RedisClusterArchitectureDiagram'; +import RedisStandaloneArchitectureDiagram from '@/components/RedisStandaloneArchitectureDiagram'; # Redis Architecture in KubeBlocks -KubeBlocks supports two distinct Redis architectures that serve different use cases: +The Redis **ClusterDefinition** exposes three patterns. They differ by topology name and whether **Redis Sentinel** is deployed: -| Architecture | Topology name | Use Case | -|---|---|---| -| **Sentinel** | `replication` (also: `standalone`, `replication-twemproxy`) | Single-shard HA; simple client compatibility; datasets that fit on one node | -| **Redis Cluster** | `cluster` | Horizontal write/read scaling; datasets too large for a single node; high-throughput workloads | +| Pattern | Topology name | Components | HA / failover | +|---|---|---|---| +| **Standalone** | `standalone` | `redis` only | No Sentinel; **no** automatic primary failover | +| **Sentinel (primary + replicas)** | `replication`, `replication-twemproxy` | `redis` + `redis-sentinel` | Sentinel quorum monitors the primary and drives failover | +| **Redis Cluster (sharded)** | `cluster` | Sharding (`shard`) | Gossip on the cluster bus; **no** Sentinel processes | --- -## Sentinel Architecture +## Standalone architecture + +Use **`topology: standalone`** when you want a **single Redis Component** and do **not** provision Sentinel. + + + +``` +Cluster → Component (redis) → InstanceSet → Pod × N +``` + +- There is **no** `redis-sentinel` Component and **no** Sentinel quorum — the monitoring and failover flow in the [Sentinel architecture](#sentinel-architecture) section does **not** apply. +- Pod layout (Redis server + metrics sidecar, PVC per data pod) matches the **Redis data pods** description under Sentinel below. +- For HA with automatic failover on a single shard, use **`replication`** (or **`replication-twemproxy`** with Twemproxy), not `standalone`. + +--- + +## Sentinel architecture + +:::note +Everything in this section applies to **`replication`** and **`replication-twemproxy`** only. It does **not** apply to **`standalone`** (no Sentinel) or **`cluster`** (Redis Cluster / gossip, no Sentinel). +::: Redis Sentinel uses a dedicated set of Sentinel processes to monitor the Redis primary, detect failures, and coordinate automatic failover. All data lives on a single primary; replicas serve as hot standbys and optional read targets. @@ -188,7 +210,7 @@ For external access, per-pod NodePort or LoadBalancer services (`redis-advertise ## System Accounts -KubeBlocks manages the following Redis account for both architectures. The password is auto-generated and stored in a Secret named `{cluster}-{component}-account-default`. +KubeBlocks manages the following Redis account for all topology patterns on this page (`standalone`, Sentinel, and Redis Cluster). The password is auto-generated and stored in a Secret named `{cluster}-{component}-account-default`. | Account | Role | Purpose | |---------|------|---------| diff --git a/docs/en/preview/kubeblocks-for-rocketmq/03-architecture.mdx b/docs/en/preview/kubeblocks-for-rocketmq/03-architecture.mdx index 954f5af..544bb65 100644 --- a/docs/en/preview/kubeblocks-for-rocketmq/03-architecture.mdx +++ b/docs/en/preview/kubeblocks-for-rocketmq/03-architecture.mdx @@ -133,3 +133,16 @@ When a RocketMQ component fails: 3. **KubeBlocks pod restart** — KubeBlocks detects the failed pod and restarts it; the recovered pod resumes as master (brokerId=0) after the process starts 4. **Master re-registers** — the recovered master re-registers with all NameServer instances; topic routing is refreshed 5. **Slaves reconnect** — slaves re-establish the HA replication connection to the restored master on port 10912 and resync any missed log entries + +## System Accounts + +The RocketMQ add-on declares KubeBlocks **`systemAccounts`** on the **broker** and **Dashboard** ComponentDefinitions. NameServer and other components do not use this mechanism in the same way. Passwords are generated according to each account’s policy unless overridden on the Cluster. + +Secrets follow **`{cluster}-{component}-account-{accountName}`** — where `{component}` is each component’s **`name`** in the Cluster spec (for example **`dashboard`** for the Dashboard, and each **broker shard** component name such as **`broker-0`**, **`broker-1`**, …). + +| Account | Component (typical) | Role | Purpose | +|---------|---------------------|------|---------| +| `rocketmq-admin` | Per broker shard (`broker-*`) | Broker admin / ACL user | Injected into broker pods as `ROCKETMQ_USER` and `ROCKETMQ_PASSWORD` for broker authentication configuration | +| `console-admin` | `dashboard` | Dashboard login | Injected into Dashboard pods as `CONSOLE_USER` and `CONSOLE_PASSWORD` for the RocketMQ Dashboard web UI | + +The Dashboard also needs the broker admin identity to talk to the cluster: it reads **`rocketmq-admin`** credentials from the broker ComponentDefinition via **`credentialVarRef`** (same username/password as the broker shard’s `rocketmq-admin` account). diff --git a/docs/en/preview/kubeblocks-for-zookeeper/03-architecture.mdx b/docs/en/preview/kubeblocks-for-zookeeper/03-architecture.mdx index 3184f48..f9a48cc 100644 --- a/docs/en/preview/kubeblocks-for-zookeeper/03-architecture.mdx +++ b/docs/en/preview/kubeblocks-for-zookeeper/03-architecture.mdx @@ -105,3 +105,11 @@ When a ZooKeeper ensemble member fails: 2. **Leader election** (if the lost member was the leader) — surviving members elect a new leader in milliseconds to seconds 3. **Write continuity** — as long as a quorum remains available, all write and read operations continue normally 4. **Pod recovery** — when the failed pod restarts, it reads its `myid` from the PVC, contacts the leader, and syncs any missed transactions before rejoining the ensemble + +## System Accounts + +KubeBlocks manages the following ZooKeeper system account. The password is auto-generated and stored in a Secret named `{cluster}-{component}-account-admin` (replace `{cluster}` and `{component}` with your Cluster metadata.name and the ZooKeeper component name, typically `zookeeper`). + +| Account | Role | Purpose | +|---------|------|---------| +| `admin` | Admin | Administrator user when ZooKeeper authentication is enabled (`ZOO_ENABLE_AUTH=yes`); credentials are injected into pods as `ZK_ADMIN_USER` and `ZK_ADMIN_PASSWORD` for authenticated client and administrative access | diff --git a/docs/en/release-1_0_2/kubeblocks-for-elasticsearch/03-architecture.mdx b/docs/en/release-1_0_2/kubeblocks-for-elasticsearch/03-architecture.mdx index b7163bd..eebfd74 100644 --- a/docs/en/release-1_0_2/kubeblocks-for-elasticsearch/03-architecture.mdx +++ b/docs/en/release-1_0_2/kubeblocks-for-elasticsearch/03-architecture.mdx @@ -41,18 +41,32 @@ Every Elasticsearch pod runs three main containers (plus three init containers o Each pod mounts its own **PVC** for the Elasticsearch data directory (`/usr/share/elasticsearch/data`), providing independent persistent storage per node. -## Node Roles +## Node roles (Elasticsearch) -Elasticsearch supports multiple node roles, and KubeBlocks maps each role to a dedicated Component: +Elasticsearch nodes are configured with **roles** (master-eligible, data, ingest, coordinating, etc.). The sections below describe what each role means for **capacity and HA**. -| Node Role | Responsibility | +| Node role | Responsibility | |-----------|----------------| | **Master-eligible** | Participates in leader election; manages cluster state, index mappings, and shard allocation | | **Data** | Stores shard data; handles indexing and search requests for its assigned shards | | **Ingest** | Pre-processes documents before indexing via ingest pipelines | | **Coordinating** (optional) | Routes client requests to the appropriate data nodes and aggregates results | -In smaller deployments, a single node type can hold all roles. For production, dedicated master, data, and ingest components improve stability and resource isolation. +In smaller deployments, one process can hold several roles. In production, splitting roles across nodes improves stability. + +## Topologies and component names (ClusterDefinition) + +In the **kubeblocks-addons** Elasticsearch chart, **`spec.topology`** selects a layout. KubeBlocks creates **one Component per entry** in that topology; component **names** are short labels (`master`, `dit`, `mdit`, …), while the **Elasticsearch role set** is defined inside the image/config for each layout. + +| Topology (`spec.topology`) | Components created | Notes | +|---------------------------|-------------------|--------| +| `single-node` | `mdit` | Single-node layout | +| `multi-node` (chart default) | `master`, `dit` | Split layout: dedicated `master` Component plus `dit` Component for the remaining node group | +| `m-dit` | `master`, `dit` | Same component names as `multi-node`; chart distinguishes layouts for ordering/defaults | +| `mdit` | `mdit` | Combined multi-role naming under one component | +| `m-d-i-t` | `m`, `d`, `i`, `t` | Dedicated components per role family (master / data / ingest / coordinating) | + +Service names look like `{cluster}-{component}-http` — the **`{component}`** segment is the KubeBlocks Component name above (for example `mdit`, `master`, `dit`), not the long English phrase “master-eligible”. Use your Cluster’s `status` or `kubectl get component -n ` to see the exact names for a running cluster. ## High Availability via Cluster Coordination diff --git a/docs/en/release-1_0_2/kubeblocks-for-kafka/03-architecture.mdx b/docs/en/release-1_0_2/kubeblocks-for-kafka/03-architecture.mdx index 20358a2..1649cf9 100644 --- a/docs/en/release-1_0_2/kubeblocks-for-kafka/03-architecture.mdx +++ b/docs/en/release-1_0_2/kubeblocks-for-kafka/03-architecture.mdx @@ -21,6 +21,10 @@ KubeBlocks supports three Kafka deployment topologies: The `*_monitor` variants add a standalone `kafka-exporter` Component that scrapes Kafka-specific metrics (consumer group lag, partition offsets, topic throughput) and exposes them on port 9308 for Prometheus. +:::note +**Configuration templates and `configs`:** the Kafka `ComponentDefinition` treats main config slots (for example **`kafka-configuration-tpl`**) as **externally managed** in current addon charts. When you create a `Cluster`, you must **wire those slots** by setting **`configs`** on the matching component (or sharding template) to ConfigMaps whose keys match the template file names — typically the ConfigMaps shipped with the addon in **`kb-system`**, or your own copies in the application namespace. If provisioning fails with a message about missing templates, compare your manifest to the **Kafka examples** in [kubeblocks-addons](https://github.com/apecloud/kubeblocks-addons/tree/main/examples/kafka) for the same chart version. +::: + --- ## Combined Architecture (combined / combined_monitor) diff --git a/docs/en/release-1_0_2/kubeblocks-for-milvus/03-architecture.mdx b/docs/en/release-1_0_2/kubeblocks-for-milvus/03-architecture.mdx index e0c9277..da80016 100644 --- a/docs/en/release-1_0_2/kubeblocks-for-milvus/03-architecture.mdx +++ b/docs/en/release-1_0_2/kubeblocks-for-milvus/03-architecture.mdx @@ -121,3 +121,13 @@ Only the `proxy` container exposes port 19530 (gRPC) for client traffic. All com | `{cluster}-proxy` | ClusterIP | 19530 (gRPC), 9091 (metrics/health) | proxy pods | Client applications (Milvus SDK) connect to the proxy on port 19530 (gRPC). Port 9091 is the metrics/health endpoint — it is not a client-facing REST API. The proxy is the single entry point — it handles authentication, routing, and result aggregation across worker components. + +## System Accounts + +In the Milvus add-on, only the **in-cluster MinIO object-storage** Component (ComponentDefinition `milvus-minio`) declares KubeBlocks **`systemAccounts`**. Other Milvus stack components in this add-on (for example **etcd**, **milvus**, **proxy**, **mixcoord**, DataNode, QueryNode, IndexNode) do **not** define `systemAccounts` in their ComponentDefinitions. If you use an external object store instead of the bundled MinIO, this managed account does not apply to that store. + +For the bundled MinIO component (typically named **`minio`** in `componentSpecs`, for example in standalone topology), KubeBlocks creates one account. Passwords are auto-generated unless overridden at the Cluster level. Credentials are stored in a Secret named **`{cluster}-minio-account-admin`** when the component name is `minio` (substitute your Cluster `metadata.name` and the MinIO component’s `name`). + +| Account | Component (typical name) | Role | Purpose | +|---------|--------------------------|------|---------| +| `admin` | `minio` | Object store admin | MinIO root credentials; injected into MinIO pods as `MINIO_ACCESS_KEY` and `MINIO_SECRET_KEY` for S3-compatible access to buckets used by Milvus | diff --git a/docs/en/release-1_0_2/kubeblocks-for-redis/03-architecture.mdx b/docs/en/release-1_0_2/kubeblocks-for-redis/03-architecture.mdx index eadc0e6..d6f2a5f 100644 --- a/docs/en/release-1_0_2/kubeblocks-for-redis/03-architecture.mdx +++ b/docs/en/release-1_0_2/kubeblocks-for-redis/03-architecture.mdx @@ -11,16 +11,35 @@ import RedisClusterArchitectureDiagram from '@/components/RedisClusterArchitectu # Redis Architecture in KubeBlocks -KubeBlocks supports two distinct Redis architectures that serve different use cases: +The Redis **ClusterDefinition** exposes three patterns. They differ by topology name and whether **Redis Sentinel** is deployed: -| Architecture | Topology name | Use Case | -|---|---|---| -| **Sentinel** | `replication` (also: `standalone`, `replication-twemproxy`) | Single-shard HA; simple client compatibility; datasets that fit on one node | -| **Redis Cluster** | `cluster` | Horizontal write/read scaling; datasets too large for a single node; high-throughput workloads | +| Pattern | Topology name | Components | HA / failover | +|---|---|---|---| +| **Standalone** | `standalone` | `redis` only | No Sentinel; **no** automatic primary failover | +| **Sentinel (primary + replicas)** | `replication`, `replication-twemproxy` | `redis` + `redis-sentinel` | Sentinel quorum monitors the primary and drives failover | +| **Redis Cluster (sharded)** | `cluster` | Sharding (`shard`) | Gossip on the cluster bus; **no** Sentinel processes | --- -## Sentinel Architecture +## Standalone architecture + +Use **`topology: standalone`** when you want a **single Redis Component** and do **not** provision Sentinel. + +``` +Cluster → Component (redis) → InstanceSet → Pod × N +``` + +- There is **no** `redis-sentinel` Component and **no** Sentinel quorum — the monitoring and failover flow in the [Sentinel architecture](#sentinel-architecture) section does **not** apply. +- Pod layout (Redis server + metrics sidecar, PVC per data pod) matches the **Redis data pods** description under Sentinel below. +- For HA with automatic failover on a single shard, use **`replication`** (or **`replication-twemproxy`** with Twemproxy), not `standalone`. + +--- + +## Sentinel architecture + +:::note +Everything in this section applies to **`replication`** and **`replication-twemproxy`** only. It does **not** apply to **`standalone`** (no Sentinel) or **`cluster`** (Redis Cluster / gossip, no Sentinel). +::: Redis Sentinel uses a dedicated set of Sentinel processes to monitor the Redis primary, detect failures, and coordinate automatic failover. All data lives on a single primary; replicas serve as hot standbys and optional read targets. @@ -188,7 +207,7 @@ For external access, per-pod NodePort or LoadBalancer services (`redis-advertise ## System Accounts -KubeBlocks manages the following Redis account for both architectures. The password is auto-generated and stored in a Secret named `{cluster}-{component}-account-default`. +KubeBlocks manages the following Redis account for all topology patterns on this page (`standalone`, Sentinel, and Redis Cluster). The password is auto-generated and stored in a Secret named `{cluster}-{component}-account-default`. | Account | Role | Purpose | |---------|------|---------| diff --git a/docs/en/release-1_0_2/kubeblocks-for-rocketmq/03-architecture.mdx b/docs/en/release-1_0_2/kubeblocks-for-rocketmq/03-architecture.mdx index 954f5af..544bb65 100644 --- a/docs/en/release-1_0_2/kubeblocks-for-rocketmq/03-architecture.mdx +++ b/docs/en/release-1_0_2/kubeblocks-for-rocketmq/03-architecture.mdx @@ -133,3 +133,16 @@ When a RocketMQ component fails: 3. **KubeBlocks pod restart** — KubeBlocks detects the failed pod and restarts it; the recovered pod resumes as master (brokerId=0) after the process starts 4. **Master re-registers** — the recovered master re-registers with all NameServer instances; topic routing is refreshed 5. **Slaves reconnect** — slaves re-establish the HA replication connection to the restored master on port 10912 and resync any missed log entries + +## System Accounts + +The RocketMQ add-on declares KubeBlocks **`systemAccounts`** on the **broker** and **Dashboard** ComponentDefinitions. NameServer and other components do not use this mechanism in the same way. Passwords are generated according to each account’s policy unless overridden on the Cluster. + +Secrets follow **`{cluster}-{component}-account-{accountName}`** — where `{component}` is each component’s **`name`** in the Cluster spec (for example **`dashboard`** for the Dashboard, and each **broker shard** component name such as **`broker-0`**, **`broker-1`**, …). + +| Account | Component (typical) | Role | Purpose | +|---------|---------------------|------|---------| +| `rocketmq-admin` | Per broker shard (`broker-*`) | Broker admin / ACL user | Injected into broker pods as `ROCKETMQ_USER` and `ROCKETMQ_PASSWORD` for broker authentication configuration | +| `console-admin` | `dashboard` | Dashboard login | Injected into Dashboard pods as `CONSOLE_USER` and `CONSOLE_PASSWORD` for the RocketMQ Dashboard web UI | + +The Dashboard also needs the broker admin identity to talk to the cluster: it reads **`rocketmq-admin`** credentials from the broker ComponentDefinition via **`credentialVarRef`** (same username/password as the broker shard’s `rocketmq-admin` account). diff --git a/docs/en/release-1_0_2/kubeblocks-for-zookeeper/03-architecture.mdx b/docs/en/release-1_0_2/kubeblocks-for-zookeeper/03-architecture.mdx index 3184f48..f9a48cc 100644 --- a/docs/en/release-1_0_2/kubeblocks-for-zookeeper/03-architecture.mdx +++ b/docs/en/release-1_0_2/kubeblocks-for-zookeeper/03-architecture.mdx @@ -105,3 +105,11 @@ When a ZooKeeper ensemble member fails: 2. **Leader election** (if the lost member was the leader) — surviving members elect a new leader in milliseconds to seconds 3. **Write continuity** — as long as a quorum remains available, all write and read operations continue normally 4. **Pod recovery** — when the failed pod restarts, it reads its `myid` from the PVC, contacts the leader, and syncs any missed transactions before rejoining the ensemble + +## System Accounts + +KubeBlocks manages the following ZooKeeper system account. The password is auto-generated and stored in a Secret named `{cluster}-{component}-account-admin` (replace `{cluster}` and `{component}` with your Cluster metadata.name and the ZooKeeper component name, typically `zookeeper`). + +| Account | Role | Purpose | +|---------|------|---------| +| `admin` | Admin | Administrator user when ZooKeeper authentication is enabled (`ZOO_ENABLE_AUTH=yes`); credentials are injected into pods as `ZK_ADMIN_USER` and `ZK_ADMIN_PASSWORD` for authenticated client and administrative access | diff --git a/src/components/ClickhouseArchitectureDiagram.tsx b/src/components/ClickhouseArchitectureDiagram.tsx index a2f8c8f..1cbf630 100644 --- a/src/components/ClickhouseArchitectureDiagram.tsx +++ b/src/components/ClickhouseArchitectureDiagram.tsx @@ -17,8 +17,6 @@ export default function ClickhouseArchitectureDiagram() { .ch-ha-diagram .dot-blue { background: #388bfd; } .ch-ha-diagram .dot-green { background: #3fb950; } .ch-ha-diagram .dot-purple { background: #a371f7; } - .ch-ha-diagram .dot-orange { background: #e3b341; } - .ch-ha-diagram .dot-teal { background: #56d4dd; } .ch-ha-diagram .dot-red { background: #f85149; } .ch-ha-diagram .card-title { font-size: 11px; font-weight: 700; letter-spacing: 1.5px; @@ -31,10 +29,6 @@ export default function ClickhouseArchitectureDiagram() { .ch-ha-diagram .data-plane { flex: 1; display: flex; flex-direction: column; gap: 0; } - .ch-ha-diagram .mgmt-sidebar { - width: 260px; flex-shrink: 0; - display: flex; flex-direction: column; gap: 12px; padding-top: 4px; - } .ch-ha-diagram .client-mini { border-radius: 12px; border: 1px solid #30363d; background: #161b22; padding: 12px 16px; @@ -128,49 +122,7 @@ export default function ClickhouseArchitectureDiagram() { padding: 7px; border-radius: 8px; background: #0a1a14; border: 1px solid #238636; margin-top: 10px; font-size: 11px; color: #3fb950; } - .ch-ha-diagram .sidebar-card { border-radius: 10px; border: 1px solid; padding: 12px 14px; } - .ch-ha-diagram .dcs-card { border-color: #1b7c83; background: #0a1e20; } - .ch-ha-diagram .dcs-items { display: flex; flex-direction: column; gap: 5px; margin-top: 8px; } - .ch-ha-diagram .dcs-item { - padding: 5px 9px; border-radius: 6px; border: 1px solid #1b7c8355; - background: #061515; font-size: 10px; color: #56d4dd; line-height: 1.5; - } - .ch-ha-diagram .dcs-item span { color: #7d8590; } - .ch-ha-diagram .failover-card { border-color: #da3633; background: #1c0a0a; } - .ch-ha-diagram .failover-steps { display: flex; flex-direction: column; gap: 4px; margin-top: 8px; } - .ch-ha-diagram .step { display: flex; align-items: flex-start; gap: 7px; font-size: 10px; color: #cdd9e5; line-height: 1.5; } - .ch-ha-diagram .step-num { - width: 16px; height: 16px; border-radius: 50%; flex-shrink: 0; - background: #da363322; border: 1px solid #da363388; - display: flex; align-items: center; justify-content: center; - font-size: 9px; font-weight: 700; color: #f85149; margin-top: 1px; - } - .ch-ha-diagram .accounts-card { border-color: #d2992244; background: #1a1505; } - .ch-ha-diagram .accounts-grid { display: flex; flex-wrap: wrap; gap: 5px; margin-top: 8px; } - .ch-ha-diagram .acc-chip { - padding: 3px 8px; border-radius: 5px; - border: 1px solid #d2992233; background: #0d0d00; font-size: 10px; color: #e3b341; - } - .ch-ha-diagram .acc-chip span { color: #484f58; font-size: 9px; display: block; } - .ch-ha-diagram .operator-block { - flex: 1; border-radius: 12px; border: 1px solid #1f6feb; - background: #0d1f38; padding: 16px 20px; - } - .ch-ha-diagram .operator-controllers { display: flex; gap: 8px; margin-top: 8px; } - .ch-ha-diagram .ctrl-chip { - flex: 1; padding: 8px 10px; border-radius: 8px; border: 1px solid #1f6feb44; - background: #0a1628; font-size: 11px; color: #79c0ff; text-align: center; - } - .ch-ha-diagram .ctrl-chip .ctrl-name { font-weight: 700; font-size: 12px; display: block; margin-bottom: 2px; } - .ch-ha-diagram .ctrl-chip .ctrl-sub { font-size: 10px; color: #4a7ab5; } - .ch-ha-diagram .crd-chain { display: flex; align-items: center; gap: 6px; margin-top: 10px; flex-wrap: wrap; } - .ch-ha-diagram .crd-chip { padding: 4px 10px; border-radius: 20px; border: 1px solid; font-size: 11px; font-weight: 600; white-space: nowrap; } - .ch-ha-diagram .crd-chip.cluster { border-color: #a371f7; color: #d2a8ff; background: #2d1f5e; } - .ch-ha-diagram .crd-chip.component { border-color: #79c0ff; color: #79c0ff; background: #1a3050; } - .ch-ha-diagram .crd-chip.instanceset { border-color: #7ee787; color: #7ee787; background: #1a3020; } - .ch-ha-diagram .crd-chip.pod { border-color: #e3b341; color: #e3b341; background: #302010; } - .ch-ha-diagram .crd-arrow { color: #484f58; font-size: 14px; } - .ch-ha-diagram .legend { + .ch-ha-diagram .legend { display: flex; gap: 18px; flex-wrap: wrap; justify-content: center; padding-top: 8px; border-top: 1px solid #21262d; margin-top: 16px; } @@ -312,125 +264,13 @@ export default function ClickhouseArchitectureDiagram() { {/* /data-plane */} - {/* RIGHT SIDEBAR */} -
- - {/* ZooKeeper Coordination */} -
-
- - ClickHouse Keeper (ch-keeper) -
-
-
- CH Keeper :9181 (ZK-compatible TCP) · :9234 (Raft)
- replication queue · part checksums · DDL coordination -
-
- Supported roles leader / follower / observer
- Raft-based quorum (typically 3 nodes) · roleProbe on keeper pods only · observer is optional (not deployed by default in a standard 3-node ensemble) -
-
- Secret account-*
- admin credentials -
-
-
- - {/* Failover */} -
-
- - Failover Process -
-
-
1One replica pod crashes
-
2CH Keeper detects lost connection; remaining replicas may continue serving depending on replication health and quorum
-
3KubeBlocks restarts the failed pod
-
4Recovered replica reconnects to CH Keeper, fetches missing data parts from peers
-
5ClusterIP service never changes — no role switch needed (all replicas are equivalent)
-
-
- - {/* System Accounts */} -
-
- - System Accounts -
-
-
adminsuperuser (initAccount)
-
-
- -
{/* /sidebar */} {/* /main-area */} - - {/* ══ SEPARATOR ══ */} -
-
- Management Plane · KubeBlocks Operator -
-
- - {/* ══ BOTTOM: Operator ══ */} -
-
-
- - KubeBlocks Operator - · watches & reconciles CRDs, drives creation and reconciliation of all above resources -
-
-
- Apps Controller - Cluster / Component -
-
- Workloads Controller - InstanceSet → Pods -
-
- Ops Controller - Switchover / Scale -
-
-
-
CRD RESOURCE HIERARCHY
-
-
Cluster
- → -
Sharding
- → -
Component ×N shards
- → -
InstanceSet
- → -
Pods
-
-
-
- -
-
Operator Responsibilities
-
- ⚙ Create / reconcile Pods, Services, PVCs
- ⚙ CH server: no roleProbe (cmpd-ch defines no roles)
- ⚙ CH Keeper: roleProbe (leader/follower/observer) + switchover
- ⚙ Execute memberJoin / scale ops
- ⚙ Manage SystemAccount Secrets -
-
-
- {/* Legend */}
KubeBlocks Operator (control plane)
CRD Resource
Client Traffic
Replica Pod (all equivalent)
-
ClickHouse Keeper Coordination
-
Failover Path
Persistent Storage
diff --git a/src/components/ElasticsearchArchitectureDiagram.tsx b/src/components/ElasticsearchArchitectureDiagram.tsx index 9b92e63..0fd550d 100644 --- a/src/components/ElasticsearchArchitectureDiagram.tsx +++ b/src/components/ElasticsearchArchitectureDiagram.tsx @@ -17,8 +17,6 @@ export default function ElasticsearchArchitectureDiagram() { .es-ha-diagram .dot-blue { background: #388bfd; } .es-ha-diagram .dot-green { background: #3fb950; } .es-ha-diagram .dot-purple { background: #a371f7; } - .es-ha-diagram .dot-orange { background: #e3b341; } - .es-ha-diagram .dot-teal { background: #56d4dd; } .es-ha-diagram .dot-red { background: #f85149; } .es-ha-diagram .card-title { font-size: 11px; font-weight: 700; letter-spacing: 1.5px; @@ -31,10 +29,6 @@ export default function ElasticsearchArchitectureDiagram() { .es-ha-diagram .data-plane { flex: 1; display: flex; flex-direction: column; gap: 0; } - .es-ha-diagram .mgmt-sidebar { - width: 260px; flex-shrink: 0; - display: flex; flex-direction: column; gap: 12px; padding-top: 4px; - } .es-ha-diagram .client-mini { border-radius: 12px; border: 1px solid #30363d; background: #161b22; padding: 12px 16px; @@ -128,49 +122,7 @@ export default function ElasticsearchArchitectureDiagram() { padding: 7px; border-radius: 8px; background: #0a1a14; border: 1px solid #238636; margin-top: 10px; font-size: 11px; color: #3fb950; } - .es-ha-diagram .sidebar-card { border-radius: 10px; border: 1px solid; padding: 12px 14px; } - .es-ha-diagram .dcs-card { border-color: #1b7c83; background: #0a1e20; } - .es-ha-diagram .dcs-items { display: flex; flex-direction: column; gap: 5px; margin-top: 8px; } - .es-ha-diagram .dcs-item { - padding: 5px 9px; border-radius: 6px; border: 1px solid #1b7c8355; - background: #061515; font-size: 10px; color: #56d4dd; line-height: 1.5; - } - .es-ha-diagram .dcs-item span { color: #7d8590; } - .es-ha-diagram .failover-card { border-color: #da3633; background: #1c0a0a; } - .es-ha-diagram .failover-steps { display: flex; flex-direction: column; gap: 4px; margin-top: 8px; } - .es-ha-diagram .step { display: flex; align-items: flex-start; gap: 7px; font-size: 10px; color: #cdd9e5; line-height: 1.5; } - .es-ha-diagram .step-num { - width: 16px; height: 16px; border-radius: 50%; flex-shrink: 0; - background: #da363322; border: 1px solid #da363388; - display: flex; align-items: center; justify-content: center; - font-size: 9px; font-weight: 700; color: #f85149; margin-top: 1px; - } - .es-ha-diagram .accounts-card { border-color: #d2992244; background: #1a1505; } - .es-ha-diagram .accounts-grid { display: flex; flex-wrap: wrap; gap: 5px; margin-top: 8px; } - .es-ha-diagram .acc-chip { - padding: 3px 8px; border-radius: 5px; - border: 1px solid #d2992233; background: #0d0d00; font-size: 10px; color: #e3b341; - } - .es-ha-diagram .acc-chip span { color: #484f58; font-size: 9px; display: block; } - .es-ha-diagram .operator-block { - flex: 1; border-radius: 12px; border: 1px solid #1f6feb; - background: #0d1f38; padding: 16px 20px; - } - .es-ha-diagram .operator-controllers { display: flex; gap: 8px; margin-top: 8px; } - .es-ha-diagram .ctrl-chip { - flex: 1; padding: 8px 10px; border-radius: 8px; border: 1px solid #1f6feb44; - background: #0a1628; font-size: 11px; color: #79c0ff; text-align: center; - } - .es-ha-diagram .ctrl-chip .ctrl-name { font-weight: 700; font-size: 12px; display: block; margin-bottom: 2px; } - .es-ha-diagram .ctrl-chip .ctrl-sub { font-size: 10px; color: #4a7ab5; } - .es-ha-diagram .crd-chain { display: flex; align-items: center; gap: 6px; margin-top: 10px; flex-wrap: wrap; } - .es-ha-diagram .crd-chip { padding: 4px 10px; border-radius: 20px; border: 1px solid; font-size: 11px; font-weight: 600; white-space: nowrap; } - .es-ha-diagram .crd-chip.cluster { border-color: #a371f7; color: #d2a8ff; background: #2d1f5e; } - .es-ha-diagram .crd-chip.component { border-color: #79c0ff; color: #79c0ff; background: #1a3050; } - .es-ha-diagram .crd-chip.instanceset { border-color: #7ee787; color: #7ee787; background: #1a3020; } - .es-ha-diagram .crd-chip.pod { border-color: #e3b341; color: #e3b341; background: #302010; } - .es-ha-diagram .crd-arrow { color: #484f58; font-size: 14px; } - .es-ha-diagram .legend { + .es-ha-diagram .legend { display: flex; gap: 18px; flex-wrap: wrap; justify-content: center; padding-top: 8px; border-top: 1px solid #21262d; margin-top: 16px; } @@ -362,119 +314,7 @@ export default function ElasticsearchArchitectureDiagram() { {/* /data-plane */} - {/* RIGHT SIDEBAR */} -
- - {/* ES Cluster Coordination */} -
-
- - ES Cluster Coordination -
-
-
- ConfigMap {'{scope}'}-config
- cluster settings · master nodes list -
-
- Master election
- quorum = (N/2)+1 nodes -
-
- Secret account-*
- xpack security credentials -
-
-
- - {/* Failover */} -
-
- - Failover Process -
-
-
1Node stops responding (heartbeat timeout)
-
2ES removes node from cluster state
-
3If master: quorum elects new master
-
4In-sync replica promoted to primary shard
-
5Shard rebalancing to restore replication factor
-
6KubeBlocks restarts failed pod via InstanceSet
-
-
- - {/* System Accounts */} -
-
- - System Accounts -
-
-
elasticsuperuser
-
kbadmincluster admin
-
kbdataprotectionbackup
-
kbprobemonitor
-
kbmonitoringmetrics
-
-
- -
{/* /sidebar */} {/* /main-area */} - - {/* ══ SEPARATOR ══ */} -
-
- Management Plane · KubeBlocks Operator -
-
- - {/* ══ BOTTOM: Operator ══ */} -
-
-
- - KubeBlocks Operator - · watches & reconciles CRDs, drives creation and reconciliation of all above resources -
-
-
- Apps Controller - Cluster / Component -
-
- Workloads Controller - InstanceSet → Pods -
-
- Ops Controller - Switchover / Scale -
-
-
-
CRD RESOURCE HIERARCHY
-
-
Cluster
- → -
Component
- → -
InstanceSet
- → -
Pod × 3
-
-
-
- -
-
Operator Responsibilities
-
- ⚙ Create / reconcile Pods, Services, PVCs
- ⚙ es-agent: lifecycle & config management
- ⚙ Execute scale / reconfigure ops
- ⚙ Manage SystemAccount Secrets -
-
-
- {/* Legend */}
KubeBlocks Operator (control plane)
@@ -482,7 +322,6 @@ export default function ElasticsearchArchitectureDiagram() {
Master / REST Traffic
Data Pod
ES Cluster Coordination
-
Failover Path
Persistent Storage
diff --git a/src/components/EtcdArchitectureDiagram.tsx b/src/components/EtcdArchitectureDiagram.tsx index 0fdb506..6ec3ffd 100644 --- a/src/components/EtcdArchitectureDiagram.tsx +++ b/src/components/EtcdArchitectureDiagram.tsx @@ -17,8 +17,6 @@ export default function EtcdArchitectureDiagram() { .etcd-ha-diagram .dot-blue { background: #388bfd; } .etcd-ha-diagram .dot-green { background: #3fb950; } .etcd-ha-diagram .dot-purple { background: #a371f7; } - .etcd-ha-diagram .dot-orange { background: #e3b341; } - .etcd-ha-diagram .dot-teal { background: #56d4dd; } .etcd-ha-diagram .dot-red { background: #f85149; } .etcd-ha-diagram .card-title { font-size: 11px; font-weight: 700; letter-spacing: 1.5px; @@ -31,10 +29,6 @@ export default function EtcdArchitectureDiagram() { .etcd-ha-diagram .data-plane { flex: 1; display: flex; flex-direction: column; gap: 0; } - .etcd-ha-diagram .mgmt-sidebar { - width: 260px; flex-shrink: 0; - display: flex; flex-direction: column; gap: 12px; padding-top: 4px; - } .etcd-ha-diagram .client-mini { border-radius: 12px; border: 1px solid #30363d; background: #161b22; padding: 12px 16px; @@ -128,49 +122,7 @@ export default function EtcdArchitectureDiagram() { padding: 7px; border-radius: 8px; background: #0a1a14; border: 1px solid #238636; margin-top: 10px; font-size: 11px; color: #3fb950; } - .etcd-ha-diagram .sidebar-card { border-radius: 10px; border: 1px solid; padding: 12px 14px; } - .etcd-ha-diagram .dcs-card { border-color: #1b7c83; background: #0a1e20; } - .etcd-ha-diagram .dcs-items { display: flex; flex-direction: column; gap: 5px; margin-top: 8px; } - .etcd-ha-diagram .dcs-item { - padding: 5px 9px; border-radius: 6px; border: 1px solid #1b7c8355; - background: #061515; font-size: 10px; color: #56d4dd; line-height: 1.5; - } - .etcd-ha-diagram .dcs-item span { color: #7d8590; } - .etcd-ha-diagram .failover-card { border-color: #da3633; background: #1c0a0a; } - .etcd-ha-diagram .failover-steps { display: flex; flex-direction: column; gap: 4px; margin-top: 8px; } - .etcd-ha-diagram .step { display: flex; align-items: flex-start; gap: 7px; font-size: 10px; color: #cdd9e5; line-height: 1.5; } - .etcd-ha-diagram .step-num { - width: 16px; height: 16px; border-radius: 50%; flex-shrink: 0; - background: #da363322; border: 1px solid #da363388; - display: flex; align-items: center; justify-content: center; - font-size: 9px; font-weight: 700; color: #f85149; margin-top: 1px; - } - .etcd-ha-diagram .accounts-card { border-color: #d2992244; background: #1a1505; } - .etcd-ha-diagram .accounts-grid { display: flex; flex-wrap: wrap; gap: 5px; margin-top: 8px; } - .etcd-ha-diagram .acc-chip { - padding: 3px 8px; border-radius: 5px; - border: 1px solid #d2992233; background: #0d0d00; font-size: 10px; color: #e3b341; - } - .etcd-ha-diagram .acc-chip span { color: #484f58; font-size: 9px; display: block; } - .etcd-ha-diagram .operator-block { - flex: 1; border-radius: 12px; border: 1px solid #1f6feb; - background: #0d1f38; padding: 16px 20px; - } - .etcd-ha-diagram .operator-controllers { display: flex; gap: 8px; margin-top: 8px; } - .etcd-ha-diagram .ctrl-chip { - flex: 1; padding: 8px 10px; border-radius: 8px; border: 1px solid #1f6feb44; - background: #0a1628; font-size: 11px; color: #79c0ff; text-align: center; - } - .etcd-ha-diagram .ctrl-chip .ctrl-name { font-weight: 700; font-size: 12px; display: block; margin-bottom: 2px; } - .etcd-ha-diagram .ctrl-chip .ctrl-sub { font-size: 10px; color: #4a7ab5; } - .etcd-ha-diagram .crd-chain { display: flex; align-items: center; gap: 6px; margin-top: 10px; flex-wrap: wrap; } - .etcd-ha-diagram .crd-chip { padding: 4px 10px; border-radius: 20px; border: 1px solid; font-size: 11px; font-weight: 600; white-space: nowrap; } - .etcd-ha-diagram .crd-chip.cluster { border-color: #a371f7; color: #d2a8ff; background: #2d1f5e; } - .etcd-ha-diagram .crd-chip.component { border-color: #79c0ff; color: #79c0ff; background: #1a3050; } - .etcd-ha-diagram .crd-chip.instanceset { border-color: #7ee787; color: #7ee787; background: #1a3020; } - .etcd-ha-diagram .crd-chip.pod { border-color: #e3b341; color: #e3b341; background: #302010; } - .etcd-ha-diagram .crd-arrow { color: #484f58; font-size: 14px; } - .etcd-ha-diagram .legend { + .etcd-ha-diagram .legend { display: flex; gap: 18px; flex-wrap: wrap; justify-content: center; padding-top: 8px; border-top: 1px solid #21262d; margin-top: 16px; } @@ -313,128 +265,13 @@ export default function EtcdArchitectureDiagram() { {/* /data-plane */} - {/* RIGHT SIDEBAR */} -
- - {/* Raft Consensus */} -
-
- - Raft Consensus -
-
-
- Leader lease
- TTL configurable · heartbeat interval -
-
- ConfigMap {'{scope}'}-config
- cluster member list -
-
- Secret account-*
- root credentials (if auth enabled) -
-
-
- - {/* Failover */} -
-
- - Failover Process -
-
-
1Leader Pod crashes
-
2Raft heartbeat timeout (election timeout ≈150-300ms)
-
3Follower starts election, increments term
-
4Majority votes → new leader elected
-
5roleProbe detects new leader
-
6Pod label role=leader updated
-
7Service Endpoints auto-switch
-
-
- - {/* System Accounts */} -
-
- - System Accounts -
-
-
rootsuperuser
-
kbadminadmin
-
kbdataprotectionbackup
-
kbprobemonitor
-
-
- -
{/* /sidebar */} {/* /main-area */} - - {/* ══ SEPARATOR ══ */} -
-
- Management Plane · KubeBlocks Operator -
-
- - {/* ══ BOTTOM: Operator ══ */} -
-
-
- - KubeBlocks Operator - · watches & reconciles CRDs, drives creation and reconciliation of all above resources -
-
-
- Apps Controller - Cluster / Component -
-
- Workloads Controller - InstanceSet → Pods -
-
- Ops Controller - Switchover / Scale -
-
-
-
CRD RESOURCE HIERARCHY
-
-
Cluster
- → -
Component
- → -
InstanceSet
- → -
Pod × 3
-
-
-
- -
-
Operator Responsibilities
-
- ⚙ Create / reconcile Pods, Services, PVCs
- ⚙ roleProbe: probe role every 1s
- ⚙ Update Pod label role=leader
- ⚙ Execute switchover / scale ops
- ⚙ Manage SystemAccount Secrets -
-
-
- {/* Legend */}
KubeBlocks Operator (control plane)
CRD Resource
Leader / Client Traffic
Follower Pod
-
Raft Consensus
-
Failover Path
Persistent Storage
diff --git a/src/components/KafkaArchitectureDiagram.tsx b/src/components/KafkaArchitectureDiagram.tsx index 0600446..bb32413 100644 --- a/src/components/KafkaArchitectureDiagram.tsx +++ b/src/components/KafkaArchitectureDiagram.tsx @@ -17,8 +17,6 @@ export default function KafkaArchitectureDiagram() { .kafka-ha-diagram .dot-blue { background: #388bfd; } .kafka-ha-diagram .dot-green { background: #3fb950; } .kafka-ha-diagram .dot-purple { background: #a371f7; } - .kafka-ha-diagram .dot-orange { background: #e3b341; } - .kafka-ha-diagram .dot-teal { background: #56d4dd; } .kafka-ha-diagram .dot-red { background: #f85149; } .kafka-ha-diagram .card-title { font-size: 11px; font-weight: 700; letter-spacing: 1.5px; @@ -31,10 +29,6 @@ export default function KafkaArchitectureDiagram() { .kafka-ha-diagram .data-plane { flex: 1; display: flex; flex-direction: column; gap: 0; } - .kafka-ha-diagram .mgmt-sidebar { - width: 260px; flex-shrink: 0; - display: flex; flex-direction: column; gap: 12px; padding-top: 4px; - } .kafka-ha-diagram .client-mini { border-radius: 12px; border: 1px solid #30363d; background: #161b22; padding: 12px 16px; @@ -128,49 +122,7 @@ export default function KafkaArchitectureDiagram() { padding: 7px; border-radius: 8px; background: #0a1a14; border: 1px solid #238636; margin-top: 10px; font-size: 11px; color: #3fb950; } - .kafka-ha-diagram .sidebar-card { border-radius: 10px; border: 1px solid; padding: 12px 14px; } - .kafka-ha-diagram .dcs-card { border-color: #1b7c83; background: #0a1e20; } - .kafka-ha-diagram .dcs-items { display: flex; flex-direction: column; gap: 5px; margin-top: 8px; } - .kafka-ha-diagram .dcs-item { - padding: 5px 9px; border-radius: 6px; border: 1px solid #1b7c8355; - background: #061515; font-size: 10px; color: #56d4dd; line-height: 1.5; - } - .kafka-ha-diagram .dcs-item span { color: #7d8590; } - .kafka-ha-diagram .failover-card { border-color: #da3633; background: #1c0a0a; } - .kafka-ha-diagram .failover-steps { display: flex; flex-direction: column; gap: 4px; margin-top: 8px; } - .kafka-ha-diagram .step { display: flex; align-items: flex-start; gap: 7px; font-size: 10px; color: #cdd9e5; line-height: 1.5; } - .kafka-ha-diagram .step-num { - width: 16px; height: 16px; border-radius: 50%; flex-shrink: 0; - background: #da363322; border: 1px solid #da363388; - display: flex; align-items: center; justify-content: center; - font-size: 9px; font-weight: 700; color: #f85149; margin-top: 1px; - } - .kafka-ha-diagram .accounts-card { border-color: #d2992244; background: #1a1505; } - .kafka-ha-diagram .accounts-grid { display: flex; flex-wrap: wrap; gap: 5px; margin-top: 8px; } - .kafka-ha-diagram .acc-chip { - padding: 3px 8px; border-radius: 5px; - border: 1px solid #d2992233; background: #0d0d00; font-size: 10px; color: #e3b341; - } - .kafka-ha-diagram .acc-chip span { color: #484f58; font-size: 9px; display: block; } - .kafka-ha-diagram .operator-block { - flex: 1; border-radius: 12px; border: 1px solid #1f6feb; - background: #0d1f38; padding: 16px 20px; - } - .kafka-ha-diagram .operator-controllers { display: flex; gap: 8px; margin-top: 8px; } - .kafka-ha-diagram .ctrl-chip { - flex: 1; padding: 8px 10px; border-radius: 8px; border: 1px solid #1f6feb44; - background: #0a1628; font-size: 11px; color: #79c0ff; text-align: center; - } - .kafka-ha-diagram .ctrl-chip .ctrl-name { font-weight: 700; font-size: 12px; display: block; margin-bottom: 2px; } - .kafka-ha-diagram .ctrl-chip .ctrl-sub { font-size: 10px; color: #4a7ab5; } - .kafka-ha-diagram .crd-chain { display: flex; align-items: center; gap: 6px; margin-top: 10px; flex-wrap: wrap; } - .kafka-ha-diagram .crd-chip { padding: 4px 10px; border-radius: 20px; border: 1px solid; font-size: 11px; font-weight: 600; white-space: nowrap; } - .kafka-ha-diagram .crd-chip.cluster { border-color: #a371f7; color: #d2a8ff; background: #2d1f5e; } - .kafka-ha-diagram .crd-chip.component { border-color: #79c0ff; color: #79c0ff; background: #1a3050; } - .kafka-ha-diagram .crd-chip.instanceset { border-color: #7ee787; color: #7ee787; background: #1a3020; } - .kafka-ha-diagram .crd-chip.pod { border-color: #e3b341; color: #e3b341; background: #302010; } - .kafka-ha-diagram .crd-arrow { color: #484f58; font-size: 14px; } - .kafka-ha-diagram .legend { + .kafka-ha-diagram .legend { display: flex; gap: 18px; flex-wrap: wrap; justify-content: center; padding-top: 8px; border-top: 1px solid #21262d; margin-top: 16px; } @@ -334,128 +286,13 @@ export default function KafkaArchitectureDiagram() { {/* /data-plane */} - {/* RIGHT SIDEBAR */} -
- - {/* HA Mechanism - KRaft */} -
-
- - HA Mechanism - (KRaft — no ZooKeeper) -
-
-
- KRaft metadata log
- replicated across controller-eligible nodes -
-
- ConfigMap {'{scope}'}-config
- broker config -
-
- Secret account-*
- SASL credentials -
-
-
- - {/* Failover */} -
-
- - Failover Process -
-
-
1Controller/Broker Pod crashes
-
2KRaft leader election (≈10s timeout)
-
3New controller elected via Raft quorum
-
4Partition leaders reassigned by controller
-
5ISR updated for affected partitions
-
6Clients reconnect to new partition leaders
-
-
- - {/* System Accounts */} -
-
- - System Accounts -
-
-
adminsuperuser
-
kbdataprotectionbackup
-
kbprobemonitor
-
kbmonitoringmetrics
-
-
- -
{/* /sidebar */} {/* /main-area */} - - {/* ══ SEPARATOR ══ */} -
-
- Management Plane · KubeBlocks Operator -
-
- - {/* ══ BOTTOM: Operator ══ */} -
-
-
- - KubeBlocks Operator - · watches & reconciles CRDs, drives creation and reconciliation of all above resources -
-
-
- Apps Controller - Cluster / Component -
-
- Workloads Controller - InstanceSet → Pods -
-
- Ops Controller - Scale / Reconfigure -
-
-
-
CRD RESOURCE HIERARCHY
-
-
Cluster
- → -
Component
- → -
InstanceSet
- → -
Pod × 3
-
-
-
- -
-
Operator Responsibilities
-
- ⚙ Create / reconcile Pods, Services, PVCs
- ⚙ roleProbe: probe role every 1s
- ⚙ Update Pod label role=controller
- ⚙ Execute scale / reconfigure ops
- ⚙ Manage SystemAccount Secrets -
-
-
- {/* Legend */}
KubeBlocks Operator (control plane)
CRD Resource
Controller Pod (KRaft)
Broker Pod
-
KRaft Consensus
-
Failover Path
Persistent Storage
diff --git a/src/components/KafkaCombinedArchitectureDiagram.tsx b/src/components/KafkaCombinedArchitectureDiagram.tsx index a14c542..3e90b14 100644 --- a/src/components/KafkaCombinedArchitectureDiagram.tsx +++ b/src/components/KafkaCombinedArchitectureDiagram.tsx @@ -24,12 +24,8 @@ export default function KafkaCombinedArchitectureDiagram() { text-transform: uppercase; margin-bottom: 10px; display: flex; align-items: center; gap: 6px; } - .kafka-combined-diagram .main-area { display: flex; gap: 16px; align-items: flex-start; } + .kafka-combined-diagram .main-area { display: flex; align-items: flex-start; } .kafka-combined-diagram .data-plane { flex: 1; display: flex; flex-direction: column; gap: 0; } - .kafka-combined-diagram .mgmt-sidebar { - width: 256px; flex-shrink: 0; - display: flex; flex-direction: column; gap: 12px; padding-top: 4px; - } /* Client */ .kafka-combined-diagram .client-mini { @@ -115,44 +111,6 @@ export default function KafkaCombinedArchitectureDiagram() { display: flex; align-items: center; gap: 8px; } - /* Sidebar */ - .kafka-combined-diagram .sidebar-card { border-radius: 10px; border: 1px solid; padding: 12px 14px; } - .kafka-combined-diagram .dcs-card { border-color: #6e40c944; background: #120d2a; } - .kafka-combined-diagram .dcs-items { display: flex; flex-direction: column; gap: 5px; margin-top: 8px; } - .kafka-combined-diagram .dcs-item { - padding: 5px 9px; border-radius: 6px; border: 1px solid #6e40c933; - background: #0d0820; font-size: 10px; color: #c084fc; line-height: 1.5; - } - .kafka-combined-diagram .dcs-item span { color: #7d8590; } - .kafka-combined-diagram .failover-card { border-color: #da363344; background: #1c0a0a; } - .kafka-combined-diagram .failover-steps { display: flex; flex-direction: column; gap: 4px; margin-top: 8px; } - .kafka-combined-diagram .step { display: flex; align-items: flex-start; gap: 6px; font-size: 10px; color: #cdd9e5; line-height: 1.5; } - .kafka-combined-diagram .step-num { - width: 16px; height: 16px; border-radius: 50%; flex-shrink: 0; - background: #da363322; border: 1px solid #da363388; - display: flex; align-items: center; justify-content: center; - font-size: 9px; font-weight: 700; color: #f85149; margin-top: 1px; - } - - /* Operator */ - .kafka-combined-diagram .operator-block { - flex: 1; border-radius: 12px; border: 1px solid #1f6feb; - background: #0d1f38; padding: 14px 18px; - } - .kafka-combined-diagram .operator-controllers { display: flex; gap: 8px; margin-top: 8px; } - .kafka-combined-diagram .ctrl-chip { - flex: 1; padding: 8px 10px; border-radius: 8px; border: 1px solid #1f6feb44; - background: #0a1628; font-size: 11px; color: #79c0ff; text-align: center; - } - .kafka-combined-diagram .ctrl-chip .ctrl-name { font-weight: 700; font-size: 12px; display: block; margin-bottom: 2px; } - .kafka-combined-diagram .ctrl-chip .ctrl-sub { font-size: 10px; color: #4a7ab5; } - .kafka-combined-diagram .crd-chain { display: flex; align-items: center; gap: 5px; margin-top: 8px; flex-wrap: wrap; } - .kafka-combined-diagram .crd-chip { padding: 3px 9px; border-radius: 20px; border: 1px solid; font-size: 10px; font-weight: 600; white-space: nowrap; } - .kafka-combined-diagram .crd-chip.cluster { border-color:#a371f7; color:#d2a8ff; background:#2d1f5e; } - .kafka-combined-diagram .crd-chip.component { border-color:#3fb950; color:#7ee787; background:#1a3020; } - .kafka-combined-diagram .crd-chip.instanceset { border-color:#79c0ff; color:#79c0ff; background:#0d2035; } - .kafka-combined-diagram .crd-chip.pod { border-color:#e3b341; color:#e3b341; background:#302010; } - .kafka-combined-diagram .crd-arrow { color: #484f58; font-size: 12px; } .kafka-combined-diagram .legend { display: flex; gap: 16px; flex-wrap: wrap; justify-content: center; padding-top: 8px; border-top: 1px solid #21262d; margin-top: 16px; @@ -236,7 +194,9 @@ export default function KafkaCombinedArchitectureDiagram() {
↔ KRaft Quorum (port :9093) - all 3 nodes participate · Raft consensus for cluster metadata · active controller elected among them + + same kafka container on each node — not a separate metadata deployment · Raft consensus for cluster metadata · one active controller at a time +
🔗 @@ -245,96 +205,8 @@ export default function KafkaCombinedArchitectureDiagram() {
{/* /data-plane */} - - {/* Sidebar */} -
- -
-
- - KRaft Metadata - (__cluster_metadata topic) -
-
-
- Active controller:
one of the 3 combined nodes
all metadata writes go through it -
-
- Metadata log:
internal topic replicated
across all controller-eligible nodes -
-
- Quorum:
3 nodes → tolerates 1 failure
no external ZooKeeper needed -
-
-
- -
-
- - Failover Process -
-
-
1Node fails (broker + controller role lost)
-
2KRaft quorum detects leader loss → elects new active controller
-
3New controller reassigns partition leaders from ISR
-
4Clients refresh metadata → reconnect to new partition leaders
-
5KubeBlocks restarts failed pod; rejoins quorum on startup
-
-
- -
{/* /main-area */} -
-
- Management Plane · KubeBlocks Operator -
-
- -
-
-
- - KubeBlocks Operator - · single Component for all combined nodes; uniform pod spec -
-
-
- Apps Controller - Cluster / Component -
-
- Workloads Controller - InstanceSet → Pods -
-
- Ops Controller - Scale / Rolling Update -
-
-
CRD RESOURCE HIERARCHY
-
-
Cluster
- → -
Component (kafka-combine)
- → -
InstanceSet
- → -
Pod × N
-
-
-
-
Port Reference
-
- :9092 — client (producer/consumer)
- :9093 — controller quorum (KRaft)
- :9094 — internal broker replication
- :5556 — jmx-exporter (Prometheus scrape)
- :5555 — JMX_PORT (internal Java JMX) -
-
-
-
KubeBlocks Operator
Client Traffic (:9092)
diff --git a/src/components/MilvusArchitectureDiagram.tsx b/src/components/MilvusArchitectureDiagram.tsx index 872c15e..df51897 100644 --- a/src/components/MilvusArchitectureDiagram.tsx +++ b/src/components/MilvusArchitectureDiagram.tsx @@ -17,7 +17,6 @@ export default function MilvusArchitectureDiagram() { .milvus-ha-diagram .dot-blue { background: #388bfd; } .milvus-ha-diagram .dot-green { background: #3fb950; } .milvus-ha-diagram .dot-purple { background: #a371f7; } - .milvus-ha-diagram .dot-orange { background: #e3b341; } .milvus-ha-diagram .dot-teal { background: #56d4dd; } .milvus-ha-diagram .dot-red { background: #f85149; } .milvus-ha-diagram .card-title { @@ -31,10 +30,6 @@ export default function MilvusArchitectureDiagram() { .milvus-ha-diagram .data-plane { flex: 1; display: flex; flex-direction: column; gap: 0; } - .milvus-ha-diagram .mgmt-sidebar { - width: 260px; flex-shrink: 0; - display: flex; flex-direction: column; gap: 12px; padding-top: 4px; - } .milvus-ha-diagram .client-mini { border-radius: 12px; border: 1px solid #30363d; background: #161b22; padding: 12px 16px; @@ -148,48 +143,6 @@ export default function MilvusArchitectureDiagram() { padding: 7px; border-radius: 8px; background: #0a1a14; border: 1px solid #238636; margin-top: 10px; font-size: 11px; color: #3fb950; } - .milvus-ha-diagram .sidebar-card { border-radius: 10px; border: 1px solid; padding: 12px 14px; } - .milvus-ha-diagram .dcs-card { border-color: #1b7c83; background: #0a1e20; } - .milvus-ha-diagram .dcs-items { display: flex; flex-direction: column; gap: 5px; margin-top: 8px; } - .milvus-ha-diagram .dcs-item { - padding: 5px 9px; border-radius: 6px; border: 1px solid #1b7c8355; - background: #061515; font-size: 10px; color: #56d4dd; line-height: 1.5; - } - .milvus-ha-diagram .dcs-item span { color: #7d8590; } - .milvus-ha-diagram .failover-card { border-color: #da3633; background: #1c0a0a; } - .milvus-ha-diagram .failover-steps { display: flex; flex-direction: column; gap: 4px; margin-top: 8px; } - .milvus-ha-diagram .step { display: flex; align-items: flex-start; gap: 7px; font-size: 10px; color: #cdd9e5; line-height: 1.5; } - .milvus-ha-diagram .step-num { - width: 16px; height: 16px; border-radius: 50%; flex-shrink: 0; - background: #da363322; border: 1px solid #da363388; - display: flex; align-items: center; justify-content: center; - font-size: 9px; font-weight: 700; color: #f85149; margin-top: 1px; - } - .milvus-ha-diagram .accounts-card { border-color: #d2992244; background: #1a1505; } - .milvus-ha-diagram .accounts-grid { display: flex; flex-wrap: wrap; gap: 5px; margin-top: 8px; } - .milvus-ha-diagram .acc-chip { - padding: 3px 8px; border-radius: 5px; - border: 1px solid #d2992233; background: #0d0d00; font-size: 10px; color: #e3b341; - } - .milvus-ha-diagram .acc-chip span { color: #484f58; font-size: 9px; display: block; } - .milvus-ha-diagram .operator-block { - flex: 1; border-radius: 12px; border: 1px solid #1f6feb; - background: #0d1f38; padding: 16px 20px; - } - .milvus-ha-diagram .operator-controllers { display: flex; gap: 8px; margin-top: 8px; } - .milvus-ha-diagram .ctrl-chip { - flex: 1; padding: 8px 10px; border-radius: 8px; border: 1px solid #1f6feb44; - background: #0a1628; font-size: 11px; color: #79c0ff; text-align: center; - } - .milvus-ha-diagram .ctrl-chip .ctrl-name { font-weight: 700; font-size: 12px; display: block; margin-bottom: 2px; } - .milvus-ha-diagram .ctrl-chip .ctrl-sub { font-size: 10px; color: #4a7ab5; } - .milvus-ha-diagram .crd-chain { display: flex; align-items: center; gap: 6px; margin-top: 10px; flex-wrap: wrap; } - .milvus-ha-diagram .crd-chip { padding: 4px 10px; border-radius: 20px; border: 1px solid; font-size: 11px; font-weight: 600; white-space: nowrap; } - .milvus-ha-diagram .crd-chip.cluster { border-color: #a371f7; color: #d2a8ff; background: #2d1f5e; } - .milvus-ha-diagram .crd-chip.component { border-color: #79c0ff; color: #79c0ff; background: #1a3050; } - .milvus-ha-diagram .crd-chip.instanceset { border-color: #7ee787; color: #7ee787; background: #1a3020; } - .milvus-ha-diagram .crd-chip.pod { border-color: #e3b341; color: #e3b341; background: #302010; } - .milvus-ha-diagram .crd-arrow { color: #484f58; font-size: 14px; } .milvus-ha-diagram .legend { display: flex; gap: 18px; flex-wrap: wrap; justify-content: center; padding-top: 8px; border-top: 1px solid #21262d; margin-top: 16px; @@ -376,119 +329,8 @@ export default function MilvusArchitectureDiagram() {
{/* /data-plane */} - {/* RIGHT SIDEBAR */} -
- - {/* HA Mechanism */} -
-
- - etcd Coordination + S3 Storage -
-
-
- etcd
- metadata store · component discovery · leader election -
-
- MinIO/S3
- segment storage · vector index files -
-
- ConfigMap {'{scope}'}-config
- Milvus component topology -
-
-
- - {/* Failover */} -
-
- - Failover Process -
-
-
1MixCoord pod crashes (single replica)
-
2KubeBlocks InstanceSet detects pod failure
-
3KubeBlocks restarts the MixCoord pod
-
4New MixCoord reloads all coordinator state from etcd
-
5Query/Data/Index nodes reconnect to restored MixCoord
-
6Cluster resumes serving requests
-
-
- - {/* Scalability */} -
-
- - Horizontal Scalability -
-
-
proxyscalable
-
querynodescalable
-
datanodescalable
-
indexnodescalable
-
mixcoordsingle replica
-
-
- -
{/* /sidebar */} {/* /main-area */} - {/* ══ SEPARATOR ══ */} -
-
- Management Plane · KubeBlocks Operator -
-
- - {/* ══ BOTTOM: Operator ══ */} -
-
-
- - KubeBlocks Operator - · watches & reconciles CRDs, drives creation and reconciliation of all above resources -
-
-
- Apps Controller - Cluster / Component -
-
- Workloads Controller - InstanceSet → Pods -
-
- Ops Controller - Switchover / Scale -
-
-
-
CRD RESOURCE HIERARCHY
-
-
Cluster
- → -
Component ×5
- → -
InstanceSet
- → -
Pods
-
-
-
- -
-
Operator Responsibilities
-
- ⚙ Create / reconcile Pods, Services, PVCs
- ⚙ Inject serviceRef endpoints (etcd, Pulsar/Kafka, MinIO)
- ⚙ Restart pods on failure; MixCoord reloads from etcd
- ⚙ Execute scale ops per component independently
- ⚙ Manage multi-component topology ordering -
-
-
{/* Legend */}
@@ -496,8 +338,6 @@ export default function MilvusArchitectureDiagram() {
Coordinator Pod
Proxy / Entry Point
Worker Pod
-
etcd Coordination
-
Failover Path
Persistent Storage
diff --git a/src/components/MilvusStandaloneArchitectureDiagram.tsx b/src/components/MilvusStandaloneArchitectureDiagram.tsx index 270e875..f0ef83b 100644 --- a/src/components/MilvusStandaloneArchitectureDiagram.tsx +++ b/src/components/MilvusStandaloneArchitectureDiagram.tsx @@ -17,7 +17,6 @@ export default function MilvusStandaloneArchitectureDiagram() { .milvus-sa-diagram .dot-blue { background: #388bfd; } .milvus-sa-diagram .dot-purple { background: #a371f7; } .milvus-sa-diagram .dot-teal { background: #56d4dd; } - .milvus-sa-diagram .dot-orange { background: #e3b341; } .milvus-sa-diagram .card-title { font-size: 11px; font-weight: 700; letter-spacing: 1.5px; text-transform: uppercase; margin-bottom: 10px; @@ -25,10 +24,6 @@ export default function MilvusStandaloneArchitectureDiagram() { } .milvus-sa-diagram .main-area { display: flex; gap: 20px; align-items: flex-start; } .milvus-sa-diagram .center-col { flex: 1; display: flex; flex-direction: column; gap: 0; } - .milvus-sa-diagram .right-sidebar { - width: 240px; flex-shrink: 0; - display: flex; flex-direction: column; gap: 12px; - } /* Client */ .milvus-sa-diagram .client-box { @@ -127,34 +122,7 @@ export default function MilvusStandaloneArchitectureDiagram() { font-size: 9px; color: #7d8590; } - /* Sidebar */ - .milvus-sa-diagram .sidebar-card { border-radius: 10px; border: 1px solid; padding: 12px 14px; } - .milvus-sa-diagram .note-card { border-color: #e3b34144; background: #1a1505; } - .milvus-sa-diagram .note-items { display: flex; flex-direction: column; gap: 6px; margin-top: 8px; } - .milvus-sa-diagram .note-item { - padding: 5px 8px; border-radius: 5px; border: 1px solid #e3b34133; - background: #0d0900; font-size: 10px; color: #e3b341; line-height: 1.5; - } - .milvus-sa-diagram .note-item span { color: #7d8590; } - .milvus-sa-diagram .ha-card { border-color: #da363344; background: #1c0a0a; } - .milvus-sa-diagram .ha-items { display: flex; flex-direction: column; gap: 5px; margin-top: 8px; } - .milvus-sa-diagram .ha-item { - padding: 5px 8px; border-radius: 5px; border: 1px solid #da363322; - background: #0d0505; font-size: 10px; color: #f85149; line-height: 1.5; - } - /* Operator */ - .milvus-sa-diagram .operator-block { - flex: 1; border-radius: 12px; border: 1px solid #1f6feb; - background: #0d1f38; padding: 14px 18px; - } - .milvus-sa-diagram .crd-chain { display: flex; align-items: center; gap: 5px; margin-top: 8px; flex-wrap: wrap; } - .milvus-sa-diagram .crd-chip { padding: 3px 9px; border-radius: 20px; border: 1px solid; font-size: 10px; font-weight: 600; white-space: nowrap; } - .milvus-sa-diagram .crd-chip.cluster { border-color:#a371f7; color:#d2a8ff; background:#2d1f5e; } - .milvus-sa-diagram .crd-chip.component { border-color:#56d4dd; color:#56d4dd; background:#061515; } - .milvus-sa-diagram .crd-chip.instanceset { border-color:#7ee787; color:#7ee787; background:#1a3020; } - .milvus-sa-diagram .crd-chip.pod { border-color:#e3b341; color:#e3b341; background:#302010; } - .milvus-sa-diagram .crd-arrow { color: #484f58; font-size: 12px; } .milvus-sa-diagram .legend { display: flex; gap: 16px; flex-wrap: wrap; justify-content: center; padding-top: 8px; border-top: 1px solid #21262d; margin-top: 16px; @@ -283,96 +251,13 @@ export default function MilvusStandaloneArchitectureDiagram() { {/* /center-col */} - {/* RIGHT SIDEBAR */} -
- -
-
- - Standalone Characteristics -
-
-
- Deployment:
3 Components in 1 Cluster (etcd + minio + milvus) -
-
- Process model:
All Milvus roles run in a single process — no inter-pod RPC -
-
- Scalability:
Not horizontally scalable — scale up by increasing pod resources -
-
- Use case:
Development, testing, demos, small vector datasets -
-
-
- -
-
- - HA Limitations -
-
-
Single Milvus pod = single point of failure
-
No automatic failover for the milvus process
-
KubeBlocks restarts the pod on crash (pod-level recovery only)
-
etcd and minio are also single replicas by default
-
-
- For production HA, use the Distributed topology instead. -
-
- -
{/* /main-area */} - {/* Separator */} -
-
- Management Plane · KubeBlocks Operator -
-
- - {/* Operator */} -
-
-
- - KubeBlocks Operator - · provisions etcd → minio → milvus in order; manages lifecycle of all 3 Components -
-
CRD RESOURCE HIERARCHY (same for all 3 components)
-
-
Cluster
- → -
Component (etcd)
- + -
Component (minio)
- + -
Component (milvus)
- → -
InstanceSet
- → -
Pod × 1
-
-
-
-
Provisioning Order
-
- ① etcd provisions first
- ② minio provisions
- ③ milvus provisions last
-    (reads etcd + minio config) -
-
-
-
KubeBlocks Operator
Milvus (all-in-one)
Storage Components (etcd / MinIO)
Persistent Storage
-
Single Point of Failure
diff --git a/src/components/MinioArchitectureDiagram.tsx b/src/components/MinioArchitectureDiagram.tsx index 71d0b86..5973d16 100644 --- a/src/components/MinioArchitectureDiagram.tsx +++ b/src/components/MinioArchitectureDiagram.tsx @@ -17,8 +17,6 @@ export default function MinioArchitectureDiagram() { .minio-ha-diagram .dot-blue { background: #388bfd; } .minio-ha-diagram .dot-green { background: #3fb950; } .minio-ha-diagram .dot-purple { background: #a371f7; } - .minio-ha-diagram .dot-orange { background: #e3b341; } - .minio-ha-diagram .dot-teal { background: #56d4dd; } .minio-ha-diagram .dot-red { background: #f85149; } .minio-ha-diagram .card-title { font-size: 11px; font-weight: 700; letter-spacing: 1.5px; @@ -31,10 +29,6 @@ export default function MinioArchitectureDiagram() { .minio-ha-diagram .data-plane { flex: 1; display: flex; flex-direction: column; gap: 0; } - .minio-ha-diagram .mgmt-sidebar { - width: 260px; flex-shrink: 0; - display: flex; flex-direction: column; gap: 12px; padding-top: 4px; - } .minio-ha-diagram .client-mini { border-radius: 12px; border: 1px solid #30363d; background: #161b22; padding: 12px 16px; @@ -133,48 +127,6 @@ export default function MinioArchitectureDiagram() { border: 1px solid #238636; margin-top: 10px; font-size: 11px; color: #3fb950; flex-wrap: wrap; text-align: center; } - .minio-ha-diagram .sidebar-card { border-radius: 10px; border: 1px solid; padding: 12px 14px; } - .minio-ha-diagram .dcs-card { border-color: #1b7c83; background: #0a1e20; } - .minio-ha-diagram .dcs-items { display: flex; flex-direction: column; gap: 5px; margin-top: 8px; } - .minio-ha-diagram .dcs-item { - padding: 5px 9px; border-radius: 6px; border: 1px solid #1b7c8355; - background: #061515; font-size: 10px; color: #56d4dd; line-height: 1.5; - } - .minio-ha-diagram .dcs-item span { color: #7d8590; } - .minio-ha-diagram .failover-card { border-color: #da3633; background: #1c0a0a; } - .minio-ha-diagram .failover-steps { display: flex; flex-direction: column; gap: 4px; margin-top: 8px; } - .minio-ha-diagram .step { display: flex; align-items: flex-start; gap: 7px; font-size: 10px; color: #cdd9e5; line-height: 1.5; } - .minio-ha-diagram .step-num { - width: 16px; height: 16px; border-radius: 50%; flex-shrink: 0; - background: #da363322; border: 1px solid #da363388; - display: flex; align-items: center; justify-content: center; - font-size: 9px; font-weight: 700; color: #f85149; margin-top: 1px; - } - .minio-ha-diagram .accounts-card { border-color: #d2992244; background: #1a1505; } - .minio-ha-diagram .accounts-grid { display: flex; flex-wrap: wrap; gap: 5px; margin-top: 8px; } - .minio-ha-diagram .acc-chip { - padding: 3px 8px; border-radius: 5px; - border: 1px solid #d2992233; background: #0d0d00; font-size: 10px; color: #e3b341; - } - .minio-ha-diagram .acc-chip span { color: #484f58; font-size: 9px; display: block; } - .minio-ha-diagram .operator-block { - flex: 1; border-radius: 12px; border: 1px solid #1f6feb; - background: #0d1f38; padding: 16px 20px; - } - .minio-ha-diagram .operator-controllers { display: flex; gap: 8px; margin-top: 8px; } - .minio-ha-diagram .ctrl-chip { - flex: 1; padding: 8px 10px; border-radius: 8px; border: 1px solid #1f6feb44; - background: #0a1628; font-size: 11px; color: #79c0ff; text-align: center; - } - .minio-ha-diagram .ctrl-chip .ctrl-name { font-weight: 700; font-size: 12px; display: block; margin-bottom: 2px; } - .minio-ha-diagram .ctrl-chip .ctrl-sub { font-size: 10px; color: #4a7ab5; } - .minio-ha-diagram .crd-chain { display: flex; align-items: center; gap: 6px; margin-top: 10px; flex-wrap: wrap; } - .minio-ha-diagram .crd-chip { padding: 4px 10px; border-radius: 20px; border: 1px solid; font-size: 11px; font-weight: 600; white-space: nowrap; } - .minio-ha-diagram .crd-chip.cluster { border-color: #a371f7; color: #d2a8ff; background: #2d1f5e; } - .minio-ha-diagram .crd-chip.component { border-color: #79c0ff; color: #79c0ff; background: #1a3050; } - .minio-ha-diagram .crd-chip.instanceset { border-color: #7ee787; color: #7ee787; background: #1a3020; } - .minio-ha-diagram .crd-chip.pod { border-color: #e3b341; color: #e3b341; background: #302010; } - .minio-ha-diagram .crd-arrow { color: #484f58; font-size: 14px; } .minio-ha-diagram .legend { display: flex; gap: 18px; flex-wrap: wrap; justify-content: center; padding-top: 8px; border-top: 1px solid #21262d; margin-top: 16px; @@ -320,116 +272,8 @@ export default function MinioArchitectureDiagram() { {/* /data-plane */} - {/* RIGHT SIDEBAR */} -
- - {/* Distributed Mode Config */} -
-
- - Distributed Erasure Coding - (Distributed Mode Config) -
-
-
- Erasure set / EC:4+4 (configurable)
- no single point of failure -
-
- Bitrot protection / per-object checksums
- healing on access -
-
- ConfigMap {'{scope}'}-config
- server pool topology -
-
-
- - {/* Failover */} -
-
- - Failover Process -
-
-
1Node/drive failure detected
-
2Quorum check: ≥ N/2+1 drives available
-
3Read healing via parity reconstruction
-
4Background heal task re-encodes missing shards
-
5Node rejoins and re-syncs data
-
6Cluster returns to full redundancy
-
-
- - {/* System Accounts */} -
-
- - System Accounts -
-
-
rootsuperuser (initAccount)
-
-
- -
{/* /sidebar */} {/* /main-area */} - {/* ══ SEPARATOR ══ */} -
-
- Management Plane · KubeBlocks Operator -
-
- - {/* ══ BOTTOM: Operator ══ */} -
-
-
- - KubeBlocks Operator - · watches & reconciles CRDs, drives creation and reconciliation of all above resources -
-
-
- Apps Controller - Cluster / Component -
-
- Workloads Controller - InstanceSet → Pods -
-
- Ops Controller - Scale / Expand -
-
-
-
CRD RESOURCE HIERARCHY
-
-
Cluster
- → -
Component
- → -
InstanceSet
- → -
Pod × 4
-
-
-
- -
-
Operator Responsibilities
-
- ⚙ Create / reconcile Pods, Services, PVCs
- ⚙ roleProbe: exec mc admin info → readwrite / notready
- ⚙ Volume expansion (online)
- ⚙ Execute horizontal scale ops
- ⚙ Manage root account Secret -
-
-
{/* Legend */}
@@ -437,7 +281,6 @@ export default function MinioArchitectureDiagram() {
CRD Resource
S3 API Traffic
Distributed Node (symmetric)
-
Auto-Healing
Persistent Storage
diff --git a/src/components/MongodbArchitectureDiagram.tsx b/src/components/MongodbArchitectureDiagram.tsx index 4e8e56a..08bc214 100644 --- a/src/components/MongodbArchitectureDiagram.tsx +++ b/src/components/MongodbArchitectureDiagram.tsx @@ -17,8 +17,6 @@ export default function MongodbArchitectureDiagram() { .mongodb-ha-diagram .dot-blue { background: #388bfd; } .mongodb-ha-diagram .dot-green { background: #3fb950; } .mongodb-ha-diagram .dot-purple { background: #a371f7; } - .mongodb-ha-diagram .dot-orange { background: #e3b341; } - .mongodb-ha-diagram .dot-teal { background: #56d4dd; } .mongodb-ha-diagram .dot-red { background: #f85149; } .mongodb-ha-diagram .card-title { font-size: 11px; font-weight: 700; letter-spacing: 1.5px; @@ -31,10 +29,6 @@ export default function MongodbArchitectureDiagram() { .mongodb-ha-diagram .data-plane { flex: 1; display: flex; flex-direction: column; gap: 0; } - .mongodb-ha-diagram .mgmt-sidebar { - width: 260px; flex-shrink: 0; - display: flex; flex-direction: column; gap: 12px; padding-top: 4px; - } .mongodb-ha-diagram .client-mini { border-radius: 12px; border: 1px solid #30363d; background: #161b22; padding: 12px 16px; @@ -138,48 +132,6 @@ export default function MongodbArchitectureDiagram() { padding: 7px; border-radius: 8px; background: #0a1a14; border: 1px solid #238636; margin-top: 10px; font-size: 11px; color: #3fb950; } - .mongodb-ha-diagram .sidebar-card { border-radius: 10px; border: 1px solid; padding: 12px 14px; } - .mongodb-ha-diagram .dcs-card { border-color: #1b7c83; background: #0a1e20; } - .mongodb-ha-diagram .dcs-items { display: flex; flex-direction: column; gap: 5px; margin-top: 8px; } - .mongodb-ha-diagram .dcs-item { - padding: 5px 9px; border-radius: 6px; border: 1px solid #1b7c8355; - background: #061515; font-size: 10px; color: #56d4dd; line-height: 1.5; - } - .mongodb-ha-diagram .dcs-item span { color: #7d8590; } - .mongodb-ha-diagram .failover-card { border-color: #da3633; background: #1c0a0a; } - .mongodb-ha-diagram .failover-steps { display: flex; flex-direction: column; gap: 4px; margin-top: 8px; } - .mongodb-ha-diagram .step { display: flex; align-items: flex-start; gap: 7px; font-size: 10px; color: #cdd9e5; line-height: 1.5; } - .mongodb-ha-diagram .step-num { - width: 16px; height: 16px; border-radius: 50%; flex-shrink: 0; - background: #da363322; border: 1px solid #da363388; - display: flex; align-items: center; justify-content: center; - font-size: 9px; font-weight: 700; color: #f85149; margin-top: 1px; - } - .mongodb-ha-diagram .accounts-card { border-color: #d2992244; background: #1a1505; } - .mongodb-ha-diagram .accounts-grid { display: flex; flex-wrap: wrap; gap: 5px; margin-top: 8px; } - .mongodb-ha-diagram .acc-chip { - padding: 3px 8px; border-radius: 5px; - border: 1px solid #d2992233; background: #0d0d00; font-size: 10px; color: #e3b341; - } - .mongodb-ha-diagram .acc-chip span { color: #484f58; font-size: 9px; display: block; } - .mongodb-ha-diagram .operator-block { - flex: 1; border-radius: 12px; border: 1px solid #1f6feb; - background: #0d1f38; padding: 16px 20px; - } - .mongodb-ha-diagram .operator-controllers { display: flex; gap: 8px; margin-top: 8px; } - .mongodb-ha-diagram .ctrl-chip { - flex: 1; padding: 8px 10px; border-radius: 8px; border: 1px solid #1f6feb44; - background: #0a1628; font-size: 11px; color: #79c0ff; text-align: center; - } - .mongodb-ha-diagram .ctrl-chip .ctrl-name { font-weight: 700; font-size: 12px; display: block; margin-bottom: 2px; } - .mongodb-ha-diagram .ctrl-chip .ctrl-sub { font-size: 10px; color: #4a7ab5; } - .mongodb-ha-diagram .crd-chain { display: flex; align-items: center; gap: 6px; margin-top: 10px; flex-wrap: wrap; } - .mongodb-ha-diagram .crd-chip { padding: 4px 10px; border-radius: 20px; border: 1px solid; font-size: 11px; font-weight: 600; white-space: nowrap; } - .mongodb-ha-diagram .crd-chip.cluster { border-color: #a371f7; color: #d2a8ff; background: #2d1f5e; } - .mongodb-ha-diagram .crd-chip.component { border-color: #79c0ff; color: #79c0ff; background: #1a3050; } - .mongodb-ha-diagram .crd-chip.instanceset { border-color: #7ee787; color: #7ee787; background: #1a3020; } - .mongodb-ha-diagram .crd-chip.pod { border-color: #e3b341; color: #e3b341; background: #302010; } - .mongodb-ha-diagram .crd-arrow { color: #484f58; font-size: 14px; } .mongodb-ha-diagram .legend { display: flex; gap: 18px; flex-wrap: wrap; justify-content: center; padding-top: 8px; border-top: 1px solid #21262d; margin-top: 16px; @@ -364,123 +316,8 @@ export default function MongodbArchitectureDiagram() { {/* /data-plane */} - {/* RIGHT SIDEBAR */} -
- - {/* MongoDB Replica Set DCS */} -
-
- - MongoDB Replica Set - (K8s API) -
-
-
- ConfigMap {'{scope}'}-config
- replica set config -
-
- Endpoints {'{scope}'}
- primary lease · election -
-
- Secret account-*
- system account passwords -
-
-
- - {/* Failover */} -
-
- - Failover Process -
-
-
1Primary Pod crashes
-
2Replica Set heartbeat timeout (≈10s)
-
3Secondary initiates election
-
4Majority votes → new primary elected
-
5roleProbe detects role change
-
6Pod label role=primary updated
-
7Service Endpoints auto-switch
-
-
- - {/* System Accounts */} -
-
- - System Accounts -
-
-
rootsuperuser
-
kbadminsuperuser
-
kbdataprotectionbackup
-
kbprobemonitor
-
kbmonitoringmetrics
-
kbreplicatorreplication
-
-
- -
{/* /sidebar */} {/* /main-area */} - {/* ══ SEPARATOR ══ */} -
-
- Management Plane · KubeBlocks Operator -
-
- - {/* ══ BOTTOM: Operator ══ */} -
-
-
- - KubeBlocks Operator - · watches & reconciles CRDs, drives creation and reconciliation of all above resources -
-
-
- Apps Controller - Cluster / Component -
-
- Workloads Controller - InstanceSet → Pods -
-
- Ops Controller - Switchover / Scale -
-
-
-
CRD RESOURCE HIERARCHY
-
-
Cluster
- → -
Component
- → -
InstanceSet
- → -
Pod × 3
-
-
-
- -
-
Operator Responsibilities
-
- ⚙ Create / reconcile Pods, Services, PVCs
- ⚙ roleProbe: exec /tools/syncerctl getrole in mongodb container
- ⚙ Update Pod label role=primary
- ⚙ Execute switchover / scale ops
- ⚙ Manage SystemAccount Secrets -
-
-
- {/* Legend */}
KubeBlocks Operator (control plane)
@@ -488,7 +325,6 @@ export default function MongodbArchitectureDiagram() {
Primary / RW Traffic
Secondary / RO Traffic
Replica Set DCS
-
Failover Path
Persistent Storage
diff --git a/src/components/MongodbShardingArchitectureDiagram.tsx b/src/components/MongodbShardingArchitectureDiagram.tsx index 8cce00e..7265e2a 100644 --- a/src/components/MongodbShardingArchitectureDiagram.tsx +++ b/src/components/MongodbShardingArchitectureDiagram.tsx @@ -29,10 +29,6 @@ export default function MongodbShardingArchitectureDiagram() { /* Layout */ .mdb-shard-diagram .main-area { display: flex; gap: 16px; align-items: flex-start; } .mdb-shard-diagram .data-plane { flex: 1; display: flex; flex-direction: column; gap: 0; } - .mdb-shard-diagram .mgmt-sidebar { - width: 256px; flex-shrink: 0; - display: flex; flex-direction: column; gap: 12px; padding-top: 4px; - } /* Client */ .mdb-shard-diagram .client-box { @@ -151,46 +147,6 @@ export default function MongodbShardingArchitectureDiagram() { .mdb-shard-diagram .container-name { color: #e6edf3; font-weight: 600; } .mdb-shard-diagram .container-port { color: #7d8590; margin-left: auto; } - /* Sidebar */ - .mdb-shard-diagram .sidebar-card { border-radius: 10px; border: 1px solid; padding: 12px 14px; } - .mdb-shard-diagram .routing-card { border-color: #a371f744; background: #120d2a; } - .mdb-shard-diagram .failover-card { border-color: #da363344; background: #1c0a0a; } - .mdb-shard-diagram .failover-steps { display: flex; flex-direction: column; gap: 4px; margin-top: 8px; } - .mdb-shard-diagram .step { display: flex; align-items: flex-start; gap: 6px; font-size: 10px; color: #cdd9e5; line-height: 1.5; } - .mdb-shard-diagram .step-num { - width: 16px; height: 16px; border-radius: 50%; flex-shrink: 0; - background: #da363322; border: 1px solid #da363388; - display: flex; align-items: center; justify-content: center; - font-size: 9px; font-weight: 700; color: #f85149; margin-top: 1px; - } - .mdb-shard-diagram .routing-items { display: flex; flex-direction: column; gap: 5px; margin-top: 8px; } - .mdb-shard-diagram .routing-item { - padding: 5px 8px; border-radius: 6px; border: 1px solid #a371f733; - background: #0d0820; font-size: 10px; color: #d2a8ff; line-height: 1.5; - } - .mdb-shard-diagram .routing-item span { color: #7d8590; } - - /* Operator */ - .mdb-shard-diagram .operator-block { - flex: 1; border-radius: 12px; border: 1px solid #1f6feb; - background: #0d1f38; padding: 16px 20px; - } - .mdb-shard-diagram .operator-controllers { display: flex; gap: 8px; margin-top: 8px; } - .mdb-shard-diagram .ctrl-chip { - flex: 1; padding: 8px 10px; border-radius: 8px; border: 1px solid #1f6feb44; - background: #0a1628; font-size: 11px; color: #79c0ff; text-align: center; - } - .mdb-shard-diagram .ctrl-chip .ctrl-name { font-weight: 700; font-size: 12px; display: block; margin-bottom: 2px; } - .mdb-shard-diagram .ctrl-chip .ctrl-sub { font-size: 10px; color: #4a7ab5; } - .mdb-shard-diagram .crd-chain { display: flex; align-items: center; gap: 5px; margin-top: 10px; flex-wrap: wrap; } - .mdb-shard-diagram .crd-chip { padding: 3px 9px; border-radius: 20px; border: 1px solid; font-size: 10px; font-weight: 600; white-space: nowrap; } - .mdb-shard-diagram .crd-chip.cluster { border-color:#a371f7; color:#d2a8ff; background:#2d1f5e; } - .mdb-shard-diagram .crd-chip.component { border-color:#56d4dd; color:#56d4dd; background:#061515; } - .mdb-shard-diagram .crd-chip.sharding { border-color:#3fb950; color:#7ee787; background:#1a3020; } - .mdb-shard-diagram .crd-chip.shard { border-color:#e3b341; color:#e3b341; background:#302010; } - .mdb-shard-diagram .crd-chip.instanceset { border-color:#79c0ff; color:#79c0ff; background:#0d2035; } - .mdb-shard-diagram .crd-arrow { color: #484f58; font-size: 12px; } - /* Legend */ .mdb-shard-diagram .legend { display: flex; gap: 16px; flex-wrap: wrap; justify-content: center; @@ -363,116 +319,8 @@ export default function MongodbShardingArchitectureDiagram() { {/* /data-plane */} - {/* RIGHT SIDEBAR */} -
- - {/* Routing */} -
-
- - How Mongos Routes Queries -
-
-
- 1. Client sends query
to any mongos instance on :27017 -
-
- 2. Mongos reads chunk map
from config server CSRS -
-
- 3. Shard key hashed
→ determines target shard -
-
- 4. Mongos forwards
to that shard's primary -
-
- 5. Result merged
(for scatter-gather queries, all shards queried) -
-
-
- - {/* Failover */} -
-
- - Failover (per shard) -
-
-
1Shard primary pod fails
-
2Shard replica set election (≈10 s)
-
3Secondary with latest oplog elected
-
4role=primary label updated
-
5Mongos retries on new primary
-
-
- Config server failover follows the same replica set election process independently. -
-
- -
{/* /main-area */} - {/* Separator */} -
-
- Management Plane · KubeBlocks Operator -
-
- - {/* Operator */} -
-
-
- - KubeBlocks Operator - · manages Sharding + Component resources independently; orchestrates provisioning order -
-
-
- Apps Controller - Cluster / Component -
-
- Workloads Controller - InstanceSet → Pods -
-
- Sharding Controller - Shard scale in/out -
-
-
-
CRD RESOURCE HIERARCHY
-
-
Cluster
- → -
Component (mongos)
- + -
Component (config-server)
- + -
Sharding (shard)
- → -
Shard × N
- → -
InstanceSet
- → -
Pod × replicas
-
-
-
-
-
Startup Dependencies
-
- ① config-server (CSRS) must be ready
- ② shards register with CSRS
- ③ mongos requires reachable CSRS
-    before routing queries
- ⚙ Scale shards: add/remove shard,
-    KubeBlocks migrates chunks -
-
-
- {/* Legend */}
KubeBlocks Operator
@@ -480,7 +328,6 @@ export default function MongodbShardingArchitectureDiagram() {
Config Server (CSRS)
Shard Primary
Shard Secondary
-
Failover Path
Persistent Storage
diff --git a/src/components/MysqlArchitectureDiagram.tsx b/src/components/MysqlArchitectureDiagram.tsx index 726110b..3505769 100644 --- a/src/components/MysqlArchitectureDiagram.tsx +++ b/src/components/MysqlArchitectureDiagram.tsx @@ -17,8 +17,6 @@ export default function MysqlArchitectureDiagram() { .mysql-ha-diagram .dot-blue { background: #388bfd; } .mysql-ha-diagram .dot-green { background: #3fb950; } .mysql-ha-diagram .dot-purple { background: #a371f7; } - .mysql-ha-diagram .dot-orange { background: #e3b341; } - .mysql-ha-diagram .dot-teal { background: #56d4dd; } .mysql-ha-diagram .dot-red { background: #f85149; } .mysql-ha-diagram .card-title { font-size: 11px; font-weight: 700; letter-spacing: 1.5px; @@ -31,10 +29,6 @@ export default function MysqlArchitectureDiagram() { .mysql-ha-diagram .data-plane { flex: 1; display: flex; flex-direction: column; gap: 0; } - .mysql-ha-diagram .mgmt-sidebar { - width: 260px; flex-shrink: 0; - display: flex; flex-direction: column; gap: 12px; padding-top: 4px; - } .mysql-ha-diagram .client-mini { border-radius: 12px; border: 1px solid #30363d; background: #161b22; padding: 12px 16px; @@ -128,49 +122,7 @@ export default function MysqlArchitectureDiagram() { padding: 7px; border-radius: 8px; background: #0a1a14; border: 1px solid #238636; margin-top: 10px; font-size: 11px; color: #3fb950; } - .mysql-ha-diagram .sidebar-card { border-radius: 10px; border: 1px solid; padding: 12px 14px; } - .mysql-ha-diagram .dcs-card { border-color: #1b7c83; background: #0a1e20; } - .mysql-ha-diagram .dcs-items { display: flex; flex-direction: column; gap: 5px; margin-top: 8px; } - .mysql-ha-diagram .dcs-item { - padding: 5px 9px; border-radius: 6px; border: 1px solid #1b7c8355; - background: #061515; font-size: 10px; color: #56d4dd; line-height: 1.5; - } - .mysql-ha-diagram .dcs-item span { color: #7d8590; } - .mysql-ha-diagram .failover-card { border-color: #da3633; background: #1c0a0a; } - .mysql-ha-diagram .failover-steps { display: flex; flex-direction: column; gap: 4px; margin-top: 8px; } - .mysql-ha-diagram .step { display: flex; align-items: flex-start; gap: 7px; font-size: 10px; color: #cdd9e5; line-height: 1.5; } - .mysql-ha-diagram .step-num { - width: 16px; height: 16px; border-radius: 50%; flex-shrink: 0; - background: #da363322; border: 1px solid #da363388; - display: flex; align-items: center; justify-content: center; - font-size: 9px; font-weight: 700; color: #f85149; margin-top: 1px; - } - .mysql-ha-diagram .accounts-card { border-color: #d2992244; background: #1a1505; } - .mysql-ha-diagram .accounts-grid { display: flex; flex-wrap: wrap; gap: 5px; margin-top: 8px; } - .mysql-ha-diagram .acc-chip { - padding: 3px 8px; border-radius: 5px; - border: 1px solid #d2992233; background: #0d0d00; font-size: 10px; color: #e3b341; - } - .mysql-ha-diagram .acc-chip span { color: #484f58; font-size: 9px; display: block; } - .mysql-ha-diagram .operator-block { - flex: 1; border-radius: 12px; border: 1px solid #1f6feb; - background: #0d1f38; padding: 16px 20px; - } - .mysql-ha-diagram .operator-controllers { display: flex; gap: 8px; margin-top: 8px; } - .mysql-ha-diagram .ctrl-chip { - flex: 1; padding: 8px 10px; border-radius: 8px; border: 1px solid #1f6feb44; - background: #0a1628; font-size: 11px; color: #79c0ff; text-align: center; - } - .mysql-ha-diagram .ctrl-chip .ctrl-name { font-weight: 700; font-size: 12px; display: block; margin-bottom: 2px; } - .mysql-ha-diagram .ctrl-chip .ctrl-sub { font-size: 10px; color: #4a7ab5; } - .mysql-ha-diagram .crd-chain { display: flex; align-items: center; gap: 6px; margin-top: 10px; flex-wrap: wrap; } - .mysql-ha-diagram .crd-chip { padding: 4px 10px; border-radius: 20px; border: 1px solid; font-size: 11px; font-weight: 600; white-space: nowrap; } - .mysql-ha-diagram .crd-chip.cluster { border-color: #a371f7; color: #d2a8ff; background: #2d1f5e; } - .mysql-ha-diagram .crd-chip.component { border-color: #79c0ff; color: #79c0ff; background: #1a3050; } - .mysql-ha-diagram .crd-chip.instanceset { border-color: #7ee787; color: #7ee787; background: #1a3020; } - .mysql-ha-diagram .crd-chip.pod { border-color: #e3b341; color: #e3b341; background: #302010; } - .mysql-ha-diagram .crd-arrow { color: #484f58; font-size: 14px; } - .mysql-ha-diagram .legend { + .mysql-ha-diagram .legend { display: flex; gap: 18px; flex-wrap: wrap; justify-content: center; padding-top: 8px; border-top: 1px solid #21262d; margin-top: 16px; } @@ -350,131 +302,13 @@ export default function MysqlArchitectureDiagram() { {/* /data-plane */} - {/* RIGHT SIDEBAR */} -
- - {/* MySQL Replication */} -
-
- - MySQL Replication - (async/semi-sync) -
-
-
- ConfigMap {'{scope}'}-config
- source host · binlog position -
-
- Endpoints {'{scope}'}
- primary detection · role probe -
-
- Secret account-*
- system account passwords -
-
-
- - {/* Failover */} -
-
- - Failover Process -
-
-
1Primary Pod crashes
-
2syncer roleProbe fails (syncerctl getrole) (≈30s)
-
3KubeBlocks marks primary unavailable
-
4Best replica promoted to primary
-
5Replicas reconnect to new primary
-
6Pod label role=primary updated
-
7Service Endpoints auto-switch
-
-
- - {/* System Accounts */} -
-
- - System Accounts -
-
-
rootsuperuser
-
kbadminsuperuser
-
kbdataprotectionbackup
-
kbprobemonitor
-
kbmonitoringmetrics
-
kbreplicatorreplication
-
-
- -
{/* /sidebar */} {/* /main-area */} - - {/* ══ SEPARATOR ══ */} -
-
- Management Plane · KubeBlocks Operator -
-
- - {/* ══ BOTTOM: Operator ══ */} -
-
-
- - KubeBlocks Operator - · watches & reconciles CRDs, drives creation and reconciliation of all above resources -
-
-
- Apps Controller - Cluster / Component -
-
- Workloads Controller - InstanceSet → Pods -
-
- Ops Controller - Switchover / Scale -
-
-
-
CRD RESOURCE HIERARCHY
-
-
Cluster
- → -
Component
- → -
InstanceSet
- → -
Pod × 3
-
-
-
- -
-
Operator Responsibilities
-
- ⚙ Create / reconcile Pods, Services, PVCs
- ⚙ roleProbe: probe role every 1s
- ⚙ Update Pod label role=primary
- ⚙ Execute switchover / scale ops
- ⚙ Manage SystemAccount Secrets -
-
-
- {/* Legend */}
KubeBlocks Operator (control plane)
CRD Resource
Primary / RW Traffic
Replica Pod
-
MySQL Replication
-
Failover Path
Persistent Storage
diff --git a/src/components/MysqlMGRArchitectureDiagram.tsx b/src/components/MysqlMGRArchitectureDiagram.tsx index b298213..fd67798 100644 --- a/src/components/MysqlMGRArchitectureDiagram.tsx +++ b/src/components/MysqlMGRArchitectureDiagram.tsx @@ -31,10 +31,6 @@ export default function MysqlMGRArchitectureDiagram() { .mysql-mgr-diagram .data-plane { flex: 1; display: flex; flex-direction: column; gap: 0; } - .mysql-mgr-diagram .mgmt-sidebar { - width: 260px; flex-shrink: 0; - display: flex; flex-direction: column; gap: 12px; padding-top: 4px; - } .mysql-mgr-diagram .client-mini { border-radius: 12px; border: 1px solid #30363d; background: #161b22; padding: 12px 16px; @@ -148,54 +144,6 @@ export default function MysqlMGRArchitectureDiagram() { font-size: 10px; color: #7d8590; } - /* Sidebar cards */ - .mysql-mgr-diagram .sb-card { - border-radius: 10px; border: 1px solid #30363d; - background: #161b22; padding: 14px; - } - .mysql-mgr-diagram .sb-title { - font-size: 10px; font-weight: 700; letter-spacing: 1px; - text-transform: uppercase; margin-bottom: 10px; - } - .mysql-mgr-diagram .step { - display: flex; align-items: flex-start; gap: 8px; - font-size: 10px; color: #8b949e; line-height: 1.5; margin-bottom: 6px; - } - .mysql-mgr-diagram .step-num { - display: inline-flex; align-items: center; justify-content: center; - width: 16px; height: 16px; border-radius: 50%; - background: #21262d; color: #f0f6fc; - font-size: 9px; font-weight: 700; flex-shrink: 0; margin-top: 1px; - } - .mysql-mgr-diagram .info-row { - display: flex; align-items: flex-start; gap: 6px; - font-size: 10px; color: #8b949e; line-height: 1.5; margin-bottom: 5px; - } - .mysql-mgr-diagram .info-key { - color: #f0f6fc; font-weight: 600; min-width: 72px; flex-shrink: 0; - } - - /* CRD chain */ - .mysql-mgr-diagram .crd-section { - border-radius: 10px; border: 1px solid #30363d; - background: #161b22; padding: 14px; - } - .mysql-mgr-diagram .crd-chain { - display: flex; flex-direction: column; gap: 6px; margin-top: 8px; - } - .mysql-mgr-diagram .crd-row { - display: flex; align-items: center; gap: 6px; - } - .mysql-mgr-diagram .crd-chip { - font-size: 10px; font-weight: 700; padding: 3px 8px; - border-radius: 5px; white-space: nowrap; - } - .mysql-mgr-diagram .crd-chip.cluster { background: #1a2a0a; color: #7ee787; border: 1px solid #2ea04344; } - .mysql-mgr-diagram .crd-chip.component { background: #0d1f38; color: #79c0ff; border: 1px solid #1f6feb44; } - .mysql-mgr-diagram .crd-chip.instanceset { background: #1a0d2e; color: #c084fc; border: 1px solid #6e40c944; } - .mysql-mgr-diagram .crd-chip.pod { background: #1c1400; color: #e3b341; border: 1px solid #e3b34144; } - .mysql-mgr-diagram .crd-arrow { color: #484f58; font-size: 12px; } - /* Legend */ .mysql-mgr-diagram .legend { display: flex; flex-wrap: wrap; gap: 12px; @@ -368,73 +316,6 @@ export default function MysqlMGRArchitectureDiagram() { - {/* RIGHT: sidebar */} -
- {/* Group Replication card */} -
-
⟳ Group Replication
-
- Mode: - Single-primary (default) — one PRIMARY accepts writes, secondaries replicate -
-
- Protocol: - Paxos-based GCS on port :33061 — ensures at-least-once delivery and consistent ordering -
-
- Certification: - Each transaction broadcast for conflict detection before commit -
-
- Quorum: - 3-member group tolerates 1 failure; 5-member tolerates 2 -
-
- - {/* Failover card */} -
-
⚡ Automatic Failover
-
1Primary pod becomes unreachable — group communication times out
-
2Remaining members detect expulsion via GCS
-
3Group elects a new PRIMARY from certified secondaries
-
4syncer exec roleProbe detects new PRIMARY → updates kubeblocks.io/role label
-
5ClusterIP service endpoints switch to new primary automatically
-
- - {/* CRD chain */} -
-
📦 Resource Hierarchy
-
-
-
Cluster
-
-
- ↓ -
Component (mysql)
-
-
- ↓ -
InstanceSet
-
-
- ↓ -
Pod × 3 (or N)
-
-
-
- Same hierarchy as semisync — the difference is the replication protocol inside each pod. -
-
- - {/* Port reference */} -
-
🔌 Port Reference
-
:3306MySQL client connections
-
:33061Group Replication communication (GCS)
-
syncerctlroleProbe — exec inside mysql container
-
:9104Prometheus mysqld_exporter
-
-
{/* Legend */} diff --git a/src/components/MysqlOrchestratorArchitectureDiagram.tsx b/src/components/MysqlOrchestratorArchitectureDiagram.tsx index d0057c3..152df7b 100644 --- a/src/components/MysqlOrchestratorArchitectureDiagram.tsx +++ b/src/components/MysqlOrchestratorArchitectureDiagram.tsx @@ -19,10 +19,6 @@ export default function MysqlOrchestratorArchitectureDiagram() { .mysql-orc-diagram .data-plane { flex: 1; display: flex; flex-direction: column; gap: 0; } - .mysql-orc-diagram .mgmt-sidebar { - width: 260px; flex-shrink: 0; - display: flex; flex-direction: column; gap: 12px; padding-top: 4px; - } /* Client */ .mysql-orc-diagram .client-mini { @@ -192,51 +188,6 @@ export default function MysqlOrchestratorArchitectureDiagram() { border-radius: 4px; border: 1px solid #21262d; } - /* Sidebar cards */ - .mysql-orc-diagram .sb-card { - border-radius: 10px; border: 1px solid #30363d; - background: #161b22; padding: 14px; - } - .mysql-orc-diagram .sb-title { - font-size: 10px; font-weight: 700; letter-spacing: 1px; - text-transform: uppercase; margin-bottom: 10px; - } - .mysql-orc-diagram .step { - display: flex; align-items: flex-start; gap: 8px; - font-size: 10px; color: #8b949e; line-height: 1.5; margin-bottom: 6px; - } - .mysql-orc-diagram .step-num { - display: inline-flex; align-items: center; justify-content: center; - width: 16px; height: 16px; border-radius: 50%; - background: #21262d; color: #f0f6fc; - font-size: 9px; font-weight: 700; flex-shrink: 0; margin-top: 1px; - } - .mysql-orc-diagram .info-row { - display: flex; align-items: flex-start; gap: 6px; - font-size: 10px; color: #8b949e; line-height: 1.5; margin-bottom: 5px; - } - .mysql-orc-diagram .info-key { - color: #f0f6fc; font-weight: 600; min-width: 68px; flex-shrink: 0; - } - - /* CRD chain */ - .mysql-orc-diagram .crd-section { - border-radius: 10px; border: 1px solid #30363d; - background: #161b22; padding: 14px; - } - .mysql-orc-diagram .crd-chain { display: flex; flex-direction: column; gap: 5px; margin-top: 8px; } - .mysql-orc-diagram .crd-row { display: flex; align-items: center; gap: 6px; } - .mysql-orc-diagram .crd-chip { - font-size: 10px; font-weight: 700; padding: 3px 8px; - border-radius: 5px; white-space: nowrap; - } - .mysql-orc-diagram .crd-chip.cluster { background: #1a2a0a; color: #7ee787; border: 1px solid #2ea04344; } - .mysql-orc-diagram .crd-chip.component { background: #0d1f38; color: #79c0ff; border: 1px solid #1f6feb44; } - .mysql-orc-diagram .crd-chip.comp-orc { background: #2a1800; color: #e3b341; border: 1px solid #5a3a0044; } - .mysql-orc-diagram .crd-chip.instanceset { background: #1a0d2e; color: #c084fc; border: 1px solid #6e40c944; } - .mysql-orc-diagram .crd-chip.pod { background: #1c1400; color: #e3b341; border: 1px solid #e3b34144; } - .mysql-orc-diagram .crd-arrow { color: #484f58; font-size: 12px; } - /* Legend */ .mysql-orc-diagram .legend { display: flex; flex-wrap: wrap; gap: 12px; @@ -427,56 +378,6 @@ export default function MysqlOrchestratorArchitectureDiagram() { - {/* RIGHT: sidebar */} -
- {/* Failover steps */} -
-
⚡ Failover by Orchestrator
-
1Orchestrator polls all MySQL pods; primary stops responding
-
2Orchestrator identifies replica with most advanced relay log
-
3Orchestrator promotes chosen replica and reconnects remaining replicas
-
4exec roleProbe (orchestrator-client) detects new master → updates kubeblocks.io/role label
-
5mysql-server has no roleSelector — load-balances to all pods; use orc-proxysql for write-only routing
-
- - {/* Orchestrator capabilities */} -
-
🔭 Orchestrator Features
-
Monitoring:Continuous replication topology polling via SHOW SLAVE STATUS
-
Web UI:Visual replication graph; manual promote / relocate operations
-
HTTP API:Web UI + programmatic topology management; Service port :80 (container :3000)
-
Recovery:Configurable hooks for pre/post failover actions
-
- - {/* CRD chain */} -
-
📦 Resource Hierarchy
-
-
-
MySQL Cluster
-
-
- ↓ -
Component (mysql)
-
-
- ↓ -
InstanceSet → Pod × N
-
-
-
Orchestrator Cluster
-
-
- ↓ -
Component (orchestrator)
-
-
- ↓ -
Pod × N
-
-
-
-
{/* Legend */} diff --git a/src/components/PgHaArchitectureDiagram.tsx b/src/components/PgHaArchitectureDiagram.tsx index 0e34b06..adee4f6 100644 --- a/src/components/PgHaArchitectureDiagram.tsx +++ b/src/components/PgHaArchitectureDiagram.tsx @@ -16,24 +16,14 @@ export default function PgHaArchitectureDiagram() { .pg-ha-diagram .dot { width: 8px; height: 8px; border-radius: 50%; display: inline-block; } .pg-ha-diagram .dot-blue { background: #388bfd; } .pg-ha-diagram .dot-green { background: #3fb950; } - .pg-ha-diagram .dot-purple { background: #a371f7; } - .pg-ha-diagram .dot-orange { background: #e3b341; } .pg-ha-diagram .dot-teal { background: #56d4dd; } - .pg-ha-diagram .dot-red { background: #f85149; } .pg-ha-diagram .card-title { font-size: 11px; font-weight: 700; letter-spacing: 1.5px; text-transform: uppercase; margin-bottom: 10px; display: flex; align-items: center; gap: 6px; } - .pg-ha-diagram .main-area { - display: flex; gap: 16px; align-items: flex-start; - } .pg-ha-diagram .data-plane { - flex: 1; display: flex; flex-direction: column; gap: 0; - } - .pg-ha-diagram .mgmt-sidebar { - width: 260px; flex-shrink: 0; - display: flex; flex-direction: column; gap: 12px; padding-top: 4px; + display: flex; flex-direction: column; gap: 0; } .pg-ha-diagram .client-mini { border-radius: 12px; border: 1px solid #30363d; @@ -55,13 +45,6 @@ export default function PgHaArchitectureDiagram() { border-left: 5px solid transparent; border-right: 5px solid transparent; border-top: 7px solid #3fb950; } - .pg-ha-diagram .v-line-gray { background: linear-gradient(to bottom, #30363d88, #484f58); } - .pg-ha-diagram .v-line-gray::after { - content: ''; position: absolute; bottom: 0; left: 50%; - transform: translateX(-50%); - border-left: 5px solid transparent; border-right: 5px solid transparent; - border-top: 7px solid #484f58; - } .pg-ha-diagram .v-arrow-label { font-size: 9px; color: #484f58; letter-spacing: 1px; white-space: nowrap; } .pg-ha-diagram .services-block { border-radius: 12px; border: 1px solid #238636; @@ -72,25 +55,54 @@ export default function PgHaArchitectureDiagram() { } .pg-ha-diagram .svc-card { border-radius: 8px; border: 1px solid; padding: 10px 12px; } .pg-ha-diagram .svc-rw { border-color: #3fb950; background: #0a1a0a; } - .pg-ha-diagram .svc-hl { border-color: #30363d; background: #0d1117; } - .pg-ha-diagram .svc-name { font-size: 12px; font-weight: 700; margin-bottom: 4px; } - .pg-ha-diagram .svc-rw .svc-name { color: #3fb950; } - .pg-ha-diagram .svc-hl .svc-name { color: #7d8590; } + .pg-ha-diagram .svc-name { font-size: 12px; font-weight: 700; margin-bottom: 4px; color: #3fb950; } .pg-ha-diagram .svc-detail { font-size: 10px; color: #7d8590; line-height: 1.6; } .pg-ha-diagram .svc-tag { display: inline-block; font-size: 9px; font-weight: 700; letter-spacing: 1px; padding: 2px 6px; border-radius: 4px; text-transform: uppercase; margin-top: 4px; + background: #1a4a1a; color: #3fb950; } - .pg-ha-diagram .tag-green { background: #1a4a1a; color: #3fb950; } - .pg-ha-diagram .tag-gray { background: #21262d; color: #8b949e; } .pg-ha-diagram .section-label { - font-size: 10px; font-weight: 700; letter-spacing: 2px; - text-transform: uppercase; color: #7d8590; margin-bottom: 8px; + font-size: 10px; font-weight: 700; letter-spacing: 1.5px; + text-transform: uppercase; color: #7d8590; margin-bottom: 12px; + } + .pg-ha-diagram .section-label-teal { color: #56d4dd; } + + /* DCS teal arrow */ + .pg-ha-diagram .v-line-teal { background: linear-gradient(to bottom, #1b7c8388, #56d4dd); } + .pg-ha-diagram .v-line-teal::after { + content: ''; position: absolute; bottom: 0; left: 50%; + transform: translateX(-50%); + border-left: 5px solid transparent; border-right: 5px solid transparent; + border-top: 7px solid #56d4dd; + } + + /* DCS bottom block */ + .pg-ha-diagram .dcs-block { + border-radius: 12px; border: 1px solid #1b7c83; + background: #061515; padding: 14px; + } + .pg-ha-diagram .dcs-resources { + display: flex; gap: 8px; flex-wrap: wrap; margin-top: 8px; + } + .pg-ha-diagram .dcs-resource { + background: #0d1117; border-radius: 8px; padding: 8px 12px; + border: 1px solid #1b7c8344; font-size: 10px; flex: 1; min-width: 130px; } + .pg-ha-diagram .dcs-res-name { font-weight: 600; color: #56d4dd; display: block; margin-bottom: 2px; } + .pg-ha-diagram .dcs-res-note { color: #7d8590; font-size: 9px; } + .pg-ha-diagram .dcs-feature { + font-size: 9px; color: #7d8590; + padding: 6px 10px; background: #0d1117; + border-radius: 6px; border: 1px solid #21262d; + white-space: nowrap; + } + + /* Pods section */ .pg-ha-diagram .pods-section { border-radius: 12px; border: 1px solid #30363d; - background: #0d1117; padding: 16px; + background: #0d1117; padding: 14px; } .pg-ha-diagram .pods-grid { display: grid; grid-template-columns: repeat(3, 1fr); gap: 12px; margin-top: 10px; @@ -128,48 +140,6 @@ export default function PgHaArchitectureDiagram() { padding: 7px; border-radius: 8px; background: #0a1a14; border: 1px solid #238636; margin-top: 10px; font-size: 11px; color: #3fb950; } - .pg-ha-diagram .sidebar-card { border-radius: 10px; border: 1px solid; padding: 12px 14px; } - .pg-ha-diagram .dcs-card { border-color: #1b7c83; background: #0a1e20; } - .pg-ha-diagram .dcs-items { display: flex; flex-direction: column; gap: 5px; margin-top: 8px; } - .pg-ha-diagram .dcs-item { - padding: 5px 9px; border-radius: 6px; border: 1px solid #1b7c8355; - background: #061515; font-size: 10px; color: #56d4dd; line-height: 1.5; - } - .pg-ha-diagram .dcs-item span { color: #7d8590; } - .pg-ha-diagram .failover-card { border-color: #da3633; background: #1c0a0a; } - .pg-ha-diagram .failover-steps { display: flex; flex-direction: column; gap: 4px; margin-top: 8px; } - .pg-ha-diagram .step { display: flex; align-items: flex-start; gap: 7px; font-size: 10px; color: #cdd9e5; line-height: 1.5; } - .pg-ha-diagram .step-num { - width: 16px; height: 16px; border-radius: 50%; flex-shrink: 0; - background: #da363322; border: 1px solid #da363388; - display: flex; align-items: center; justify-content: center; - font-size: 9px; font-weight: 700; color: #f85149; margin-top: 1px; - } - .pg-ha-diagram .accounts-card { border-color: #d2992244; background: #1a1505; } - .pg-ha-diagram .accounts-grid { display: flex; flex-wrap: wrap; gap: 5px; margin-top: 8px; } - .pg-ha-diagram .acc-chip { - padding: 3px 8px; border-radius: 5px; - border: 1px solid #d2992233; background: #0d0d00; font-size: 10px; color: #e3b341; - } - .pg-ha-diagram .acc-chip span { color: #484f58; font-size: 9px; display: block; } - .pg-ha-diagram .operator-block { - flex: 1; border-radius: 12px; border: 1px solid #1f6feb; - background: #0d1f38; padding: 16px 20px; - } - .pg-ha-diagram .operator-controllers { display: flex; gap: 8px; margin-top: 8px; } - .pg-ha-diagram .ctrl-chip { - flex: 1; padding: 8px 10px; border-radius: 8px; border: 1px solid #1f6feb44; - background: #0a1628; font-size: 11px; color: #79c0ff; text-align: center; - } - .pg-ha-diagram .ctrl-chip .ctrl-name { font-weight: 700; font-size: 12px; display: block; margin-bottom: 2px; } - .pg-ha-diagram .ctrl-chip .ctrl-sub { font-size: 10px; color: #4a7ab5; } - .pg-ha-diagram .crd-chain { display: flex; align-items: center; gap: 6px; margin-top: 10px; flex-wrap: wrap; } - .pg-ha-diagram .crd-chip { padding: 4px 10px; border-radius: 20px; border: 1px solid; font-size: 11px; font-weight: 600; white-space: nowrap; } - .pg-ha-diagram .crd-chip.cluster { border-color: #a371f7; color: #d2a8ff; background: #2d1f5e; } - .pg-ha-diagram .crd-chip.component { border-color: #79c0ff; color: #79c0ff; background: #1a3050; } - .pg-ha-diagram .crd-chip.instanceset { border-color: #7ee787; color: #7ee787; background: #1a3020; } - .pg-ha-diagram .crd-chip.pod { border-color: #e3b341; color: #e3b341; background: #302010; } - .pg-ha-diagram .crd-arrow { color: #484f58; font-size: 14px; } .pg-ha-diagram .legend { display: flex; gap: 18px; flex-wrap: wrap; justify-content: center; padding-top: 8px; border-top: 1px solid #21262d; margin-top: 16px; @@ -180,66 +150,62 @@ export default function PgHaArchitectureDiagram() {
- {/* ══ MAIN AREA: data plane (left) + sidebar (right) ══ */} -
- - {/* LEFT: Client → Service → Pods */} -
+
- {/* Client */} -
- - - - -
-
Application / Client
-
- Read/Write  pg-cluster-postgresql-postgresql:5432
- Connection Pool  pg-cluster-postgresql-postgresql:6432 (pgbouncer) -
+ {/* Client */} +
+ + + + +
+
Application / Client
+
+ Read/Write  pg-cluster-postgresql-postgresql:5432
+ Connection Pool  pg-cluster-postgresql-postgresql:6432 (pgbouncer)
+
- {/* Arrow: Client → Service */} -
-
-
-
- RW traffic → roleSelector: primary + {/* Arrow: Client → Service */} +
+
+
+ RW traffic → roleSelector: primary +
- {/* Services */} -
-
- - Kubernetes Services -
-
-
-
pg-cluster-postgresql-postgresql
-
- ClusterIP · :5432 / :6432
- selector: kubeblocks.io/role=primary
- Endpoints auto-switch with primary -
- ReadWrite + {/* Services */} +
+
+ + Kubernetes Services +
+
+
+
pg-cluster-postgresql-postgresql
+
+ ClusterIP · :5432 / :6432
+ selector: kubeblocks.io/role=primary
+ Endpoints auto-switch with primary
+ ReadWrite
+
- {/* Arrow: Service → Pods */} -
-
-
-
- → primary pod only + {/* Arrow: Service → Pods */} +
+
+
+ → primary pod only +
- {/* Pods */} -
-
Pods · Worker Nodes
-
+ {/* Pods */} +
+
Pods · Worker Nodes
+
{/* Primary */}
@@ -266,7 +232,7 @@ export default function PgHaArchitectureDiagram() {
🔍
-
dbctl (role probe sidecar)
+
dbctl (role probe)
:5001 /v1.0/getrole
@@ -306,7 +272,7 @@ export default function PgHaArchitectureDiagram() {
🔍
-
dbctl (role probe sidecar)
+
dbctl (role probe)
:5001 /v1.0/getrole
@@ -346,7 +312,7 @@ export default function PgHaArchitectureDiagram() {
🔍
-
dbctl (role probe sidecar)
+
dbctl (role probe)
:5001 /v1.0/getrole
@@ -372,134 +338,45 @@ export default function PgHaArchitectureDiagram() { 🔗 Headless service — stable pod DNS for internal use (replication, HA heartbeat, operator probes); not a client endpoint
-
- -
{/* /data-plane */} - - {/* RIGHT SIDEBAR */} -
- - {/* Patroni DCS */} -
-
- - Patroni DCS - (K8s API) -
-
-
- ConfigMap {'{scope}'}-config
- TTL 30s · loop 10s -
-
- ConfigMap {'{scope}'}
- leader lease · heartbeat -
-
- Secret account-*
- system account passwords -
-
-
- - {/* Failover */} -
-
- - Failover Process -
-
-
1Primary Pod crashes
-
2Patroni heartbeat timeout (≈30s)
-
3Replica acquires ConfigMap leader lease
-
4roleProbe detects role change
-
5Pod label role=primary updated
-
6Service Endpoints auto-switch
-
-
+
- {/* System Accounts */} -
-
- - System Accounts -
-
-
postgressuperuser
-
kbadminsuperuser
-
kbdataprotectionbackup
-
kbprobemonitor
-
kbmonitoringmetrics
-
kbreplicatorreplication
-
+ {/* Arrow: pods → DCS */} +
+
+
+ each Patroni agent reads/writes K8s API via :8008 +
-
{/* /sidebar */} -
{/* /main-area */} - - {/* ══ SEPARATOR ══ */} -
-
- Management Plane · KubeBlocks Operator -
-
- - {/* ══ BOTTOM: Operator ══ */} -
-
-
- - KubeBlocks Operator - · watches & reconciles CRDs, drives creation and reconciliation of all above resources -
-
-
- Apps Controller - Cluster / Component + {/* DCS block */} +
+
Patroni DCS · K8s API
+
+
+ ConfigMap {'{scope}'}-config + cluster config · TTL 30s
-
- Workloads Controller - InstanceSet → Pods +
+ ConfigMap {'{scope}'} + leader lease · heartbeat
-
- Ops Controller - Switchover / Scale -
-
-
-
CRD RESOURCE HIERARCHY
-
-
Cluster
- → -
Component
- → -
InstanceSet
- → -
Pod × 3
+
+ Secret account-* + system account passwords
+
Poll every 10s · TTL 30s
+
Leader election via K8s lock
+
Failover → service re-routes
-
-
Operator Responsibilities
-
- ⚙ Create / reconcile Pods, Services, PVCs
- ⚙ roleProbe: probe role every 1s
- ⚙ Update Pod label role=primary
- ⚙ Execute switchover / scale ops
- ⚙ Manage SystemAccount Secrets -
-
-
+
{/* /data-plane */} {/* Legend */}
-
KubeBlocks Operator (control plane)
-
CRD Resource
Primary / RW Traffic
Replica Pod
-
Patroni DCS
-
Failover Path
+
Patroni DCS (K8s API)
Persistent Storage
diff --git a/src/components/QdrantArchitectureDiagram.tsx b/src/components/QdrantArchitectureDiagram.tsx index 5b8369e..10fd370 100644 --- a/src/components/QdrantArchitectureDiagram.tsx +++ b/src/components/QdrantArchitectureDiagram.tsx @@ -17,8 +17,6 @@ export default function QdrantArchitectureDiagram() { .qdrant-ha-diagram .dot-blue { background: #388bfd; } .qdrant-ha-diagram .dot-green { background: #3fb950; } .qdrant-ha-diagram .dot-purple { background: #a371f7; } - .qdrant-ha-diagram .dot-orange { background: #e3b341; } - .qdrant-ha-diagram .dot-teal { background: #56d4dd; } .qdrant-ha-diagram .dot-red { background: #f85149; } .qdrant-ha-diagram .card-title { font-size: 11px; font-weight: 700; letter-spacing: 1.5px; @@ -31,10 +29,6 @@ export default function QdrantArchitectureDiagram() { .qdrant-ha-diagram .data-plane { flex: 1; display: flex; flex-direction: column; gap: 0; } - .qdrant-ha-diagram .mgmt-sidebar { - width: 260px; flex-shrink: 0; - display: flex; flex-direction: column; gap: 12px; padding-top: 4px; - } .qdrant-ha-diagram .client-mini { border-radius: 12px; border: 1px solid #30363d; background: #161b22; padding: 12px 16px; @@ -128,49 +122,7 @@ export default function QdrantArchitectureDiagram() { padding: 7px; border-radius: 8px; background: #0a1a14; border: 1px solid #238636; margin-top: 10px; font-size: 11px; color: #3fb950; } - .qdrant-ha-diagram .sidebar-card { border-radius: 10px; border: 1px solid; padding: 12px 14px; } - .qdrant-ha-diagram .dcs-card { border-color: #1b7c83; background: #0a1e20; } - .qdrant-ha-diagram .dcs-items { display: flex; flex-direction: column; gap: 5px; margin-top: 8px; } - .qdrant-ha-diagram .dcs-item { - padding: 5px 9px; border-radius: 6px; border: 1px solid #1b7c8355; - background: #061515; font-size: 10px; color: #56d4dd; line-height: 1.5; - } - .qdrant-ha-diagram .dcs-item span { color: #7d8590; } - .qdrant-ha-diagram .failover-card { border-color: #da3633; background: #1c0a0a; } - .qdrant-ha-diagram .failover-steps { display: flex; flex-direction: column; gap: 4px; margin-top: 8px; } - .qdrant-ha-diagram .step { display: flex; align-items: flex-start; gap: 7px; font-size: 10px; color: #cdd9e5; line-height: 1.5; } - .qdrant-ha-diagram .step-num { - width: 16px; height: 16px; border-radius: 50%; flex-shrink: 0; - background: #da363322; border: 1px solid #da363388; - display: flex; align-items: center; justify-content: center; - font-size: 9px; font-weight: 700; color: #f85149; margin-top: 1px; - } - .qdrant-ha-diagram .accounts-card { border-color: #d2992244; background: #1a1505; } - .qdrant-ha-diagram .accounts-grid { display: flex; flex-wrap: wrap; gap: 5px; margin-top: 8px; } - .qdrant-ha-diagram .acc-chip { - padding: 3px 8px; border-radius: 5px; - border: 1px solid #d2992233; background: #0d0d00; font-size: 10px; color: #e3b341; - } - .qdrant-ha-diagram .acc-chip span { color: #484f58; font-size: 9px; display: block; } - .qdrant-ha-diagram .operator-block { - flex: 1; border-radius: 12px; border: 1px solid #1f6feb; - background: #0d1f38; padding: 16px 20px; - } - .qdrant-ha-diagram .operator-controllers { display: flex; gap: 8px; margin-top: 8px; } - .qdrant-ha-diagram .ctrl-chip { - flex: 1; padding: 8px 10px; border-radius: 8px; border: 1px solid #1f6feb44; - background: #0a1628; font-size: 11px; color: #79c0ff; text-align: center; - } - .qdrant-ha-diagram .ctrl-chip .ctrl-name { font-weight: 700; font-size: 12px; display: block; margin-bottom: 2px; } - .qdrant-ha-diagram .ctrl-chip .ctrl-sub { font-size: 10px; color: #4a7ab5; } - .qdrant-ha-diagram .crd-chain { display: flex; align-items: center; gap: 6px; margin-top: 10px; flex-wrap: wrap; } - .qdrant-ha-diagram .crd-chip { padding: 4px 10px; border-radius: 20px; border: 1px solid; font-size: 11px; font-weight: 600; white-space: nowrap; } - .qdrant-ha-diagram .crd-chip.cluster { border-color: #a371f7; color: #d2a8ff; background: #2d1f5e; } - .qdrant-ha-diagram .crd-chip.component { border-color: #79c0ff; color: #79c0ff; background: #1a3050; } - .qdrant-ha-diagram .crd-chip.instanceset { border-color: #7ee787; color: #7ee787; background: #1a3020; } - .qdrant-ha-diagram .crd-chip.pod { border-color: #e3b341; color: #e3b341; background: #302010; } - .qdrant-ha-diagram .crd-arrow { color: #484f58; font-size: 14px; } - .qdrant-ha-diagram .legend { + .qdrant-ha-diagram .legend { display: flex; gap: 18px; flex-wrap: wrap; justify-content: center; padding-top: 8px; border-top: 1px solid #21262d; margin-top: 16px; } @@ -310,118 +262,7 @@ export default function QdrantArchitectureDiagram() {
{/* /data-plane */} - {/* RIGHT SIDEBAR */} -
- - {/* HA Mechanism */} -
-
- - Raft Shard Consensus -
-
-
- ConfigMap {'{scope}'}-config
- cluster peer addresses · consensus config -
-
- Raft consensus
- per-shard leader election · peer synchronization -
-
- Secret account-*
- API key credentials -
-
-
- - {/* Failover */} -
-
- - Failover Process -
-
-
1Pod/shard leader crashes
-
2Raft election timeout (≈10s)
-
3Replica initiates election for affected shard
-
4New shard leader elected
-
5Readiness probe (curl /cluster + consensus check) confirms node rejoined
-
6Traffic redistributed to healthy nodes
-
-
- - {/* System Accounts */} -
-
- - System Accounts -
-
-
api-keymain API key
-
read-only-keyread-only access
-
kbdataprotectionbackup
-
-
- -
{/* /sidebar */}
{/* /main-area */} - - {/* ══ SEPARATOR ══ */} -
-
- Management Plane · KubeBlocks Operator -
-
- - {/* ══ BOTTOM: Operator ══ */} -
-
-
- - KubeBlocks Operator - · watches & reconciles CRDs, drives creation and reconciliation of all above resources -
-
-
- Apps Controller - Cluster / Component -
-
- Workloads Controller - InstanceSet → Pods -
-
- Ops Controller - Switchover / Scale -
-
-
-
CRD RESOURCE HIERARCHY
-
-
Cluster
- → -
Component
- → -
InstanceSet
- → -
Pod × 3
-
-
-
- -
-
Operator Responsibilities
-
- ⚙ Create / reconcile Pods, Services, PVCs
- ⚙ Readiness: curl /cluster · verify Raft consensus
- ⚙ Restart failed pods; inject peer FQDN list on startup
- ⚙ Execute scale ops (add/remove peer via Raft)
- ⚙ Manage SystemAccount Secrets (API key) -
-
-
- {/* Legend */}
KubeBlocks Operator (control plane)
@@ -429,7 +270,6 @@ export default function QdrantArchitectureDiagram() {
Leader / RW Traffic
Replica Pod
Raft Consensus
-
Failover Path
Persistent Storage
diff --git a/src/components/RabbitmqArchitectureDiagram.tsx b/src/components/RabbitmqArchitectureDiagram.tsx index 2d4d3bf..0b47d82 100644 --- a/src/components/RabbitmqArchitectureDiagram.tsx +++ b/src/components/RabbitmqArchitectureDiagram.tsx @@ -17,8 +17,6 @@ export default function RabbitmqArchitectureDiagram() { .rmq-ha-diagram .dot-blue { background: #388bfd; } .rmq-ha-diagram .dot-green { background: #3fb950; } .rmq-ha-diagram .dot-purple { background: #a371f7; } - .rmq-ha-diagram .dot-orange { background: #e3b341; } - .rmq-ha-diagram .dot-teal { background: #56d4dd; } .rmq-ha-diagram .dot-red { background: #f85149; } .rmq-ha-diagram .card-title { font-size: 11px; font-weight: 700; letter-spacing: 1.5px; @@ -31,10 +29,6 @@ export default function RabbitmqArchitectureDiagram() { .rmq-ha-diagram .data-plane { flex: 1; display: flex; flex-direction: column; gap: 0; } - .rmq-ha-diagram .mgmt-sidebar { - width: 260px; flex-shrink: 0; - display: flex; flex-direction: column; gap: 12px; padding-top: 4px; - } .rmq-ha-diagram .client-mini { border-radius: 12px; border: 1px solid #30363d; background: #161b22; padding: 12px 16px; @@ -128,49 +122,7 @@ export default function RabbitmqArchitectureDiagram() { padding: 7px; border-radius: 8px; background: #0a1a14; border: 1px solid #238636; margin-top: 10px; font-size: 11px; color: #3fb950; } - .rmq-ha-diagram .sidebar-card { border-radius: 10px; border: 1px solid; padding: 12px 14px; } - .rmq-ha-diagram .dcs-card { border-color: #1b7c83; background: #0a1e20; } - .rmq-ha-diagram .dcs-items { display: flex; flex-direction: column; gap: 5px; margin-top: 8px; } - .rmq-ha-diagram .dcs-item { - padding: 5px 9px; border-radius: 6px; border: 1px solid #1b7c8355; - background: #061515; font-size: 10px; color: #56d4dd; line-height: 1.5; - } - .rmq-ha-diagram .dcs-item span { color: #7d8590; } - .rmq-ha-diagram .failover-card { border-color: #da3633; background: #1c0a0a; } - .rmq-ha-diagram .failover-steps { display: flex; flex-direction: column; gap: 4px; margin-top: 8px; } - .rmq-ha-diagram .step { display: flex; align-items: flex-start; gap: 7px; font-size: 10px; color: #cdd9e5; line-height: 1.5; } - .rmq-ha-diagram .step-num { - width: 16px; height: 16px; border-radius: 50%; flex-shrink: 0; - background: #da363322; border: 1px solid #da363388; - display: flex; align-items: center; justify-content: center; - font-size: 9px; font-weight: 700; color: #f85149; margin-top: 1px; - } - .rmq-ha-diagram .accounts-card { border-color: #d2992244; background: #1a1505; } - .rmq-ha-diagram .accounts-grid { display: flex; flex-wrap: wrap; gap: 5px; margin-top: 8px; } - .rmq-ha-diagram .acc-chip { - padding: 3px 8px; border-radius: 5px; - border: 1px solid #d2992233; background: #0d0d00; font-size: 10px; color: #e3b341; - } - .rmq-ha-diagram .acc-chip span { color: #484f58; font-size: 9px; display: block; } - .rmq-ha-diagram .operator-block { - flex: 1; border-radius: 12px; border: 1px solid #1f6feb; - background: #0d1f38; padding: 16px 20px; - } - .rmq-ha-diagram .operator-controllers { display: flex; gap: 8px; margin-top: 8px; } - .rmq-ha-diagram .ctrl-chip { - flex: 1; padding: 8px 10px; border-radius: 8px; border: 1px solid #1f6feb44; - background: #0a1628; font-size: 11px; color: #79c0ff; text-align: center; - } - .rmq-ha-diagram .ctrl-chip .ctrl-name { font-weight: 700; font-size: 12px; display: block; margin-bottom: 2px; } - .rmq-ha-diagram .ctrl-chip .ctrl-sub { font-size: 10px; color: #4a7ab5; } - .rmq-ha-diagram .crd-chain { display: flex; align-items: center; gap: 6px; margin-top: 10px; flex-wrap: wrap; } - .rmq-ha-diagram .crd-chip { padding: 4px 10px; border-radius: 20px; border: 1px solid; font-size: 11px; font-weight: 600; white-space: nowrap; } - .rmq-ha-diagram .crd-chip.cluster { border-color: #a371f7; color: #d2a8ff; background: #2d1f5e; } - .rmq-ha-diagram .crd-chip.component { border-color: #79c0ff; color: #79c0ff; background: #1a3050; } - .rmq-ha-diagram .crd-chip.instanceset { border-color: #7ee787; color: #7ee787; background: #1a3020; } - .rmq-ha-diagram .crd-chip.pod { border-color: #e3b341; color: #e3b341; background: #302010; } - .rmq-ha-diagram .crd-arrow { color: #484f58; font-size: 14px; } - .rmq-ha-diagram .legend { + .rmq-ha-diagram .legend { display: flex; gap: 18px; flex-wrap: wrap; justify-content: center; padding-top: 8px; border-top: 1px solid #21262d; margin-top: 16px; } @@ -328,126 +280,13 @@ export default function RabbitmqArchitectureDiagram() {
{/* /data-plane */} - {/* RIGHT SIDEBAR */} -
- - {/* HA Mechanism */} -
-
- - Erlang Cluster + Quorum Queues - (HA Mechanism) -
-
-
- Erlang cookie / shared secret for cluster membership -
-
- ConfigMap {'{scope}'}-config
- rabbitmq.conf · enabled_plugins -
-
- Secret account-*
- user credentials -
-
-
- - {/* Failover */} -
-
- - Failover Process -
-
-
1Node Pod crashes or becomes unreachable
-
2Erlang net_ticktime timeout — cluster marks node down
-
3Quorum queues with that leader hold Raft election
-
4Surviving majority elects new queue leaders
-
5Producers/consumers reconnect to any remaining node
-
6KubeBlocks restarts pod; node rejoins Erlang cluster
-
-
- - {/* System Accounts */} -
-
- - System Accounts -
-
-
guestdefault (disabled in prod)
-
kbadminmanagement
-
kbdataprotectionbackup
-
kbprobemonitor
-
-
- -
{/* /sidebar */}
{/* /main-area */} - - {/* ══ SEPARATOR ══ */} -
-
- Management Plane · KubeBlocks Operator -
-
- - {/* ══ BOTTOM: Operator ══ */} -
-
-
- - KubeBlocks Operator - · watches & reconciles CRDs, drives creation and reconciliation of all above resources -
-
-
- Apps Controller - Cluster / Component -
-
- Workloads Controller - InstanceSet → Pods -
-
- Ops Controller - Switchover / Scale -
-
-
-
CRD RESOURCE HIERARCHY
-
-
Cluster
- → -
Component
- → -
InstanceSet
- → -
Pod × 3
-
-
-
- -
-
Operator Responsibilities
-
- ⚙ Create / reconcile Pods, Services, PVCs
- ⚙ memberLeave: drain node before scale-in
- ⚙ Execute scale / reconfigure ops
- ⚙ Manage SystemAccount Secrets -
-
-
- {/* Legend */}
KubeBlocks Operator (control plane)
CRD Resource
AMQP Traffic / Client Service
Peer Node
-
Erlang Cluster
-
Failover Path
Persistent Storage
diff --git a/src/components/RedisArchitectureDiagram.tsx b/src/components/RedisArchitectureDiagram.tsx index abb9d17..119598b 100644 --- a/src/components/RedisArchitectureDiagram.tsx +++ b/src/components/RedisArchitectureDiagram.tsx @@ -17,8 +17,6 @@ export default function RedisArchitectureDiagram() { .redis-ha-diagram .dot-blue { background: #388bfd; } .redis-ha-diagram .dot-green { background: #3fb950; } .redis-ha-diagram .dot-purple { background: #a371f7; } - .redis-ha-diagram .dot-orange { background: #e3b341; } - .redis-ha-diagram .dot-teal { background: #56d4dd; } .redis-ha-diagram .dot-red { background: #f85149; } .redis-ha-diagram .card-title { font-size: 11px; font-weight: 700; letter-spacing: 1.5px; @@ -31,10 +29,6 @@ export default function RedisArchitectureDiagram() { .redis-ha-diagram .data-plane { flex: 1; display: flex; flex-direction: column; gap: 0; } - .redis-ha-diagram .mgmt-sidebar { - width: 260px; flex-shrink: 0; - display: flex; flex-direction: column; gap: 12px; padding-top: 4px; - } .redis-ha-diagram .client-mini { border-radius: 12px; border: 1px solid #30363d; background: #161b22; padding: 12px 16px; @@ -140,49 +134,7 @@ export default function RedisArchitectureDiagram() { padding: 7px 10px; font-size: 10px; color: #56d4dd; line-height: 1.6; } .redis-ha-diagram .sentinel-pod-name { font-size: 11px; font-weight: 700; color: #c9d1d9; margin-bottom: 3px; } - .redis-ha-diagram .sidebar-card { border-radius: 10px; border: 1px solid; padding: 12px 14px; } - .redis-ha-diagram .dcs-card { border-color: #1b7c83; background: #0a1e20; } - .redis-ha-diagram .dcs-items { display: flex; flex-direction: column; gap: 5px; margin-top: 8px; } - .redis-ha-diagram .dcs-item { - padding: 5px 9px; border-radius: 6px; border: 1px solid #1b7c8355; - background: #061515; font-size: 10px; color: #56d4dd; line-height: 1.5; - } - .redis-ha-diagram .dcs-item span { color: #7d8590; } - .redis-ha-diagram .failover-card { border-color: #da3633; background: #1c0a0a; } - .redis-ha-diagram .failover-steps { display: flex; flex-direction: column; gap: 4px; margin-top: 8px; } - .redis-ha-diagram .step { display: flex; align-items: flex-start; gap: 7px; font-size: 10px; color: #cdd9e5; line-height: 1.5; } - .redis-ha-diagram .step-num { - width: 16px; height: 16px; border-radius: 50%; flex-shrink: 0; - background: #da363322; border: 1px solid #da363388; - display: flex; align-items: center; justify-content: center; - font-size: 9px; font-weight: 700; color: #f85149; margin-top: 1px; - } - .redis-ha-diagram .accounts-card { border-color: #d2992244; background: #1a1505; } - .redis-ha-diagram .accounts-grid { display: flex; flex-wrap: wrap; gap: 5px; margin-top: 8px; } - .redis-ha-diagram .acc-chip { - padding: 3px 8px; border-radius: 5px; - border: 1px solid #d2992233; background: #0d0d00; font-size: 10px; color: #e3b341; - } - .redis-ha-diagram .acc-chip span { color: #484f58; font-size: 9px; display: block; } - .redis-ha-diagram .operator-block { - flex: 1; border-radius: 12px; border: 1px solid #1f6feb; - background: #0d1f38; padding: 16px 20px; - } - .redis-ha-diagram .operator-controllers { display: flex; gap: 8px; margin-top: 8px; } - .redis-ha-diagram .ctrl-chip { - flex: 1; padding: 8px 10px; border-radius: 8px; border: 1px solid #1f6feb44; - background: #0a1628; font-size: 11px; color: #79c0ff; text-align: center; - } - .redis-ha-diagram .ctrl-chip .ctrl-name { font-weight: 700; font-size: 12px; display: block; margin-bottom: 2px; } - .redis-ha-diagram .ctrl-chip .ctrl-sub { font-size: 10px; color: #4a7ab5; } - .redis-ha-diagram .crd-chain { display: flex; align-items: center; gap: 6px; margin-top: 10px; flex-wrap: wrap; } - .redis-ha-diagram .crd-chip { padding: 4px 10px; border-radius: 20px; border: 1px solid; font-size: 11px; font-weight: 600; white-space: nowrap; } - .redis-ha-diagram .crd-chip.cluster { border-color: #a371f7; color: #d2a8ff; background: #2d1f5e; } - .redis-ha-diagram .crd-chip.component { border-color: #79c0ff; color: #79c0ff; background: #1a3050; } - .redis-ha-diagram .crd-chip.instanceset { border-color: #7ee787; color: #7ee787; background: #1a3020; } - .redis-ha-diagram .crd-chip.pod { border-color: #e3b341; color: #e3b341; background: #302010; } - .redis-ha-diagram .crd-arrow { color: #484f58; font-size: 14px; } - .redis-ha-diagram .legend { + .redis-ha-diagram .legend { display: flex; gap: 18px; flex-wrap: wrap; justify-content: center; padding-top: 8px; border-top: 1px solid #21262d; margin-top: 16px; } @@ -365,128 +317,13 @@ export default function RedisArchitectureDiagram() {
{/* /data-plane */} - {/* RIGHT SIDEBAR */} -
- - {/* HA Mechanism - Redis Sentinel */} -
-
- - HA Mechanism - (Redis Sentinel) -
-
-
- Sentinel ConfigMap / sentinel.conf
- rebuilt on restart (emptyDir) -
-
- Endpoints {'{scope}'}
- master monitor · failover decision -
-
- Secret account-*
- default password -
-
-
- - {/* Failover */} -
-
- - Failover Process -
-
-
1Primary Pod crashes
-
2Sentinel detects down-after-milliseconds
-
3Sentinel quorum votes for failover (≥2 sentinels)
-
4Sentinel promotes best replica
-
5roleProbe detects role change
-
6Pod label role=primary updated
-
7Service Endpoints auto-switch
-
-
- - {/* System Accounts */} -
-
- - System Accounts -
-
-
defaultmain account
-
kbdataprotectionbackup
-
kbprobemonitor
-
-
- -
{/* /sidebar */}
{/* /main-area */} - - {/* ══ SEPARATOR ══ */} -
-
- Management Plane · KubeBlocks Operator -
-
- - {/* ══ BOTTOM: Operator ══ */} -
-
-
- - KubeBlocks Operator - · watches & reconciles CRDs, drives creation and reconciliation of all above resources -
-
-
- Apps Controller - Cluster / Component -
-
- Workloads Controller - InstanceSet → Pods -
-
- Ops Controller - Switchover / Scale -
-
-
-
CRD RESOURCE HIERARCHY
-
-
Cluster
- → -
Component
- → -
InstanceSet
- → -
Pod × 3
-
-
-
- -
-
Operator Responsibilities
-
- ⚙ Create / reconcile Pods, Services, PVCs
- ⚙ roleProbe: probe role every 1s
- ⚙ Update Pod label role=primary
- ⚙ Execute switchover / scale ops
- ⚙ Manage SystemAccount Secrets -
-
-
- {/* Legend */}
KubeBlocks Operator (control plane)
CRD Resource
Primary / RW Traffic
Replica Pod
-
Redis Sentinel
-
Failover Path
Persistent Storage
diff --git a/src/components/RedisClusterArchitectureDiagram.tsx b/src/components/RedisClusterArchitectureDiagram.tsx index 012f7da..9233f9a 100644 --- a/src/components/RedisClusterArchitectureDiagram.tsx +++ b/src/components/RedisClusterArchitectureDiagram.tsx @@ -118,46 +118,6 @@ export default function RedisClusterArchitectureDiagram() { display: flex; gap: 16px; align-items: flex-start; margin-top: 0; } .redis-cluster-diagram .data-plane { flex: 1; display: flex; flex-direction: column; gap: 0; } - .redis-cluster-diagram .mgmt-sidebar { - width: 256px; flex-shrink: 0; - display: flex; flex-direction: column; gap: 12px; padding-top: 4px; - } - .redis-cluster-diagram .sidebar-card { border-radius: 10px; border: 1px solid; padding: 12px 14px; } - .redis-cluster-diagram .hierarchy-card { border-color: #a371f744; background: #130d2a; } - .redis-cluster-diagram .failover-card { border-color: #da363344; background: #1c0a0a; } - .redis-cluster-diagram .failover-steps { display: flex; flex-direction: column; gap: 4px; margin-top: 8px; } - .redis-cluster-diagram .step { display: flex; align-items: flex-start; gap: 7px; font-size: 10px; color: #cdd9e5; line-height: 1.5; } - .redis-cluster-diagram .step-num { - width: 16px; height: 16px; border-radius: 50%; flex-shrink: 0; - background: #da363322; border: 1px solid #da363388; - display: flex; align-items: center; justify-content: center; - font-size: 9px; font-weight: 700; color: #f85149; margin-top: 1px; - } - .redis-cluster-diagram .cluster-props { display: flex; flex-direction: column; gap: 5px; margin-top: 8px; } - .redis-cluster-diagram .prop-row { - padding: 4px 8px; border-radius: 5px; border: 1px solid #a371f722; - background: #0d0820; font-size: 10px; color: #d2a8ff; line-height: 1.5; - } - .redis-cluster-diagram .prop-row span { color: #7d8590; } - .redis-cluster-diagram .operator-block { - flex: 1; border-radius: 12px; border: 1px solid #1f6feb; - background: #0d1f38; padding: 16px 20px; - } - .redis-cluster-diagram .operator-controllers { display: flex; gap: 8px; margin-top: 8px; } - .redis-cluster-diagram .ctrl-chip { - flex: 1; padding: 8px 10px; border-radius: 8px; border: 1px solid #1f6feb44; - background: #0a1628; font-size: 11px; color: #79c0ff; text-align: center; - } - .redis-cluster-diagram .ctrl-chip .ctrl-name { font-weight: 700; font-size: 12px; display: block; margin-bottom: 2px; } - .redis-cluster-diagram .ctrl-chip .ctrl-sub { font-size: 10px; color: #4a7ab5; } - .redis-cluster-diagram .crd-chain { display: flex; align-items: center; gap: 6px; margin-top: 10px; flex-wrap: wrap; } - .redis-cluster-diagram .crd-chip { padding: 4px 10px; border-radius: 20px; border: 1px solid; font-size: 11px; font-weight: 600; white-space: nowrap; } - .redis-cluster-diagram .crd-chip.cluster { border-color: #a371f7; color: #d2a8ff; background: #2d1f5e; } - .redis-cluster-diagram .crd-chip.sharding { border-color: #f0883e; color: #f0883e; background: #2a1200; } - .redis-cluster-diagram .crd-chip.shard { border-color: #e3b341; color: #e3b341; background: #302010; } - .redis-cluster-diagram .crd-chip.instanceset { border-color: #7ee787; color: #7ee787; background: #1a3020; } - .redis-cluster-diagram .crd-chip.pod { border-color: #79c0ff; color: #79c0ff; background: #0d2035; } - .redis-cluster-diagram .crd-arrow { color: #484f58; font-size: 14px; } .redis-cluster-diagram .legend { display: flex; gap: 18px; flex-wrap: wrap; justify-content: center; padding-top: 8px; border-top: 1px solid #21262d; margin-top: 16px; @@ -370,112 +330,8 @@ export default function RedisClusterArchitectureDiagram() {
{/* /data-plane */} - {/* RIGHT SIDEBAR */} -
- - {/* Cluster Properties */} -
-
- - Cluster Properties -
-
-
- Hash slots: 16384 total
- distributed evenly across shards -
-
- Min shards: 3 (for quorum)
- tolerates 1 full shard failure -
-
- Replication: async per shard
- primary → replicas within shard -
-
- No Sentinel: gossip protocol
- nodes self-manage cluster topology -
-
-
- - {/* Failover */} -
-
- - Shard Failover Process -
-
-
1Shard primary stops responding to gossip pings
-
2Other nodes mark primary as PFAIL (possible fail)
-
3Enough nodes agree → primary declared FAIL
-
4Shard replica requests votes from other primaries
-
5Replica wins majority → promoted to primary
-
6kubeblocks.io/role=primary label updated
-
7Cluster slot map updated; clients follow MOVED
-
-
- -
{/* /sidebar */}
{/* /main-area */} - {/* Separator */} -
-
- Management Plane · KubeBlocks Operator -
-
- - {/* Operator */} -
-
-
- - KubeBlocks Operator - · manages Sharding resources; each shard is an independent Component -
-
-
- Apps Controller - Cluster / Sharding -
-
- Workloads Controller - InstanceSet → Pods -
-
- Ops Controller - Scale shards / Rebalance -
-
-
-
CRD RESOURCE HIERARCHY
-
-
Cluster
- → -
Sharding
- → -
Shard × N
- → -
InstanceSet
- → -
Pod × replicas
-
-
-
- -
-
Operator Responsibilities
-
- ⚙ Create / reconcile Pods, Services, PVCs
- ⚙ Manage Sharding topology changes
- ⚙ roleProbe: exec /tools/dbctl redis getrole in redis-cluster container
- ⚙ Scale shards in/out (rebalance slots)
- ⚙ Manage SystemAccount Secrets -
-
-
- {/* Legend */}
KubeBlocks Operator (control plane)
@@ -483,7 +339,6 @@ export default function RedisClusterArchitectureDiagram() {
Shard Primary
Shard Replica
Gossip / Cluster Bus
-
Failover Path
Hash Slots
diff --git a/src/components/RedisStandaloneArchitectureDiagram.tsx b/src/components/RedisStandaloneArchitectureDiagram.tsx new file mode 100644 index 0000000..41a110d --- /dev/null +++ b/src/components/RedisStandaloneArchitectureDiagram.tsx @@ -0,0 +1,226 @@ +import React from 'react'; + +export default function RedisStandaloneArchitectureDiagram() { + return ( + <> + + +
+ + {/* ══ MAIN AREA: data plane (left) + sidebar (right) ══ */} +
+ + {/* LEFT: Client → Service → Pod */} +
+ + {/* Client */} +
+ + + + +
+
Application / Client
+
+ Read/Write  redis-standalone-redis-redis:6379
+ 「redis-standalone」为示例 cluster 名 +
+
+
+ + {/* Arrow: Client → Service */} +
+
+
+
+ RW traffic → single pod +
+ + {/* Service */} +
+
+ + Kubernetes Services +
+
+
redis-standalone-redis-redis
+
+ ClusterIP · :6379
+ selector: all redis pods (no role filter)
+ Direct connection to the single Redis instance +
+ ReadWrite +
+
+ + {/* Arrow: Service → Pod */} +
+
+
+
+ → redis-0 +
+ + {/* Pods */} +
+
Redis Pod · Worker Node
+ +
+
+ redis-0 + STANDALONE +
+
+
+ 🔴 +
+
redis (Redis Server)
+
:6379 · standalone mode · accepts all R/W
+
+
+
+ 🔍 +
+
[init] dbctl (→ /tools/dbctl)
+
copies dbctl binary for roleProbe
+
+
+
+ 📊 +
+
redis-exporter
+
:9121 metrics (Prometheus)
+
+
+
+
💾 PVC data-0 · 20Gi · RDB / AOF data directory
+
+ +
+ 🔗 + Headless service — stable pod DNS for operator probes and internal use; not a client endpoint +
+
+ +
{/* /data-plane */} + +
{/* /main-area */} + + {/* Legend */} +
+
KubeBlocks Operator (control plane)
+
CRD Resource
+
RW Traffic
+
Persistent Storage
+
+ +
+ + ); +} diff --git a/src/components/RocketmqArchitectureDiagram.tsx b/src/components/RocketmqArchitectureDiagram.tsx index 0fdcb30..655ec81 100644 --- a/src/components/RocketmqArchitectureDiagram.tsx +++ b/src/components/RocketmqArchitectureDiagram.tsx @@ -17,8 +17,6 @@ export default function RocketmqArchitectureDiagram() { .rocketmq-ha-diagram .dot-blue { background: #388bfd; } .rocketmq-ha-diagram .dot-green { background: #3fb950; } .rocketmq-ha-diagram .dot-purple { background: #a371f7; } - .rocketmq-ha-diagram .dot-orange { background: #e3b341; } - .rocketmq-ha-diagram .dot-teal { background: #56d4dd; } .rocketmq-ha-diagram .dot-red { background: #f85149; } .rocketmq-ha-diagram .card-title { font-size: 11px; font-weight: 700; letter-spacing: 1.5px; @@ -31,10 +29,6 @@ export default function RocketmqArchitectureDiagram() { .rocketmq-ha-diagram .data-plane { flex: 1; display: flex; flex-direction: column; gap: 0; } - .rocketmq-ha-diagram .mgmt-sidebar { - width: 260px; flex-shrink: 0; - display: flex; flex-direction: column; gap: 12px; padding-top: 4px; - } .rocketmq-ha-diagram .client-mini { border-radius: 12px; border: 1px solid #30363d; background: #161b22; padding: 12px 16px; @@ -147,48 +141,6 @@ export default function RocketmqArchitectureDiagram() { padding: 7px; border-radius: 8px; background: #0a1a14; border: 1px solid #238636; margin-top: 10px; font-size: 11px; color: #3fb950; } - .rocketmq-ha-diagram .sidebar-card { border-radius: 10px; border: 1px solid; padding: 12px 14px; } - .rocketmq-ha-diagram .dcs-card { border-color: #1b7c83; background: #0a1e20; } - .rocketmq-ha-diagram .dcs-items { display: flex; flex-direction: column; gap: 5px; margin-top: 8px; } - .rocketmq-ha-diagram .dcs-item { - padding: 5px 9px; border-radius: 6px; border: 1px solid #1b7c8355; - background: #061515; font-size: 10px; color: #56d4dd; line-height: 1.5; - } - .rocketmq-ha-diagram .dcs-item span { color: #7d8590; } - .rocketmq-ha-diagram .failover-card { border-color: #da3633; background: #1c0a0a; } - .rocketmq-ha-diagram .failover-steps { display: flex; flex-direction: column; gap: 4px; margin-top: 8px; } - .rocketmq-ha-diagram .step { display: flex; align-items: flex-start; gap: 7px; font-size: 10px; color: #cdd9e5; line-height: 1.5; } - .rocketmq-ha-diagram .step-num { - width: 16px; height: 16px; border-radius: 50%; flex-shrink: 0; - background: #da363322; border: 1px solid #da363388; - display: flex; align-items: center; justify-content: center; - font-size: 9px; font-weight: 700; color: #f85149; margin-top: 1px; - } - .rocketmq-ha-diagram .accounts-card { border-color: #d2992244; background: #1a1505; } - .rocketmq-ha-diagram .accounts-grid { display: flex; flex-wrap: wrap; gap: 5px; margin-top: 8px; } - .rocketmq-ha-diagram .acc-chip { - padding: 3px 8px; border-radius: 5px; - border: 1px solid #d2992233; background: #0d0d00; font-size: 10px; color: #e3b341; - } - .rocketmq-ha-diagram .acc-chip span { color: #484f58; font-size: 9px; display: block; } - .rocketmq-ha-diagram .operator-block { - flex: 1; border-radius: 12px; border: 1px solid #1f6feb; - background: #0d1f38; padding: 16px 20px; - } - .rocketmq-ha-diagram .operator-controllers { display: flex; gap: 8px; margin-top: 8px; } - .rocketmq-ha-diagram .ctrl-chip { - flex: 1; padding: 8px 10px; border-radius: 8px; border: 1px solid #1f6feb44; - background: #0a1628; font-size: 11px; color: #79c0ff; text-align: center; - } - .rocketmq-ha-diagram .ctrl-chip .ctrl-name { font-weight: 700; font-size: 12px; display: block; margin-bottom: 2px; } - .rocketmq-ha-diagram .ctrl-chip .ctrl-sub { font-size: 10px; color: #4a7ab5; } - .rocketmq-ha-diagram .crd-chain { display: flex; align-items: center; gap: 6px; margin-top: 10px; flex-wrap: wrap; } - .rocketmq-ha-diagram .crd-chip { padding: 4px 10px; border-radius: 20px; border: 1px solid; font-size: 11px; font-weight: 600; white-space: nowrap; } - .rocketmq-ha-diagram .crd-chip.cluster { border-color: #a371f7; color: #d2a8ff; background: #2d1f5e; } - .rocketmq-ha-diagram .crd-chip.component { border-color: #79c0ff; color: #79c0ff; background: #1a3050; } - .rocketmq-ha-diagram .crd-chip.instanceset { border-color: #7ee787; color: #7ee787; background: #1a3020; } - .rocketmq-ha-diagram .crd-chip.pod { border-color: #e3b341; color: #e3b341; background: #302010; } - .rocketmq-ha-diagram .crd-arrow { color: #484f58; font-size: 14px; } .rocketmq-ha-diagram .legend { display: flex; gap: 18px; flex-wrap: wrap; justify-content: center; padding-top: 8px; border-top: 1px solid #21262d; margin-top: 16px; @@ -437,116 +389,8 @@ export default function RocketmqArchitectureDiagram() {
{/* /data-plane */} - {/* RIGHT SIDEBAR */} -
- - {/* HA Mechanism */} -
-
- - ASYNC_MASTER/SLAVE + NameServer -
-
-
- NameServer
- stateless registry · producers/consumers discover broker addresses here -
-
- ASYNC_MASTER/SLAVE
- default mode · master (brokerId=0) replicates to slaves asynchronously on port 10912 -
-
- Secret account-*
- ACL credentials -
-
-
- - {/* Failover */} -
-
- - Failover Process -
-
-
1Master Broker Pod crashes
-
2Slaves detect missing master heartbeat; writes unavailable; slaves continue serving reads
-
3KubeBlocks restarts the failed pod
-
4Recovered pod starts as master (brokerId=0), re-registers with NameServer
-
5Slaves reconnect on port 10912 and resync missed log entries
-
-
- - {/* System Accounts */} -
-
- - System Accounts -
-
-
adminsuperuser
-
kbdataprotectionbackup
-
kbprobemonitor
-
-
- -
{/* /sidebar */}
{/* /main-area */} - {/* ══ SEPARATOR ══ */} -
-
- Management Plane · KubeBlocks Operator -
-
- - {/* ══ BOTTOM: Operator ══ */} -
-
-
- - KubeBlocks Operator - · watches & reconciles CRDs, drives creation and reconciliation of all above resources -
-
-
- Apps Controller - Cluster / Component -
-
- Workloads Controller - InstanceSet → Pods -
-
- Ops Controller - Switchover / Scale -
-
-
-
CRD RESOURCE HIERARCHY
-
-
Cluster
- → -
Component ×2
- → -
InstanceSet
- → -
Pods
-
-
-
- -
-
Operator Responsibilities
-
- ⚙ Create / reconcile Pods, Services, PVCs
- ⚙ roleProbe: exec /scripts/get-role.sh per pod
- ⚙ Update Pod label role=master (drives rolling update order)
- ⚙ Restart failed pods (no auto master election)
- ⚙ Execute switchover / scale ops -
-
-
{/* Legend */}
@@ -554,8 +398,6 @@ export default function RocketmqArchitectureDiagram() {
CRD Resource
Master Broker / Write Traffic
Slave Pod
-
ASYNC_MASTER/SLAVE Replication
-
Failover Path
Persistent Storage
diff --git a/src/components/ZookeeperArchitectureDiagram.tsx b/src/components/ZookeeperArchitectureDiagram.tsx index e7e615b..f959a29 100644 --- a/src/components/ZookeeperArchitectureDiagram.tsx +++ b/src/components/ZookeeperArchitectureDiagram.tsx @@ -17,8 +17,6 @@ export default function ZookeeperArchitectureDiagram() { .zk-ha-diagram .dot-blue { background: #388bfd; } .zk-ha-diagram .dot-green { background: #3fb950; } .zk-ha-diagram .dot-purple { background: #a371f7; } - .zk-ha-diagram .dot-orange { background: #e3b341; } - .zk-ha-diagram .dot-teal { background: #56d4dd; } .zk-ha-diagram .dot-red { background: #f85149; } .zk-ha-diagram .card-title { font-size: 11px; font-weight: 700; letter-spacing: 1.5px; @@ -31,10 +29,6 @@ export default function ZookeeperArchitectureDiagram() { .zk-ha-diagram .data-plane { flex: 1; display: flex; flex-direction: column; gap: 0; } - .zk-ha-diagram .mgmt-sidebar { - width: 260px; flex-shrink: 0; - display: flex; flex-direction: column; gap: 12px; padding-top: 4px; - } .zk-ha-diagram .client-mini { border-radius: 12px; border: 1px solid #30363d; background: #161b22; padding: 12px 16px; @@ -138,49 +132,7 @@ export default function ZookeeperArchitectureDiagram() { padding: 7px; border-radius: 8px; background: #0a1a14; border: 1px solid #238636; margin-top: 10px; font-size: 11px; color: #3fb950; } - .zk-ha-diagram .sidebar-card { border-radius: 10px; border: 1px solid; padding: 12px 14px; } - .zk-ha-diagram .dcs-card { border-color: #1b7c83; background: #0a1e20; } - .zk-ha-diagram .dcs-items { display: flex; flex-direction: column; gap: 5px; margin-top: 8px; } - .zk-ha-diagram .dcs-item { - padding: 5px 9px; border-radius: 6px; border: 1px solid #1b7c8355; - background: #061515; font-size: 10px; color: #56d4dd; line-height: 1.5; - } - .zk-ha-diagram .dcs-item span { color: #7d8590; } - .zk-ha-diagram .failover-card { border-color: #da3633; background: #1c0a0a; } - .zk-ha-diagram .failover-steps { display: flex; flex-direction: column; gap: 4px; margin-top: 8px; } - .zk-ha-diagram .step { display: flex; align-items: flex-start; gap: 7px; font-size: 10px; color: #cdd9e5; line-height: 1.5; } - .zk-ha-diagram .step-num { - width: 16px; height: 16px; border-radius: 50%; flex-shrink: 0; - background: #da363322; border: 1px solid #da363388; - display: flex; align-items: center; justify-content: center; - font-size: 9px; font-weight: 700; color: #f85149; margin-top: 1px; - } - .zk-ha-diagram .accounts-card { border-color: #d2992244; background: #1a1505; } - .zk-ha-diagram .accounts-grid { display: flex; flex-wrap: wrap; gap: 5px; margin-top: 8px; } - .zk-ha-diagram .acc-chip { - padding: 3px 8px; border-radius: 5px; - border: 1px solid #d2992233; background: #0d0d00; font-size: 10px; color: #e3b341; - } - .zk-ha-diagram .acc-chip span { color: #484f58; font-size: 9px; display: block; } - .zk-ha-diagram .operator-block { - flex: 1; border-radius: 12px; border: 1px solid #1f6feb; - background: #0d1f38; padding: 16px 20px; - } - .zk-ha-diagram .operator-controllers { display: flex; gap: 8px; margin-top: 8px; } - .zk-ha-diagram .ctrl-chip { - flex: 1; padding: 8px 10px; border-radius: 8px; border: 1px solid #1f6feb44; - background: #0a1628; font-size: 11px; color: #79c0ff; text-align: center; - } - .zk-ha-diagram .ctrl-chip .ctrl-name { font-weight: 700; font-size: 12px; display: block; margin-bottom: 2px; } - .zk-ha-diagram .ctrl-chip .ctrl-sub { font-size: 10px; color: #4a7ab5; } - .zk-ha-diagram .crd-chain { display: flex; align-items: center; gap: 6px; margin-top: 10px; flex-wrap: wrap; } - .zk-ha-diagram .crd-chip { padding: 4px 10px; border-radius: 20px; border: 1px solid; font-size: 11px; font-weight: 600; white-space: nowrap; } - .zk-ha-diagram .crd-chip.cluster { border-color: #a371f7; color: #d2a8ff; background: #2d1f5e; } - .zk-ha-diagram .crd-chip.component { border-color: #79c0ff; color: #79c0ff; background: #1a3050; } - .zk-ha-diagram .crd-chip.instanceset { border-color: #7ee787; color: #7ee787; background: #1a3020; } - .zk-ha-diagram .crd-chip.pod { border-color: #e3b341; color: #e3b341; background: #302010; } - .zk-ha-diagram .crd-arrow { color: #484f58; font-size: 14px; } - .zk-ha-diagram .legend { + .zk-ha-diagram .legend { display: flex; gap: 18px; flex-wrap: wrap; justify-content: center; padding-top: 8px; border-top: 1px solid #21262d; margin-top: 16px; } @@ -340,129 +292,13 @@ export default function ZookeeperArchitectureDiagram() {
{/* /data-plane */} - {/* RIGHT SIDEBAR */} -
- - {/* HA Mechanism */} -
-
- - ZAB Atomic Broadcast - (HA Mechanism) -
-
-
- myid file / unique server ID per pod
- stable ordinal -
-
- ConfigMap {'{scope}'}-config
- zoo.cfg · server list -
-
- Secret account-*
- superDigest credentials -
-
-
- - {/* Failover */} -
-
- - Failover Process -
-
-
1Leader Pod crashes
-
2ZAB heartbeat timeout (tickTime × initLimit)
-
3Follower starts leader election
-
4ZXID-based voting → new leader elected
-
5roleProbe detects new leader
-
6Pod label role=leader updated
-
7Service Endpoints auto-switch
-
-
- - {/* System Accounts */} -
-
- - System Accounts -
-
-
supersuperuser (digest auth)
-
kbadminadmin
-
kbdataprotectionbackup
-
kbprobemonitor
-
-
- -
{/* /sidebar */}
{/* /main-area */} - - {/* ══ SEPARATOR ══ */} -
-
- Management Plane · KubeBlocks Operator -
-
- - {/* ══ BOTTOM: Operator ══ */} -
-
-
- - KubeBlocks Operator - · watches & reconciles CRDs, drives creation and reconciliation of all above resources -
-
-
- Apps Controller - Cluster / Component -
-
- Workloads Controller - InstanceSet → Pods -
-
- Ops Controller - Switchover / Scale -
-
-
-
CRD RESOURCE HIERARCHY
-
-
Cluster
- → -
Component
- → -
InstanceSet
- → -
Pod × 3
-
-
-
- -
-
Operator Responsibilities
-
- ⚙ Create / reconcile Pods, Services, PVCs
- ⚙ roleProbe: probe role every 1s
- ⚙ Update Pod label role=leader
- ⚙ Execute switchover / scale ops
- ⚙ Manage SystemAccount Secrets -
-
-
- {/* Legend */}
KubeBlocks Operator (control plane)
CRD Resource
Leader / Client Traffic
Follower Pod
-
ZAB Atomic Broadcast
-
Failover Path
Persistent Storage