Project_Velocity/infrastructure/ops_control_plane/README.md

Desineuron Ops Control Plane

Internal Linux-hosted control surface for:

• AWS machine lifecycle
• S3-backed model ingest with generated manifests and checksums
• model hydration from S3
• runtime and estimated cost tracking
• ingress route management
• session logging and CSV export

Main deployment target:

• Linux box at 192.168.1.4

Primary public route:

• ops.desineuron.in

Canonical S3 bucket:

• desineuron-ops-control-plane-819079556187-us-east-1

Related AWS nodes:

• ingress: i-094df09acafb72494
• current GPU worker: i-0e4eab5fe67cf9abe

Core runtime:

• FastAPI web + API surface
• background worker
• PostgreSQL
• Docker Compose
• systemd wrapper on Linux

Key files:

• docker-compose.yml
• .env.example
• app/ops_control_plane/main.py
• app/ops_control_plane/worker.py
• app/ops_control_plane/cli.py
• manage_desineuron_routes.py
• install_linux_ops_control_plane.sh

Runtime paths on Linux:

• stack root: /opt/desineuron-ops-control-plane
• env file: /opt/desineuron-ops-control-plane/.env
• exports: /opt/desineuron-ops-control-plane/exports
• state: /opt/desineuron-ops-control-plane/state

Access:

• login route: https://ops.desineuron.in/login
• operator logins are provisioned as email-style usernames
• admin password is stored in the protected .env file on Linux and should be retrieved locally rather than copied into repo notes

Validated live behaviors:

• market pricing API returns live on-demand and spot views
• session and cost tracking persist in PostgreSQL and export to CSV
• spot launch failures are recorded cleanly instead of crashing the UI
• on-demand GPU launch was validated with a g6.xlarge lifecycle test
• managed ingress route upsert/delete was validated through the helper on the t4g.micro ingress
• model ingest from Linux model library to S3 was validated with ops-smoke-model, including manifest generation and catalog registration

Operator retrieval commands:

• admin password:
  • sudo sed -n 's/^OPS_ADMIN_PASSWORD=//p' /opt/desineuron-ops-control-plane/.env
• latest CSV export:
  • ls -lah /opt/desineuron-ops-control-plane/exports

Installer safety note:

• install_linux_ops_control_plane.sh intentionally excludes runtime directories (data/, exports/, logs/, state/, .env) from code sync so redeploys do not corrupt Postgres state or overwrite secrets