Draft

poc-lab — POC Self-Service Environment

Internalactive

Self-service home for developer proof-of-concepts. Drop an app in a folder, push to develop, and it deploys to https://dev1.novamera.io/<app> — no platform lead, no Terragrunt ticket, no ops toil. Currently piloted on dev1.

flowchart LR
    DEV[Developer pushes
to develop] --> GHA[.github/workflows
deploy.yml]
    GHA -->|frontend| S3[S3 · CloudFront
dev1.novamera.io/app-name]
    GHA -->|backend container| ECS[dev1-cluster ECS
dev1.novamera.io/app-name/api]
    GHA -->|comments URL| PR[PR / commit]
    style GHA fill:#EDEDFF,stroke:#3B54F7

Adding a new POC (one-time infra setup):

  1. Copy pocs/hello/ → pocs/<app>/, edit poc.yaml (+ Dockerfile for backend, frontend/ for SPA).
  2. In novamera.infra-iac: run scripts/new-poc.sh <app> both --port <PORT> — opens a PR that auto-applies infra on merge.
  3. Push to develop here → deploy → URL appears in PR comment.
  • Disposable tier: prototypes only — no sensitive data, no long-lived state. Graduate real services to their own stacks in novamera.infra-iac.
  • OIDC trust: repo name must contain poc for the backend OIDC trust glob (github-actions-backend) — hence the repo name propel.poc-lab.
  • Infra: backends on the shared dev1-cluster (ECS Fargate, desired_count=0 until first push); frontends on S3/CloudFront.