# Стенд 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 недоступны снаружи и сами не ходят в интернет