mirror of
https://github.com/azaion/satellite-provider.git
synced 2026-06-21 15:31:14 +00:00
Oleksandr Bezdieniezhnykh
865dfdb3b9
AZ-794: rename inventory wire fields tileZoom/tileX/tileY -> z/x/y to match the slippy-map URL convention. Contract bumped to v2.0.0. AZ-795: shared validation infrastructure -- FluentValidation + ValidationEndpointFilter + GlobalValidatorConfig (camelCase paths). GlobalExceptionHandler now converts JsonException (UnmappedMember + JsonRequired) into RFC 7807 ValidationProblemDetails. JSON layer hardened with UnmappedMemberHandling.Disallow + camelCase naming policy. New error-shape.md contract. AZ-796: InventoryRequestValidator covers 9 rules (XOR tiles vs locationHashes, cap 1000, z 0..22, x/y in slippy bounds, hash length/charset). 16 unit tests + 16 integration tests + a manual curl probe script. Adjacent fixes uncovered by the new strict layer: - IdempotentPostTests RoutePoint payload corrected to lat/lon (the DTO has used JsonPropertyName for ages; previously silently ignored under PascalCase fallback). - TileInventoryTests slippy x/y reduced to fit z=18 bounds. - docker-compose.yml host port for Postgres moved 5432 -> 5433 to avoid sibling-project conflict; appsettings.Development + README + AGENTS + architecture + containerization docs aligned. New coderule (suite + repo): API consumer-facing OpenAPI descriptions must not contain task IDs, contract filenames, or version-bump history -- internal change tracking belongs in commits/contract docs/changelogs. Existing offending descriptions in Program.cs cleaned up. Co-authored-by: Cursor <cursoragent@cursor.com>
46 lines
1.8 KiB
Markdown
46 lines
1.8 KiB
Markdown
# Containerization
|
|
|
|
## Docker Image
|
|
|
|
**Base image**: `mcr.microsoft.com/dotnet/aspnet:10.0` (was `:8.0` through cycle 3 — bumped by AZ-500)
|
|
**Build image**: `mcr.microsoft.com/dotnet/sdk:10.0` (was `:8.0` through cycle 3 — bumped by AZ-500)
|
|
**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 | 5433:5432 | Database (host port 5433 chosen to avoid conflicts with sibling-project Postgres instances on dev laptops) |
|
|
| 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
|