Services & Infrastructure¶

11 containerized services orchestrated with Docker Compose

Running Services¶

FloodWatch runs 11 containers in production:

Container	Image	Ports	Purpose
`eafw-pgdb`	`postgis/postgis:16-3.4`	9060:5432	PostgreSQL + PostGIS database
`eafw-pgbouncer`	`edoburu/pgbouncer:v1.23.1-p3`	9061:6432	Connection pooling
`eafw-memcached`	`memcached:1.6-alpine`	9062:11211	Session and query caching
`eafw-cms`	`ghcr.io/icpac-igad/eafw-cms`	9063:8000	GeoManager CMS (Django + Wagtail)
`eafw-mapviewer`	`ghcr.io/icpac-igad/eafw-mapviewer`	9064:3000	Map Viewer (Next.js 15)
`eafw-mapserver`	`ghcr.io/icpac-igad/eafw-mapserver`	9065:80	WMS raster tile rendering
`eafw-mapcache`	`ghcr.io/icpac-igad/eafw-mapcache`	9066:80	Tile caching layer
`eafw-tileserv`	`pramsey/pg_tileserv:latest`	9067:7800	Vector tiles from PostGIS
`eafw-nginx`	`nginx:1.27-alpine`	9068:80	Reverse proxy / gateway
`eafw-api`	`ghcr.io/icpac-igad/eafw-api`	9069:9060	FastAPI REST service
`eafw-jobs`	`ghcr.io/icpac-igad/eafw-jobs`	—	Scheduled data ingestion

Naming Convention

Docker Compose service names use underscores (eafw_mapviewer), container names use dashes (eafw-mapviewer).

Service Topology¶

graph TB
    subgraph Gateway
        NGINX[Nginx :9068]
    end

    subgraph Application
        VIEWER[Map Viewer :9064]
        API[FastAPI :9069]
        CMS[GeoManager CMS :9063]
    end

    subgraph Map Rendering
        MAPCACHE[MapCache :9066]
        MAPSERVER[MapServer :9065]
        TILESERV[pg_tileserv :9067]
    end

    subgraph Data
        PGBOUNCER[PgBouncer :9061]
        DB[(PostGIS :9060)]
        MEMCACHED[Memcached :9062]
    end

    subgraph Background
        JOBS[Ingestion Jobs]
    end

    NGINX --> VIEWER
    NGINX --> API
    NGINX --> CMS
    NGINX --> MAPCACHE
    NGINX --> TILESERV

    MAPSERVER --> MAPCACHE
    CMS --> PGBOUNCER
    API --> PGBOUNCER
    TILESERV --> PGBOUNCER
    MAPSERVER --> DB
    PGBOUNCER --> DB
    JOBS --> DB
    CMS --> MEMCACHED

Routing¶

All traffic enters through Nginx on port 9068:

Route	Service	Description
`/`	Map Viewer	Interactive flood map
`/api/`	FastAPI	REST API endpoints
`/api/docs`	FastAPI	Swagger UI
`/cms-admin/`	CMS	Wagtail admin panel
`/mapserver/`	MapServer	OGC WMS/WCS services
`/mapcache/`	MapCache	Cached tiles
`/pg/tileserv/`	pg_tileserv	Vector tiles

Database¶

Schemas¶

Schema	Purpose	Key Tables
`gha`	Spatial data	`multimodal_control_points` (3,199 points), `multimodal_forecast` (~5.6M rows), `admin0/1/2`
`cms`	Application data	Wagtail pages, GeoManager layers, dataset configs

Alert Thresholds¶

Level	Threshold	Color
Normal	< 300 m³/s	Green
Warning	>= 300 m³/s	Orange
Alarm	>= 500 m³/s	Red
Emergency	>= 750 m³/s	Purple

CI/CD Pipeline¶

graph LR
    DEV[Push to eafw] --> DETECT[Detect Changes]
    DETECT --> BUILD[Build Images]
    BUILD --> GHCR[Push to GHCR]
    GHCR --> BACKUP[Backup DB]
    BACKUP --> DEPLOY[Pull & Restart]
    DEPLOY --> HEALTH[Health Check]

Change Detection — Only rebuilds images for modified components
Build & Push — Docker images to GitHub Container Registry
Backup — Checksum-verified database backup before deploy
Deploy — Pull images, inject secrets, restart containers
Health Check — Verify all 11 services are running

See Deployment Guide for details.