# Orchestrator Infra Bootstrap (DEVOPS-ORCH-32-001)

## Components
- PostgreSQL 18.1 (state/config/job ledger)
- Valkey 9.0.1 (queue/bus/cache)

Compose file: `devops/compose/docker-compose.stella-ops.yml`

## Quick start (offline-friendly)
```bash
# bring up infra
docker compose -f devops/compose/docker-compose.stella-ops.yml up -d stellaops-postgres stellaops-valkey

# smoke check and emit connection strings
devops/tools/orchestrator-scripts/smoke.sh
cat out/orchestrator-smoke/readiness.txt

# synthetic probe (postgres/valkey health)
devops/tools/orchestrator-scripts/probe.sh
cat out/orchestrator-probe/status.txt
```

Connection strings
- Postgres: `postgres://stellaops:stellaops@localhost:5432/stellaops`
- Valkey: `valkey://localhost:6379`

## Observability
- Alerts: `devops/observability/alerting/`
- Grafana dashboard: `devops/observability/dashboards/`
  - Metrics expected: `job_queue_depth`, `job_failures_total`, `lease_extensions_total`, `job_latency_seconds_bucket`.
- Synthetic probes: `devops/tools/orchestrator-scripts/probe.sh` (writes `out/orchestrator-probe/status.txt`).

## CI hook (suggested)
Add a workflow step (or local cron) to run `devops/tools/orchestrator-scripts/smoke.sh` with `SKIP_UP=1` against existing infra and publish the `readiness.txt` artifact for traceability.

## Notes
- Uses fixed ports for determinism; adjust via COMPOSE overrides if needed.
- Data volumes: `stellaops-postgres`, `stellaops-valkey` (docker volumes).
- No external downloads beyond base images; pin images to specific tags above.