# Стенд лабы 2: PostgreSQL, Valkey (кэш), одноразовые миграции и API. # Правила — .claude/rules/docker.md. Значения — из .env (шаблон # .env.example); литералы только у адреса публикации 127.0.0.1 и у режима # docker. name: mtusi-lab2 # окружение приложения: одно для api и migrate, чтобы они не разъехались x-app-env: &app-env APP__RUN_MODE: docker APP__PORT: ${APP__PORT:-8080} DATABASE__HOST: ${POSTGRES_HOST:-postgres} DATABASE__PORT: ${POSTGRES_PORT:-5432} DATABASE__USER: ${POSTGRES_USER:?POSTGRES_USER is not set, run make env_setup} DATABASE__PASSWORD: ${POSTGRES_PASSWORD:?POSTGRES_PASSWORD is empty, run make env_setup} DATABASE__NAME: ${POSTGRES_DB:?POSTGRES_DB is not set, run make env_setup} CACHE__HOST: ${VALKEY_HOST:-valkey} CACHE__PORT: ${VALKEY_PORT:-6379} CACHE__PASSWORD: ${VALKEY_PASSWORD:?VALKEY_PASSWORD is empty, copy Valkey lines from .env.example} # config.toml только на чтение, длинной записью: без файла запуск падает, # а не создаёт на хосте каталог config.toml/ x-config-toml: &config-toml type: bind source: ./config.toml target: /app/config.toml read_only: true bind: create_host_path: false services: postgres: image: postgres:18.6-trixie@sha256:5a5a84b19854a9ffaa54082c166ff4ec27473a361e496e5ea167f298f2da9722 restart: unless-stopped environment: POSTGRES_USER: ${POSTGRES_USER:?POSTGRES_USER is not set, run make env_setup} POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?POSTGRES_PASSWORD is empty, run make env_setup} POSTGRES_DB: ${POSTGRES_DB:?POSTGRES_DB is not set, run make env_setup} # порт самого сервера; его же берут pg_isready и psql в контейнере PGPORT: ${POSTGRES_PORT:-5432} ports: # только localhost: к нему подключается приложение в console - "127.0.0.1:${POSTGRES_OUT_PORT:-5433}:${POSTGRES_PORT:-5432}" volumes: # с 18.x данные в /var/lib/postgresql/18/docker, volume образа — # весь /var/lib/postgresql (Config.Volumes) - postgres_data:/var/lib/postgresql networks: default: # любое значение POSTGRES_HOST указывает на этот сервис aliases: - ${POSTGRES_HOST:-postgres} healthcheck: # по TCP, а не через сокет: при инициализации образ поднимает # временный сервер только на сокете, и проверка через сокет # сказала бы «готов» раньше времени. $$ — переменная контейнера test: ["CMD-SHELL", "pg_isready -h 127.0.0.1 -U \"$$POSTGRES_USER\" -d \"$$POSTGRES_DB\""] interval: 5s timeout: 3s retries: 10 start_period: 30s start_interval: 1s # кэш карточек чатов: без volume, persistence выключен в valkey.conf — # после рестарта кэш пуст, данные остаются в PostgreSQL valkey: image: valkey/valkey:9.1.2-trixie@sha256:418652cfb58ef879d4978c33553735d7147016032d5aefaa14c828e611eb9dfd restart: unless-stopped # $$ — переменные контейнера: пароль не попадает в command литералом. # Через docker-entrypoint.sh образа: он запускает сервер не от root command: - sh - -c - exec docker-entrypoint.sh valkey-server /usr/local/etc/valkey/valkey.conf --port "$$VALKEY_PORT" --requirepass "$$VALKEY_PASSWORD" environment: VALKEY_PORT: ${VALKEY_PORT:-6379} VALKEY_PASSWORD: ${VALKEY_PASSWORD:?VALKEY_PASSWORD is empty, copy Valkey lines from .env.example} # пароль для valkey-cli в контейнере (healthcheck), без -a в команде VALKEYCLI_AUTH: ${VALKEY_PASSWORD:?VALKEY_PASSWORD is empty, copy Valkey lines from .env.example} ports: # только localhost: к нему подключается приложение в console - "127.0.0.1:${VALKEY_OUT_PORT:-6380}:${VALKEY_PORT:-6379}" volumes: - type: bind source: ./infra/valkey/valkey.conf target: /usr/local/etc/valkey/valkey.conf read_only: true bind: create_host_path: false networks: default: # любое значение VALKEY_HOST указывает на этот сервис aliases: - ${VALKEY_HOST:-valkey} healthcheck: # PONG только после AUTH: проверяет и запуск, и пароль test: ["CMD-SHELL", 'test "$$(valkey-cli -p "$$VALKEY_PORT" ping)" = PONG'] interval: 5s timeout: 3s retries: 10 start_period: 10s start_interval: 1s migrate: # образ собирает сервис api (make run_docker, make test_isolated) image: mtusi-messenger:lab2 pull_policy: never command: ["alembic", "upgrade", "head"] restart: "no" environment: *app-env volumes: - *config-toml depends_on: postgres: condition: service_healthy api: build: . image: mtusi-messenger:lab2 restart: unless-stopped ports: # только localhost: стенд учебный - "127.0.0.1:${APP_OUT_PORT:-8080}:${APP__PORT:-8080}" environment: *app-env volumes: - *config-toml depends_on: postgres: condition: service_healthy # без кэша API работает, но в штатном стенде он есть с первого запроса valkey: condition: service_healthy migrate: condition: service_completed_successfully # healthcheck — из образа; SIGKILL не раньше, чем через 10 с stop_grace_period: 10s volumes: postgres_data: