Files
Sankofa/infrastructure/QUICK_START.md
defiQUG 9daf1fd378 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
2025-12-12 18:01:35 -08:00

2.7 KiB

Infrastructure Management Quick Start

Quick reference guide for managing infrastructure in Sankofa Phoenix.

Quick Commands

Proxmox Management

# 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

# 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

# Discover all infrastructure for a site
cd infrastructure/inventory
export SITE=us-east-1
./discovery/discover-all.sh

Using the Omada API Client

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

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

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