# 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)