18 KiB
18 KiB
🏗️ Infrastructure Architecture — Knowledge Base
Comprehensive overview of topics, principles, and best practices for infrastructure design and operations.
Bilingual: Czech (.md) and English (.en.md).
Topic Map — Relationships Between Areas
┌─────────────┐
│ CLOUD │
│ (IaaS/PaaS)│
└──────┬──────┘
│
┌──────────────┼──────────────┐
▼ ▼ ▼
┌──────────┐ ┌──────────┐ ┌──────────────┐
│NETWORKING│ │ STORAGE │ │ DATABASES │
│(L2-L7, │ │(SAN/NAS/ │ │ (SQL/NOSQL/ │
│ Zero Tr.)│ │ Ceph/SDS)│ │ Vector) │
└────┬─────┘ └────┬─────┘ └──────┬───────┘
│ │ │
▼ ▼ ▼
┌─────────────────────────────────────┐
│ DATACENTERS │
│ (Tier, power, cooling, layout) │
└────────────┬────────────────────────┘
│
┌────────────┼────────────┬───────────────┐
▼ ▼ ▼ ▼
┌──────────┐ ┌──────────┐ ┌────────┐ ┌──────────────┐
│SERVER-HW │ │SERVER- │ │ GPU │ │ PROVISIONING │
│(CPU,RAM, │ │CONFIG │ │(NVIDIA/│ │ (PXE, Ironic │
│ PCIe,BM) │ │(BIOS, │ │ AMD) │ │ Terraform) │
└──────────┘ │ NUMA) │ └────────┘ └──────────────┘
└──────────┘
┌──────────┐ ┌──────────┐ ┌────────┐ ┌────────────┐
│HYPERVISOR│ │ MONITOR │ │ CICD │ │ ☸ K8s │
│(VMware, │ │(Prom, │ │(GitOps, │ │(CAPI, K3s, │
│ KVM, ...)│ │ Grafana) │ │ IaC) │ │ RKE2...) │
└──────────┘ └──────────┘ └────────┘ └────────────┘
Navigation — Czech (.md)
| Area | File | Description | Related to |
|---|---|---|---|
| ☁️ Cloud architecture | CLOUD.md | AWS/Azure/GCP, hybrid cloud, multi-cloud | GPU, NETWORKING |
| 🌐 Network architecture | NETWORKING.md | DNS, BGP, VPC, Zero Trust, EVPN VXLAN, TLS | CLOUD |
| 📊 Monitoring & observability | MONITORING.md | Prometheus, Grafana, OTel, logging, alerting | — |
| 🔄 CI/CD & DevOps | CICD.md | Pipelines, GitOps, IaC (Terraform), deployment | — |
| 💻 Operační systémy | OS.md | Linux distribuce, Windows Server, lifecycle, EOL, kernel | KUBERNETES, HYPERVISORS, AI-INFRASTRUCTURE |
| 🔄 Disaster Recovery | DR.md | RTO, RPO, scenarios, prevention, uptime calculation | CLOUD, DATACENTERS, MONITORING |
| 🗄️ Database architecture | DATABASES.md | Classification, sharding, replication, caching | POSTGRESQL, MYSQL, ORACLE, MONGODB, REDIS, CASSANDRA, VEKTOROVE-DB, DATABAZOVE-ENGINY |
| 🗄️ Big Data | BIG-DATA.md | HDFS, Spark, Flink, Trino, Iceberg, Delta Lake, Lakehouse | DATABASES, CLOUD, MESSAGING, KUBERNETES |
| 🖥️ Hypervisors | HYPERVISORS.md | VMware, Hyper-V, KVM, Proxmox, migration | STORAGE, SERVER-HW |
| 🏭 Data centers | DATACENTERS.md | Tier, power, cooling, layout, DC services, secondary DC topologies | MONITORING, MESSAGING |
| 💾 Storage | STORAGE.md | SAN/NAS/object, RAID, SDS, Ceph, OpenStack Cinder/Swift/Manila | — |
| 🔌 Server connectivity | CONNECTIVITY.md | Ethernet, FC SAN, iSCSI, NVMe-oF, SAS | — |
| 🔧 Server hardware | SERVER-HW.md | CPU, RAM, PCIe, NUMA, BMC | CONNECTIVITY |
| 🎮 GPU | GPU.md | NVIDIA/AMD, NVLink, MIG/vGPU, AI, Cyborg | — |
| ⚙️ Server config | SERVER-CONFIG.md | BIOS tuning, DB/hypervisor/K8s/storage best practices | — |
| 📦 Provisioning | PROVISIONING.md | PXE, Redfish, Terraform, Ironic, OpenStack deploy | CICD |
| ☸ Kubernetes | KUBERNETES.md | K8s architektura, deployment, Cluster API (CAPI) | CICD, CLOUD, NETWORKING |
| 📨 Messaging & streaming | MESSAGING.md | Kafka, RabbitMQ, Pulsar, NATS, managed queue/pubsub | DATACENTERS, CLOUD |
| 🏗️ Migrace DC | DC-MIGRATION.md | Strategie, fáze, network, DB, rollback | DATACENTERS, CLOUD, DR, NETWORKING, STORAGE |
| 🧠 AI infrastruktura | AI-INFRASTRUCTURE.md | GPU, AI networking, storage, cluster, cooling, training/inference | GPU, NETWORKING, STORAGE, DATACENTERS, CLOUD |
| 📋 Legacy index | HARDWARE.md | → SERVER-HW, GPU, SERVER-CONFIG, PROVISIONING | SERVER-HW, GPU, SERVER-CONFIG, PROVISIONING |
| 📋 Legacy infra | INFRASTRUCTURE.md | → HYPERVISORS, DATACENTERS, STORAGE, HARDWARE | HYPERVISORS, DATACENTERS, STORAGE, HARDWARE |
| 📋 Review workflow | REVIEW.md | Review and content control process | — |
| 📝 ADR template | templates/ADR.md | Architecture Decision Record template | — |
Detailed DB files
| File | Description |
|---|---|
| POSTGRESQL.en.md | PostgreSQL — architecture, replication, tuning |
| MYSQL.en.md | MySQL & MariaDB |
| ORACLE.en.md | Oracle Database — RAC, Data Guard, tuning |
| MONGODB.en.md | MongoDB — document DB, sharding, replica sets |
| REDIS.en.md | Redis — cache, session store, streams |
| CASSANDRA.en.md | Cassandra & ScyllaDB — wide-column, nosql |
| VEKTOROVE-DB.md | Vector databases — Pinecone, Qdrant, Milvus, pgvector |
| DATABAZOVE-ENGINY.md | Common DB concepts — transactions, indexes, locking |
Navigation — English (.en.md)
| Area | File | Description | Related to |
|---|---|---|---|
| ☁️ Cloud architecture | CLOUD.en.md | AWS/Azure/GCP, hybrid cloud, multi-cloud | GPU, NETWORKING |
| 🌐 Network architecture | NETWORKING.en.md | DNS, BGP, VPC, Zero Trust, EVPN VXLAN, TLS | CLOUD |
| 📊 Monitoring & observability | MONITORING.en.md | Prometheus, Grafana, OTel, logging, alerting | — |
| 🔄 CI/CD & DevOps | CICD.en.md | Pipelines, GitOps, IaC (Terraform), deployment | — |
| 💻 Operating systems | OS.en.md | Linux distributions, Windows Server, lifecycle, EOL, kernel | KUBERNETES, HYPERVISORS, AI-INFRASTRUCTURE |
| 🔄 Disaster Recovery | DR.en.md | RTO, RPO, scenarios, prevention, uptime calculation | CLOUD, DATACENTERS, MONITORING |
| 🗄️ Database architecture | DATABASES.en.md | Classification, sharding, replication, caching | POSTGRESQL, MYSQL, ORACLE, MONGODB, REDIS, CASSANDRA, VECTOR-DBS, DATABASE-ENGINES |
| 🗄️ Big Data | BIG-DATA.en.md | HDFS, Spark, Flink, Trino, Iceberg, Delta Lake, Lakehouse | DATABASES, CLOUD, MESSAGING, KUBERNETES |
| 🖥️ Hypervisors | HYPERVISORS.en.md | VMware, Hyper-V, KVM, Proxmox, migration | STORAGE, SERVER-HW |
| 🏭 Data centers | DATACENTERS.en.md | Tier, power, cooling, layout, DC services, secondary DC topologies | MONITORING, MESSAGING |
| 💾 Storage | STORAGE.en.md | SAN/NAS/object, RAID, SDS, Ceph | — |
| 🔌 Server connectivity | CONNECTIVITY.en.md | Ethernet, FC SAN, iSCSI, NVMe-oF, SAS | — |
| 🔧 Server hardware | SERVER-HW.en.md | CPU, RAM, PCIe, NUMA, BMC | CONNECTIVITY |
| 🎮 GPU | GPU.en.md | NVIDIA/AMD, NVLink, MIG/vGPU, AI, Cyborg | — |
| ⚙️ Server config | SERVER-CONFIG.en.md | BIOS tuning, DB/hypervisor/K8s/storage best practices | — |
| 📦 Provisioning | PROVISIONING.en.md | PXE, Redfish, Terraform, Ironic, OpenStack deploy | CICD |
| ☸ Kubernetes | KUBERNETES.en.md | K8s architecture, deployment, Cluster API (CAPI) | CICD, CLOUD, NETWORKING |
| 📨 Messaging & streaming | MESSAGING.en.md | Kafka, RabbitMQ, Pulsar, NATS, managed queue/pubsub | DATACENTERS, CLOUD |
| 🏗️ DC Migration | DC-MIGRATION.en.md | Strategies, phases, network, DB, rollback | DATACENTERS, CLOUD, DR, NETWORKING, STORAGE |
| 🧠 AI Infrastructure | AI-INFRASTRUCTURE.en.md | GPU, AI networking, storage, cluster, cooling, training/inference | GPU, NETWORKING, STORAGE, DATACENTERS, CLOUD |
| 📋 Legacy index | HARDWARE.en.md | → SERVER-HW, GPU, SERVER-CONFIG, PROVISIONING | SERVER-HW, GPU, SERVER-CONFIG, PROVISIONING |
| 📋 Legacy infra | INFRASTRUCTURE.en.md | → HYPERVISORS, DATACENTERS, STORAGE, HARDWARE | HYPERVISORS, DATACENTERS, STORAGE, HARDWARE |
| 📋 Review workflow | REVIEW.en.md | Review and content control process | — |
| 📝 ADR template | templates/ADR.en.md | Architecture Decision Record template | — |
Detailed DB files
| File | Description |
|---|---|
| POSTGRESQL.en.md | PostgreSQL — architecture, replication, tuning |
| MYSQL.en.md | MySQL & MariaDB |
| ORACLE.en.md | Oracle Database — RAC, Data Guard, tuning |
| MONGODB.en.md | MongoDB — document DB, sharding, replica sets |
| REDIS.en.md | Redis — cache, session store, streams |
| CASSANDRA.en.md | Cassandra & ScyllaDB — wide-column, nosql |
| VECTOR-DBS.en.md | Vector databases — Pinecone, Qdrant, Milvus, pgvector |
| DATABASE-ENGINES.en.md | Common DB concepts — transactions, indexes, locking |
Case Studies
| File | Description |
|---|---|
| case-studies/proxmox-demo/README.md | Proxmox VE demo cluster — návrh (CZ) |
| case-studies/proxmox-demo/README.en.md | Proxmox VE demo cluster — design (EN) |
Cross-Reference Matrix
Sources
Raw reference data (documentation, books, standards) by area:
| Area | Czech | English |
|---|---|---|
| ☁️ Cloud | sources/cloud/sources.md |
sources/cloud/sources.en.md |
| 🌐 Networking | sources/networking/sources.md |
sources/networking/sources.en.md |
| 📊 Monitoring | sources/monitoring/sources.md |
sources/monitoring/sources.en.md |
| 🔄 CI/CD | sources/cicd/sources.md |
sources/cicd/sources.en.md |
| 🗄️ Databases | sources/databases/sources.md |
sources/databases/sources.en.md |
| 🏗️ Infrastructure | sources/infrastructure/sources.md |
sources/infrastructure/sources.en.md |
KB Agents
| Agent | Description |
|---|---|
kb-research |
Processes [todo] items — research on new topics |
kb-source-scout |
Finds new sources and adds them to sources/ |
kb-reviewer |
Audits consistency, links, duplications, formatting |
kb-index |
Maintains this index — scans files, extracts cross-references, validates links |
Principles
| Czech | English |
|---|---|
| Dostupnost — SLA, redundance, failover, multi-AZ | Availability — SLA, redundancy, failover, multi-AZ |
| Škálovatelnost — horizontální vs. vertikální, auto-scaling | Scalability — horizontal vs. vertical, auto-scaling |
| Bezpečnost — defense in depth, least privilege, zero trust | Security — defense in depth, least privilege, zero trust |
| Náklady — FinOps, right-sizing, reserved instances | Cost — FinOps, right-sizing, reserved instances |
| Operability — observabilita, automation, dokumentace | Operability — observability, automation, documentation |
This index is automatically maintained by the kb-index agent. Last updated: 2026-06-18.