lily_website

🐳 Docker Architecture

docs/en_EN/infrastructure/devops/ · README → Docker

---

Containers

The project uses modular Docker containers generated by the installer based on your module selection.

Possible Services

Service	Image	Port	Condition
backend	Custom (FastAPI)	8000	If FastAPI selected
bot	Custom (aiogram)	—	If Bot selected
worker	Custom (ARQ)	—	If Bot selected
redis	redis:7-alpine	6379	If Bot selected
postgres	postgres:16-alpine	5432	If FastAPI selected
nginx	nginx:alpine / Custom	80, 443	If any backend

Example: FastAPI + Bot (full stack)

┌─────────────────────────────────────────────┐
│                    nginx                     │
│              :80 / :443 (SSL)                │
└───────────────┬─────────────────────────────┘
                │ proxy_pass
┌───────────────▼───────────┐  ┌─────────────┐
│      backend (FastAPI)    │  │  bot (aiogram│
│          :8000            │  │    polling)  │
└───────────┬───────────────┘  └──────┬──────┘
            │                          │
┌───────────▼───┐              ┌──────▼──────┐
│   postgres    │              │    redis    │
│    :5432      │              │   :6379     │
└───────────────┘              └──────┬──────┘
                                      │
                               ┌──────▼──────┐
                               │   worker    │
                               │   (ARQ)     │
                               └─────────────┘

Files

deploy/
├── fastapi/
│   └── Dockerfile         # Multi-stage: builder → runtime
├── bot/
│   └── Dockerfile         # Multi-stage: builder → runtime
├── worker/
│   └── Dockerfile         # Same as bot, different CMD
├── nginx/
│   ├── Dockerfile         # Production nginx with configs
│   ├── nginx-main.conf    # Main config (upstream, gzip, rate limiting)
│   ├── site.conf          # Production (SSL, certbot, security headers)
│   └── site-local.conf    # Development (port 80, no SSL)
├── docker-compose.yml     # Development
└── docker-compose.prod.yml # Production (images from GHCR)

Usage

Development

cd deploy
docker compose up -d
docker compose logs -f

Production

Production deployment is automated via CD Release workflow. Images are built and pushed to GitHub Container Registry (GHCR).

Environment Variables

All services read from .env file. See github-secrets.md for variable reference.