Platform Operations¶

This page provides an operational overview of the NovaTrek Continuous Architecture Platform — CI/CD pipelines, deployment targets, cost controls, and integration points.

GitHub Actions Pipelines¶

All workflows live in .github/workflows/ on the main branch.

Documentation¶

Service CI/CD¶

Infrastructure¶

Confluence Integration¶

Cost Controls¶

Ticketing Integration¶

Deployment Targets¶

Environments¶

Static Web Apps¶

Azure Resources (via platform.bicep)¶

The platform Bicep template deploys:

• Azure Container Apps Environment — hosts all 19 microservices
• PostgreSQL Flexible Server — per-service schemas via Flyway
• Azure Container Registry — Docker images from CI
• Azure Service Bus — event-driven integration between services
• Redis Cache — required by svc-scheduling-orchestrator
• Key Vault — secrets management
• Managed Identity — workload identity for OIDC auth
• Budget Alerts — configurable monthly budget (default $50/month)

Deployment Flows¶

Service Deployment (push to main)¶

Code push (services/svc-check-in/**)
  → Service CI: build, test, OWASP scan, Docker push, Trivy scan
  → DB Migrate (dev): Flyway against dev PostgreSQL
  → Service CD (dev): Container Apps update + health check
  → DB Migrate (prod): Flyway against prod PostgreSQL
  → Service CD (prod): Container Apps update + health check

Documentation Deployment (push to main)¶

Code push (portal/**)
  → Build: MkDocs + PlantUML generators + portal scripts
  → Deploy: Azure Static Web Apps (production)
  → Confluence: prepare staging → publish pages → lock pages

PR Preview Flow¶

PR opened (services/** or infra/**)
  → Ephemeral: create rg-novatrek-pr-{N}, deploy platform.bicep
  → Post PR comment with preview URLs
  → Cost: ~$0.50-2.00 per PR lifetime

PR closed
  → Ephemeral: delete rg-novatrek-pr-{N}

Cost Control Cycle¶

8 AM EST Mon-Fri  → Start PostgreSQL, scale services 0-2 replicas
8 PM EST Mon-Fri  → Stop PostgreSQL, scale all services to 0 replicas
Weekend            → Dev environment fully stopped

Secrets and Variables¶

GitHub Actions Secrets¶

GitHub Actions Variables¶

Key Links¶