Files
gps-denied-onboard/.cursor/skills/deploy/templates/environment_strategy.md
T
Oleksandr Bezdieniezhnykh 1f634c2604
ci/woodpecker/push/02-build-push Pipeline failed
Update demo replay validation and testing documentation
- Modified the autodev state to reflect the current testing phase and details of the new `jetson-e2e` tests.
- Enhanced the "How to Test" documentation to provide clearer instructions on the demo replay validation process, including video and tlog alignment steps.
- Updated architectural documentation to include the new demo replay operator flow and its dependencies.
- Documented the removal of deprecated auto-sync features and clarified the operator-facing UI for replay validation.
- Added new entries in the dependencies table for upcoming tasks related to the demo replay flow.

These changes improve clarity and usability for operators and developers working with the demo replay system.
2026-06-20 11:24:43 +03:00

2.0 KiB

Environment Strategy Template

Save as _docs/04_deploy/environment_strategy.md.


# [System Name] — Environment Strategy

## Environments

| Environment | Purpose | Infrastructure | Data Source |
|-------------|---------|---------------|-------------|
| Development | Local developer workflow | docker-compose | Seed data, mocked externals |
| Staging | Pre-production validation | [mirrors production] | Anonymized production-like data |
| Production | Live system | [full infrastructure] | Real data |

## Environment Variables

### Required Variables

| Variable | Purpose | Dev Default | Staging/Prod Source |
|----------|---------|-------------|-------------------|
| `DATABASE_URL` | Postgres connection | `postgres://dev:dev@db:5432/app` | Secret manager |
| [add all required variables] | | | |

### `.env.example`

```env
# Copy to .env and fill in values
DATABASE_URL=postgres://user:pass@host:5432/dbname
# [all required variables with placeholder values]

Variable Validation

All services validate required environment variables at startup and fail fast with a clear error message if any are missing.

Secrets Management

Environment Method Tool
Development .env file (git-ignored) dotenv
Staging Secret manager [AWS Secrets Manager / Azure Key Vault / Vault]
Production Secret manager [AWS Secrets Manager / Azure Key Vault / Vault]

Rotation policy: [frequency and procedure]

Database Management

Environment Type Migrations Data
Development Docker Postgres, named volume Applied on container start Seed data via init script
Staging Managed Postgres Applied via CI/CD pipeline Anonymized production snapshot
Production Managed Postgres Applied via CI/CD with approval Live data

Migration rules:

  • All migrations must be backward-compatible (support old and new code simultaneously)
  • Reversible migrations required (DOWN/rollback script)
  • Production migrations require review before apply