185 lines
7.8 KiB
YAML
185 lines
7.8 KiB
YAML
# Стенд lab3: HAProxy (единственная точка входа) -> API x2 -> PostgreSQL (источник истины)
|
||
# + Valkey (общий кэш сессий).
|
||
# Запуск: docker compose up -d --build --wait
|
||
# Секреты: sh scripts/init-secrets.sh (создаёт каталог secrets/, он в .gitignore)
|
||
#
|
||
# Сети: edge (lb <-> api) и backend (api, migrate <-> postgres, valkey; internal = без выхода наружу).
|
||
# Наружу опубликованы только порты балансировщика и только на 127.0.0.1 хоста.
|
||
# У api нет ports и container_name: реплик может быть сколько угодно (deploy.replicas),
|
||
# все они видны балансировщику по DNS-имени сервиса "api".
|
||
name: mtusi-lab3
|
||
|
||
# Сборка образа приложения. APP_VERSION меняет только student-tests/rolling_update.py.
|
||
x-build: &build
|
||
context: .
|
||
args:
|
||
APP_VERSION: ${APP_VERSION:-dev}
|
||
|
||
# Docker-статус healthy/unhealthy для API (для `up --wait` и rolling update).
|
||
# Из балансировки реплику выводит HAProxy по своим, более частым проверкам (infra/haproxy/haproxy.cfg).
|
||
x-api-healthcheck: &api-healthcheck
|
||
test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8080/health/ready', timeout=2)"]
|
||
interval: 5s
|
||
timeout: 3s
|
||
retries: 3
|
||
start_period: 30s
|
||
start_interval: 1s
|
||
|
||
# Общие настройки процессов приложения (реплики API, API с коротким TTL, тесты БД).
|
||
x-app: &app
|
||
image: mtusi-messenger:lab3
|
||
env_file: .env
|
||
secrets: [database_url, cache_url]
|
||
networks: [edge, backend]
|
||
|
||
services:
|
||
# Одноразовый сервис: применяет migrations/*.sql и завершается с кодом 0.
|
||
# Реплики API стартуют только после него и схему не меняют (нет гонки миграций).
|
||
migrate:
|
||
image: mtusi-messenger:lab3
|
||
build: *build
|
||
env_file: .env
|
||
command: ["python", "-m", "messenger.migrate"]
|
||
# Миграциям нужен только адрес PostgreSQL: секрет Valkey сюда не монтируется (минимум прав).
|
||
environment:
|
||
CACHE_URL_FILE: ""
|
||
secrets: [database_url]
|
||
networks: [backend]
|
||
depends_on:
|
||
postgres: {condition: service_healthy}
|
||
healthcheck:
|
||
disable: true
|
||
restart: "no"
|
||
deploy:
|
||
resources:
|
||
limits: {cpus: "0.50", memory: 128M}
|
||
|
||
api:
|
||
<<: *app
|
||
build: *build
|
||
depends_on:
|
||
migrate: {condition: service_completed_successfully}
|
||
postgres: {condition: service_healthy}
|
||
valkey: {condition: service_healthy}
|
||
healthcheck: *api-healthcheck
|
||
restart: unless-stopped
|
||
# SIGTERM -> 3 с readiness 503 (уход из балансировки) -> до 8 с на начатые запросы -> выход.
|
||
# Docker ждёт 15 с и только потом SIGKILL.
|
||
stop_grace_period: 15s
|
||
deploy:
|
||
replicas: ${API_REPLICAS:-2}
|
||
resources:
|
||
# 512 МиБ: Argon2id берёт 19 МиБ на каждую одновременную проверку пароля.
|
||
limits: {cpus: "1.00", memory: 512M}
|
||
|
||
lb:
|
||
image: haproxy:3.2.25-alpine
|
||
ports:
|
||
- "127.0.0.1:8080:8080" # единственная точка входа API
|
||
- "127.0.0.1:8081:8081" # API с коротким TTL (make expiry), тоже через балансировщик
|
||
- "127.0.0.1:8404:8404" # статистика HAProxy: http://127.0.0.1:8404/stats
|
||
volumes:
|
||
- ./infra/haproxy/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro
|
||
networks: [edge]
|
||
depends_on:
|
||
api: {condition: service_started}
|
||
healthcheck:
|
||
test: ["CMD", "wget", "-q", "-T", "2", "-O", "/dev/null", "http://127.0.0.1:8404/lb-health"]
|
||
interval: 5s
|
||
timeout: 3s
|
||
retries: 3
|
||
start_period: 20s
|
||
start_interval: 1s
|
||
restart: unless-stopped
|
||
stop_grace_period: 15s
|
||
deploy:
|
||
resources:
|
||
limits: {cpus: "0.50", memory: 128M}
|
||
|
||
# Второй экземпляр API с SESSION_TTL_SECONDS=2 — только для проверки истечения сессии.
|
||
# Та же база, тот же код; запускается явно (make expiry). Порт наружу не публикуется:
|
||
# доступ через балансировщик, 127.0.0.1:8081.
|
||
api-short-ttl:
|
||
<<: *app
|
||
profiles: [ttl]
|
||
pull_policy: never # образ собирается сервисом api, а не скачивается
|
||
environment:
|
||
SESSION_TTL_SECONDS: "2"
|
||
depends_on:
|
||
postgres: {condition: service_healthy}
|
||
valkey: {condition: service_healthy}
|
||
healthcheck: *api-healthcheck
|
||
restart: unless-stopped
|
||
deploy:
|
||
resources:
|
||
limits: {cpus: "0.50", memory: 256M}
|
||
|
||
# Интеграционные тесты хранилища (откат транзакции, повтор миграций, гонки, идемпотентность).
|
||
# Запуск: docker compose --profile tools run --rm db-test
|
||
db-test:
|
||
<<: *app
|
||
profiles: [tools]
|
||
pull_policy: never
|
||
networks: [backend]
|
||
volumes: ["./student-tests:/srv/student-tests:ro"]
|
||
command: ["python", "-m", "unittest", "discover", "-s", "student-tests/db", "-v"]
|
||
depends_on:
|
||
postgres: {condition: service_healthy}
|
||
deploy:
|
||
resources:
|
||
limits: {cpus: "1.00", memory: 512M}
|
||
|
||
postgres:
|
||
image: postgres:17.10-bookworm
|
||
environment:
|
||
POSTGRES_USER: messenger
|
||
POSTGRES_DB: messenger
|
||
POSTGRES_PASSWORD_FILE: /run/secrets/postgres_password # пароль из файла, не из переменной
|
||
# Значения по умолчанию, выписанные явно: COMMIT возвращается только после записи WAL на диск.
|
||
command: ["postgres", "-c", "fsync=on", "-c", "synchronous_commit=on", "-c", "full_page_writes=on"]
|
||
secrets: [postgres_password]
|
||
volumes: ["pgdata:/var/lib/postgresql/data"] # именованный volume: данные переживают пересоздание контейнера
|
||
healthcheck:
|
||
test: ["CMD-SHELL", "pg_isready -h 127.0.0.1 -U messenger -d messenger"]
|
||
interval: 5s
|
||
timeout: 3s
|
||
retries: 12
|
||
start_period: 10s
|
||
restart: unless-stopped
|
||
stop_grace_period: 30s # PostgreSQL успевает корректно завершиться (checkpoint)
|
||
networks: [backend]
|
||
deploy:
|
||
resources:
|
||
limits: {cpus: "1.00", memory: 512M}
|
||
|
||
valkey:
|
||
image: valkey/valkey:8.1.9
|
||
command: ["valkey-server", "/usr/local/etc/valkey/valkey.conf"]
|
||
volumes: ["./infra/valkey/valkey.conf:/usr/local/etc/valkey/valkey.conf:ro"]
|
||
secrets: [valkey_acl] # пользователи и пароль Valkey (ACL), генерируются init-secrets.sh
|
||
healthcheck:
|
||
# Пользователь health без пароля может только ping/info/dbsize — данных он не видит.
|
||
test: ["CMD-SHELL", "valkey-cli --user health --pass none --no-auth-warning ping | grep -q PONG"]
|
||
interval: 5s
|
||
timeout: 3s
|
||
retries: 12
|
||
restart: unless-stopped
|
||
networks: [backend]
|
||
deploy:
|
||
resources:
|
||
limits: {cpus: "0.50", memory: 128M}
|
||
|
||
volumes:
|
||
pgdata: {}
|
||
|
||
secrets:
|
||
postgres_password: {file: ./secrets/postgres_password}
|
||
database_url: {file: ./secrets/database_url}
|
||
cache_url: {file: ./secrets/cache_url}
|
||
valkey_acl: {file: ./secrets/valkey_users.acl}
|
||
|
||
networks:
|
||
edge: {}
|
||
backend:
|
||
internal: true # postgres и valkey недоступны снаружи и сами не ходят в интернет
|