g2s-aggregator/infra/README.md

Local Infrastructure Stack

Services

• app: FastAPI service (uvicorn app.main:app) built from root Dockerfile
• redis: price cache backend
• signoz: observability backend (UI + OTLP receiver)

Environment wiring

app service

• G2S_CONFIG_FILE=/app/config.yaml
• G2S_REPOSITORY__REDIS_DSN=redis://redis:6379/0
• G2S_OBSERVABILITY__OTLP_ENDPOINT=http://signoz:4317
• PYTHONUNBUFFERED=1

signoz service

• G2S_ALERTS__TELEGRAM_BOT_TOKEN (optional for Telegram alerts)
• G2S_ALERTS__TELEGRAM_CHAT_ID (optional for Telegram alerts)

Startup instructions

1. Validate compose syntax:
   • docker compose config
2. Start dependencies:
   • docker compose up -d redis signoz
3. Verify running containers:
   • docker compose ps
4. Start application:
   • docker compose up -d app
5. Stop local stack:
   • docker compose down

Smoke command sequence

docker compose config
docker compose up -d redis signoz
docker compose ps