forked from mtusi2026/mtusi2026lab3
- X-Instance-Id в каждом ответе; обязательный Idempotency-Key, таблица idempotency_keys (миграция 0002, одна транзакция, конкурентные повторы через уникальный индекс) - graceful shutdown: SIGTERM -> ready=503 -> drain 3 с -> закрытие порта - compose: lb (HAProxy) + api x2 без портов + разовый migrate + postgres, лимиты CPU/RAM - хуки stop-one/restart/restore-replicas, scripts/experiments.py (failover, idempotency, rolling) - свои тесты: 44 (13 новых); evidence: smoke, pytest, persistence, failover, эксперименты
131 lines
4.8 KiB
YAML
131 lines
4.8 KiB
YAML
# Запуск: docker compose up -d --build --wait (или scripts/init-secrets.* перед первым запуском)
|
||
# Остановка: docker compose down — данные остаются в volume
|
||
# Удаление данных намеренно: docker compose down -v
|
||
#
|
||
# Клиент -> lb (HAProxy, единственный опубликованный порт) -> api x N (без портов на хосте) -> postgres
|
||
# Порядок старта: postgres (healthy) -> migrate (один раз, exit 0) -> api (healthy) -> lb (healthy).
|
||
name: mtusi-lab3
|
||
|
||
x-app-build: &app-build
|
||
context: .
|
||
args:
|
||
APP_VERSION: ${APP_VERSION:-dev}
|
||
|
||
services:
|
||
postgres:
|
||
image: postgres:17.10-alpine@sha256:979c4379dd698aba0b890599a6104e082035f98ef31d9b9291ec22f2b13059ca
|
||
environment:
|
||
POSTGRES_DB: messenger
|
||
POSTGRES_USER: messenger
|
||
POSTGRES_PASSWORD_FILE: /run/secrets/postgres_password
|
||
secrets:
|
||
- postgres_password
|
||
volumes:
|
||
- postgres_data:/var/lib/postgresql/data
|
||
# Только loopback, для своих pytest-тестов из venv. API-реплики ходят в БД по внутренней сети.
|
||
ports:
|
||
- "127.0.0.1:${POSTGRES_HOST_PORT:-5432}:5432"
|
||
healthcheck:
|
||
test: ["CMD-SHELL", "pg_isready -U messenger -d messenger"]
|
||
interval: 5s
|
||
timeout: 3s
|
||
retries: 10
|
||
start_period: 10s
|
||
deploy:
|
||
resources:
|
||
limits:
|
||
cpus: "1.0"
|
||
memory: 512M
|
||
restart: unless-stopped
|
||
|
||
# Разовая задача: ОДИН контейнер применяет миграции и завершается с кодом 0.
|
||
# Реплики API миграции не запускают, поэтому гонки при старте нет (плюс advisory lock в migrations/env.py).
|
||
migrate:
|
||
build: *app-build
|
||
image: mtusi-messenger:lab3
|
||
command: ["python", "-m", "alembic", "upgrade", "head"]
|
||
# HEALTHCHECK образа проверяет HTTP-сервер API, а здесь сервера нет: иначе статус был бы unhealthy.
|
||
healthcheck:
|
||
disable: true
|
||
environment: &app-env
|
||
APP_CONFIG__DB__HOST: postgres
|
||
APP_CONFIG__DB__PORT: "5432"
|
||
APP_CONFIG__DB__NAME: messenger
|
||
APP_CONFIG__DB__USER: messenger
|
||
APP_CONFIG__DB__PASSWORD_FILE: /run/secrets/postgres_password
|
||
APP_CONFIG__JWT__SECRET_FILE: /run/secrets/jwt_secret
|
||
APP_CONFIG__JWT__SESSION_TTL_SECONDS: ${APP_CONFIG__JWT__SESSION_TTL_SECONDS:-3600}
|
||
APP_CONFIG__LOGGING__LEVEL: ${APP_CONFIG__LOGGING__LEVEL:-INFO}
|
||
secrets:
|
||
- postgres_password
|
||
depends_on:
|
||
postgres:
|
||
condition: service_healthy
|
||
deploy:
|
||
resources:
|
||
limits:
|
||
cpus: "0.5"
|
||
memory: 256M
|
||
restart: "no"
|
||
|
||
# Масштабируется: API_REPLICAS (по умолчанию 2). Нет container_name и нет published ports.
|
||
# Локального состояния нет: пользователи, чаты, сообщения, сессии и ключи идемпотентности лежат в PostgreSQL.
|
||
api:
|
||
build: *app-build
|
||
image: mtusi-messenger:lab3
|
||
# Без env_file: в .env адреса для запуска из venv, а не из контейнера.
|
||
environment: *app-env
|
||
secrets:
|
||
- postgres_password
|
||
- jwt_secret
|
||
expose:
|
||
- "8080"
|
||
depends_on:
|
||
postgres:
|
||
condition: service_healthy
|
||
migrate:
|
||
condition: service_completed_successfully
|
||
deploy:
|
||
replicas: ${API_REPLICAS:-2}
|
||
resources:
|
||
limits:
|
||
# Argon2id (64 MiB на каждый одновременный хеш) — самое тяжёлое место: на 0.5 CPU вход занимал 1.2–1.7 с.
|
||
cpus: "1.0"
|
||
memory: 512M
|
||
pids: 200
|
||
# SIGTERM: drain_seconds (3) + graceful_timeout (5) = 8 с, запас до SIGKILL.
|
||
stop_grace_period: 15s
|
||
restart: unless-stopped
|
||
|
||
lb:
|
||
image: haproxy:3.0.29-alpine@sha256:56b887da77428b7a6621e59e480cdbd330cc805c22d3cedb66ceea76ffdea2c6
|
||
volumes:
|
||
- ./infra/haproxy/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro
|
||
ports:
|
||
- "127.0.0.1:8080:8080"
|
||
depends_on:
|
||
api:
|
||
condition: service_healthy
|
||
healthcheck:
|
||
# Через собственный порт LB: 200 только если есть хотя бы одна живая реплика.
|
||
test: ["CMD-SHELL", "wget -q -O /dev/null http://127.0.0.1:8080/health/live"]
|
||
interval: 5s
|
||
timeout: 3s
|
||
retries: 5
|
||
start_period: 5s
|
||
deploy:
|
||
resources:
|
||
limits:
|
||
cpus: "0.5"
|
||
memory: 128M
|
||
restart: unless-stopped
|
||
|
||
volumes:
|
||
postgres_data:
|
||
|
||
secrets:
|
||
postgres_password:
|
||
file: ./secrets/postgres_password
|
||
jwt_secret:
|
||
file: ./secrets/jwt_secret
|