Skip to main content

09 Operations Runbook

Pre-deployment checklist​

  1. Ensure all required environment variables are set.

  2. Run preflight validation:

    sh defense_center/scripts/preflight-env.sh defense_center/.env

  3. Confirm PostgreSQL, Redis, OpenSearch, and InfluxDB endpoints are reachable.

Startup expectations​

Successful startup should include:

  • Configuration validation success log
  • Dependency health checks passed log
  • Migration success log when auto-migrate is enabled

If startup fails​

Configuration validation failure​

  • Fix missing or placeholder environment values.
  • Re-run preflight script.

Dependency healthcheck failure​

  • Verify service credentials and network routing.
  • Verify dependency service health independently.

Migration failure​

  • Verify database connectivity and migration state.
  • Check migration retry configuration values.

CI pipeline summary​

Current backend CI includes:

  • Sonar scanner stage on main
  • Docker image build and push on develop/main

File reference: ravenxcope-backend/.gitlab-ci.yml