mirror of
https://github.com/azaion/satellite-provider.git
synced 2026-06-21 20:41:15 +00:00
b0fffa6d42
Phase A baseline outputs from /autodev (Steps 1-5): - Problem & solution docs (_docs/00_problem, _docs/01_solution) - Codebase documentation (_docs/02_document) incl. architecture, module-layout, glossary, system-flows, baseline compliance scan - Test specs (blackbox, performance, resilience, security, resource, traceability matrix) - Test task decomposition (_docs/02_tasks/todo): AZ-285..AZ-290 - Testability refactor (_docs/04_refactoring/01-testability-refactoring): - TC-01 Move DownloadedTileInfoV2 + new ExistingTileInfo to Common.DTO - TC-02 Replace dead ISatelliteDownloader API with real signatures - TC-03 GoogleMapsDownloaderV2 implements ISatelliteDownloader - TC-04 TileService depends on ISatelliteDownloader (mockable) - TC-05 DI + endpoints use ISatelliteDownloader - Test runner scripts (scripts/run-tests.sh, run-performance-tests.sh) - Autodev state pointer (_docs/_autodev_state.md) Prepares the codebase for AZ-285..AZ-290 unit/integration test work. Co-authored-by: Cursor <cursoragent@cursor.com>
46 lines
1.6 KiB
Markdown
46 lines
1.6 KiB
Markdown
# Containerization
|
|
|
|
## Docker Image
|
|
|
|
**Base image**: `mcr.microsoft.com/dotnet/aspnet:8.0`
|
|
**Build image**: `mcr.microsoft.com/dotnet/sdk:8.0`
|
|
**Build strategy**: Multi-stage (restore → build → publish → runtime)
|
|
**Exposed ports**: 8080 (HTTP), 8081 (management/metrics)
|
|
|
|
## Container Composition (docker-compose.yml)
|
|
|
|
| Service | Image | Ports (host:container) | Purpose |
|
|
|---------|-------|------------------------|---------|
|
|
| postgres | postgres:16 | 5432:5432 | Database |
|
|
| api | Custom (Dockerfile) | 18980:8080, 18981:8081 | Application |
|
|
|
|
## Volumes
|
|
|
|
| Mount | Container Path | Purpose |
|
|
|-------|---------------|---------|
|
|
| ./tiles | /app/tiles | Tile image storage |
|
|
| ./ready | /app/ready | Output artifacts (CSV, summary, stitched, ZIP) |
|
|
| ./logs | /app/logs | Serilog file output |
|
|
| postgres_data (named) | /var/lib/postgresql/data | Database persistence |
|
|
|
|
## Health Checks
|
|
|
|
- **PostgreSQL**: `pg_isready -U postgres` (interval 5s, timeout 5s, retries 5)
|
|
- **API**: depends on postgres health (startup ordering)
|
|
|
|
## Environment Variables
|
|
|
|
| Variable | Source | Purpose |
|
|
|----------|--------|---------|
|
|
| ASPNETCORE_ENVIRONMENT | docker-compose | Environment selection |
|
|
| ASPNETCORE_URLS | docker-compose | Listen address |
|
|
| ConnectionStrings__DefaultConnection | docker-compose | DB connection string |
|
|
| MapConfig__ApiKey | Host env `GOOGLE_MAPS_API_KEY` | Google Maps API key |
|
|
| AZAION_REVISION | Build arg (CI_COMMIT_SHA) | Git revision tracking |
|
|
|
|
## Build Labels (OCI)
|
|
|
|
- `org.opencontainers.image.revision` — Git commit SHA
|
|
- `org.opencontainers.image.created` — Build timestamp
|
|
- `org.opencontainers.image.source` — Repository URL
|