Apply Composer changes: comprehensive API updates, migrations, middleware, and infrastructure improvements
- Add comprehensive database migrations (001-024) for schema evolution - Enhance API schema with expanded type definitions and resolvers - Add new middleware: audit logging, rate limiting, MFA enforcement, security, tenant auth - Implement new services: AI optimization, billing, blockchain, compliance, marketplace - Add adapter layer for cloud integrations (Cloudflare, Kubernetes, Proxmox, storage) - Update Crossplane provider with enhanced VM management capabilities - Add comprehensive test suite for API endpoints and services - Update frontend components with improved GraphQL subscriptions and real-time updates - Enhance security configurations and headers (CSP, CORS, etc.) - Update documentation and configuration files - Add new CI/CD workflows and validation scripts - Implement design system improvements and UI enhancements
This commit is contained in:
131
infrastructure/QUICK_START.md
Normal file
131
infrastructure/QUICK_START.md
Normal file
@@ -0,0 +1,131 @@
|
||||
# Infrastructure Management Quick Start
|
||||
|
||||
Quick reference guide for managing infrastructure in Sankofa Phoenix.
|
||||
|
||||
## Quick Commands
|
||||
|
||||
### Proxmox Management
|
||||
|
||||
```bash
|
||||
# Check cluster health
|
||||
cd infrastructure/proxmox
|
||||
./scripts/cluster-health.sh --site us-east-1
|
||||
|
||||
# Setup Proxmox site
|
||||
cd ../../scripts
|
||||
./setup-proxmox-agents.sh --site us-east-1 --node pve1
|
||||
```
|
||||
|
||||
### Omada Management
|
||||
|
||||
```bash
|
||||
# Setup Omada Controller
|
||||
cd infrastructure/omada
|
||||
export OMADA_CONTROLLER=omada.sankofa.nexus
|
||||
export OMADA_PASSWORD=your-password
|
||||
./scripts/setup-controller.sh
|
||||
|
||||
# Discover access points
|
||||
./scripts/discover-aps.sh --site us-east-1
|
||||
```
|
||||
|
||||
### Infrastructure Discovery
|
||||
|
||||
```bash
|
||||
# Discover all infrastructure for a site
|
||||
cd infrastructure/inventory
|
||||
export SITE=us-east-1
|
||||
./discovery/discover-all.sh
|
||||
```
|
||||
|
||||
### Using the Omada API Client
|
||||
|
||||
```python
|
||||
from infrastructure.omada.api.omada_client import OmadaController
|
||||
|
||||
# Initialize and authenticate
|
||||
controller = OmadaController(
|
||||
host="omada.sankofa.nexus",
|
||||
username="admin",
|
||||
password="secure-password"
|
||||
)
|
||||
controller.login()
|
||||
|
||||
# Get sites and access points
|
||||
sites = controller.get_sites()
|
||||
aps = controller.get_access_points(sites[0]["id"])
|
||||
|
||||
controller.logout()
|
||||
```
|
||||
|
||||
## Configuration
|
||||
|
||||
### Environment Variables
|
||||
|
||||
```bash
|
||||
# Proxmox
|
||||
export PROXMOX_API_URL=https://pve1.sankofa.nexus:8006
|
||||
export PROXMOX_API_TOKEN=root@pam!token-name=abc123
|
||||
|
||||
# Omada
|
||||
export OMADA_CONTROLLER=omada.sankofa.nexus
|
||||
export OMADA_ADMIN=admin
|
||||
export OMADA_PASSWORD=secure-password
|
||||
|
||||
# Site
|
||||
export SITE=us-east-1
|
||||
```
|
||||
|
||||
## Integration Points
|
||||
|
||||
### Crossplane Provider
|
||||
|
||||
The Proxmox Crossplane provider is located at:
|
||||
- `crossplane-provider-proxmox/`
|
||||
|
||||
Use Kubernetes manifests to manage Proxmox resources:
|
||||
|
||||
```yaml
|
||||
apiVersion: proxmox.sankofa.nexus/v1alpha1
|
||||
kind: ProxmoxVM
|
||||
metadata:
|
||||
name: web-server-01
|
||||
spec:
|
||||
forProvider:
|
||||
node: pve1
|
||||
name: web-server-01
|
||||
cpu: 4
|
||||
memory: 8Gi
|
||||
disk: 100Gi
|
||||
site: us-east-1
|
||||
```
|
||||
|
||||
### GitOps
|
||||
|
||||
Infrastructure definitions are in:
|
||||
- `gitops/infrastructure/`
|
||||
|
||||
### Portal Integration
|
||||
|
||||
The Portal UI provides infrastructure management at:
|
||||
- `/infrastructure` - Infrastructure overview
|
||||
- `/infrastructure/proxmox` - Proxmox management
|
||||
- `/infrastructure/omada` - Omada management
|
||||
|
||||
## Next Steps
|
||||
|
||||
1. **Configure Sites**: Set up site-specific configurations
|
||||
2. **Deploy Monitoring**: Install Prometheus exporters
|
||||
3. **Setup Inventory**: Initialize inventory database
|
||||
4. **Configure Alerts**: Set up alerting rules
|
||||
5. **Integrate with Portal**: Connect infrastructure management to Portal UI
|
||||
|
||||
## Related Documentation
|
||||
|
||||
- [Infrastructure Management README](./README.md)
|
||||
- [Proxmox Management](./proxmox/README.md)
|
||||
- [Omada Management](./omada/README.md)
|
||||
- [Network Management](./network/README.md)
|
||||
- [Monitoring](./monitoring/README.md)
|
||||
- [Inventory](./inventory/README.md)
|
||||
|
||||
Reference in New Issue
Block a user