REFACTORING: Clean up obsolete components and establish proper architecture
Phase 1 Complete - Cleanup:
- ❌ Deleted 4 obsolete deployment scripts (deploy-*.sh, deploy-*.py)
- 📁 Moved 4 old architecture docs to docs/reference/ (read-only)
- 🏗️ Created clean directory structure for modern stack
Files Removed:
- deploy-orion.sh (3,500 lines) - Obsolete Proxmox deployment
- deploy-orion-hybrid.py (600 lines) - Incomplete hybrid approach
- deploy-ai-maze.sh (350 lines) - Conflicts with IaC strategy
- deploy-ipv6-routing.sh (350 lines) - Becomes Ansible playbook
Docs Archived to docs/reference/:
- DELL_R730_ORION_PROXMOX_INTEGRATION.md (reference only)
- ORION_HYBRID_ARCHITECTURE.md (superseded)
- ORION_QUICKSTART.md (obsolete)
- QUICKSTART_HYBRID.md (obsolete)
New Directory Structure Created:
ansible/ # Configuration management
├── inventory/ # Dynamic inventory from NetBox
├── playbooks/ # Deployment playbooks
├── roles/ # Reusable roles
│ ├── common/ # Base configuration
│ ├── bird2/ # BGP routing (Phase 1)
│ ├── gobgp/ # BGP routing (Phase 2)
│ ├── k3s-master/ # K8s control plane
│ ├── k3s-worker/ # K8s worker nodes
│ ├── netbox/ # IPAM deployment
│ ├── ollama/ # LLM inference
│ └── ai-coordinator/ # Multi-agent orchestration
├── group_vars/ # Group-level variables
└── host_vars/ # Host-specific variables
kubernetes/ # K8s manifests
├── infrastructure/ # Platform services
│ ├── kube-prometheus-stack/ # Monitoring
│ ├── cilium/ # CNI networking
│ └── longhorn/ # Distributed storage
├── applications/ # Business workloads
│ ├── backstage/ # Developer portal
│ └── vapor-api/ # Swift API middleware
└── ai-agents/ # AI/Agent ecosystem ⭐ NEW
├── ollama/ # Local LLM (llama3, codellama)
├── litelm/ # API gateway
├── langchain-service/ # Orchestration layer
└── agents/ # Specialized agents
├── infrastructure-agent/ # Monitors infra
├── network-agent/ # Manages BGP/routing
├── security-agent/ # Security automation
└── devops-agent/ # CI/CD automation
docs/ # Documentation
├── deployment-guide/ # How to deploy
├── ai-agent-design/ # AI architecture
├── network-design/ # Networking details
└── reference/ # Historical docs (archived)
scripts/helpers/ # Utility scripts only
Benefits:
- Single deployment path: Terraform → Ansible → K8s
- Proper domain separation (infra, platform, apps, AI)
- No conflicting scripts or overlapping docs
- Clear AI/agent architecture with inference layer
- Ready for implementation of missing components
Next Phase:
- Build Terraform main.tf and modules
- Create Ansible playbooks
- Implement AI/agent K8s manifests
- Create master ARCHITECTURE.md
- Build Makefile for one-command deployment
Status: ✅ Cleanup complete, foundation ready
b972a62ccb