Integrate ProxmoxVE helper-scripts and create comprehensive architecture documentation
This commit integrates the 396 helper scripts from the ProxmoxVE repository and establishes
comprehensive architecture documentation for the ORION v2.0 infrastructure.
Changes:
1. Makefile enhancements:
- Add deploy-lxc target for all LXC container deployments
- Add deploy-ai-stack target for AI/ML stack (Ollama, OpenWebUI, LiteLLM, FlowiseAI, PostgreSQL, Redis)
- Add deploy-infrastructure target for infrastructure services (Minio, Nginx Proxy Manager, Wireguard)
- Add deploy-dev-tools target for development tools (Gitea, N8N)
- Add deploy-full target for complete deployment (VMs + LXC + Ansible + K8s)
- Update quickstart guide to reflect new deployment phases
2. ARCHITECTURE.md (NEW):
- Complete v2.0 architecture documentation
- Multi-layer architecture overview (Infrastructure VMs, LXC Containers, K8s Workloads)
- Network architecture with IPv6 BGP routing
- 4-layer AI/Agent stack design (Inference → Orchestration → Agents → Coordinator)
- "AI Maze" security architecture explanation
- LXC vs K8s comparison and deployment strategy
- Complete repository structure documentation
- Resource allocation and migration paths
- Operations and troubleshooting guides
3. docs/HELPER_SCRIPTS_INTEGRATION.md (NEW):
- Analysis of 396 ProxmoxVE helper scripts
- Tier 1 (Must Integrate): AI/ML stack scripts
- Tier 2 (Highly Recommended): Infrastructure services
- Tier 3 (Useful): Development tools
- LXC vs K8s comparison showing why LXC is better for AI/ML
- Deployment time reduction from 4-6 hours to 5 minutes
- Updated ORION architecture diagram with LXC containers
- Integration recommendations and action items
4. README.md updates:
- Rebrand as "ORION v2.0 - AI-First Infrastructure Stack"
- Highlight new features: IaC, LXC AI/ML, K3s, Multi-Agent Architecture
- Update architecture overview with new 3-layer design
- Update repository structure
- Add v1.0 vs v2.0 comparison table
- Link to new ARCHITECTURE.md as main documentation
- Keep original OSX-PROXMOX guide for reference
Key architectural decisions:
- Use LXC containers (via helper scripts) for AI/ML stack
- Use K8s for application workloads (Backstage, Vapor API)
- Use VMs for infrastructure services
- Single deployment path via Makefile
Impact:
- AI/ML stack deployment: 4-6 hours → 5 minutes
- 396 community-maintained scripts available
- Proper domain separation established
- Clear documentation hierarchy
fe0bdcdc7e