9daf1fd378
- 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
132 lines
2.7 KiB
Markdown
132 lines
2.7 KiB
Markdown
# 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)
|
|
|