How alexalkhatib/fleetman-kubernetes-deployment works
4KUBE packages and operates Fleetman’s six-service Kubernetes deployment, with local and production Kustomize overlays and a Docker Compose alternative. Its principal flow is GPS simulation → message broker → position persistence → REST gateway → web interface. A separate browser console presents deployment architecture, cluster/manifests information, a simulated runbook, and project documents from static project data; it does not connect to a live cluster. Console call relationships are based on sampled source; deployment and service relationships are documented in the README.
Main entry points: App.tsx Console shell · Overview.tsx Overview · Cluster.tsx Cluster explorer · YamlCode.tsx YAML display
Components 23
Fleetman services
- Position simulator
kubernetes/base/fleetman-position-simulator.yaml - ActiveMQ queue
kubernetes/base/fleetman-queue.yaml - Position tracker
kubernetes/base/fleetman-position-tracker.yaml - MongoDB
kubernetes/base/fleetman-mongodb.yaml - API gateway
kubernetes/base/fleetman-api-gateway.yaml - Fleetman webapp
kubernetes/base/fleetman-webapp.yaml
Deployment configuration
- Shared resources
kubernetes/base/kustomization.yaml - Local overlay
kubernetes/overlays/local/kustomization.yaml - Production overlay
kubernetes/overlays/production/kustomization.yaml - Compose setup
docker/compose.yaml
Operations
- Deploy script
scripts/deploy.sh
4KUBE console
- Console shell
console/src/App.tsx - Project data
console/src/data/project.json - Overview
console/src/views/Overview.tsx - Architecture view
console/src/components/Architecture.tsx - Cluster explorer
console/src/views/Cluster.tsx - Runbook view
console/src/views/Deploy.tsx - Manifest browser
console/src/views/Manifests.tsx - Docs and deliverables
console/src/views/Docs.tsx - YAML display
console/src/components/YamlCode.tsx - Display formatters
console/src/lib/format.ts
Other components
- Operator
- Kubernetes cluster
Connections 27
- Position simulator → ActiveMQ queue: publishes positions
readme.md - Position tracker → ActiveMQ queue: consumes messages
readme.md - Position tracker → MongoDB: writes positions
readme.md - API gateway → MongoDB: reads positions
readme.md - Fleetman webapp → API gateway: REST requests
readme.md - Local overlay → Shared resources: uses resources
readme.md - Production overlay → Shared resources: uses resources
readme.md - Operator → Deploy script: starts deployment
readme.md - Deploy script → Kubernetes cluster: applies manifests
readme.md - Operator → Kubernetes cluster: applies local overlay
readme.md - Compose setup → Kubernetes cluster: runs alternative
- Operator → Console shell: browses console
- Console shell → Overview: renders view
console/src/App.tsx - Console shell → Cluster explorer: renders view
console/src/App.tsx - Console shell → Runbook view: renders view
console/src/App.tsx - Console shell → Manifest browser: renders view
console/src/App.tsx - Console shell → Docs and deliverables: renders view
console/src/App.tsx - Overview → Project data: displays project
- Overview → Architecture view: renders diagram
console/src/views/Overview.tsx - Cluster explorer → Project data: displays workloads
console/src/views/Cluster.tsx - Manifest browser → Project data: displays manifests
- Overview → YAML display: renders commands
console/src/views/Overview.tsx - Cluster explorer → YAML display: renders YAML
console/src/views/Cluster.tsx - Runbook view → YAML display: renders commands
console/src/views/Deploy.tsx - Docs and deliverables → YAML display: renders commands
console/src/views/Docs.tsx - Cluster explorer → Display formatters: formats resource data
console/src/views/Cluster.tsx - Overview → Display formatters: formats summary
console/src/views/Overview.tsx