Docker Compose с нуля: оркестрация Node.js приложения и PostgreSQL

+-------------------------------------------------------------------------+
|                  АРХИТЕКТУРА СТЕКА DOCKER COMPOSE                       |
+-------------------------------------------------------------------------+
| ХОСТ (Компьютер разработчика / Сервер):                                 |
|   Браузер / Curl обращается к порту хоста: http://localhost:3000        |
|                               │                                         |
| ──┼───────────────────────────┼──────────────────────────────────────── |
|   │                           ▼ (-p 3000:3000)                          |
|   │ ИЗОЛИРОВАННАЯ СЕТЬ DOCKER BRIDGE (app-network):                    |
|   │                                                                     |
|   │  ┌─────────────────────────┐         ┌───────────────────────────┐  |
|   │  │ СЕРВИС 1: app (Node.js) │         │ СЕРВИС 2: db (PostgreSQL) │  |
|   │  │  Контейнер: app-1       │         │  Контейнер: db-1          │  |
|   │  │  IP: 172.20.0.3         │         │  IP: 172.20.0.2           │  |
|   │  │                         │         │                           │  |
|   │  │  Подключение к БД:      │  DNS    │  Порт 5432 открыт         │  |
|   │  │  host: "db"  ───────────┼────────►│  ТОЛЬКО ВНУТРИ СЕТИ       │  |
|   │  │  (НЕ localhost!)        │         │  (Не виден снаружи!)      │  |
|   │  └─────────────────────────┘         └─────────────┬─────────────┘  |
|   │                                                    │                |
| ──┼────────────────────────────────────────────────────┼─────────────── |
|   │ ХОСТОВОЕ ХРАНИЛИЩЕ ДАННЫХ (Docker Volume):         ▼                |
|   │   postgres_data ◄──────────────────────────────────┘                |
|   │   (/var/lib/docker/volumes/my_stack_postgres_data/_data)            |
|   │   (Данные переживают перезапуск и пересоздание контейнера!)         |
+-------------------------------------------------------------------------+

services:
  # 1. Сервис реляционной базы данных
  db:
    image: postgres:17-alpine
    container_name: local-postgres
    restart: unless-stopped
    environment:
      POSTGRES_DB: ${POSTGRES_DB:-wpskills_db}
      POSTGRES_USER: ${POSTGRES_USER:-postgres}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-postgres_dev_pass}
    volumes:
      # Постоянный том для сохранения данных БД
      - postgres_data:/var/lib/postgresql/data
    networks:
      - internal-net
    # Проверка готовности СУБД к приему клиентских сессий
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-postgres} -d ${POSTGRES_DB:-wpskills_db}"]
      interval: 5s
      timeout: 5s
      retries: 5
      start_period: 10s

  # 2. Сервис веб-приложения Node.js
  app:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: local-app
    restart: unless-stopped
    ports:
      # Проброс порта наружу: порт_хоста:порт_контейнера
      - "3000:3000"
    environment:
      NODE_ENV: development
      PORT: 3000
      # Обратите внимание: имя хоста в URL — это имя сервиса 'db'
      DATABASE_URL: postgresql://${POSTGRES_USER:-postgres}:${POSTGRES_PASSWORD:-postgres_dev_pass}@db:5432/${POSTGRES_DB:-wpskills_db}?schema=public
    depends_on:
      db:
        # Приложение ждет успешного прохождения healthcheck базы данных!
        condition: service_healthy
    networks:
      - internal-net

# Декларация именованных томов
volumes:
  postgres_data:
    name: fullstack_postgres_volume

# Декларация изолированной пользовательской сети
networks:
  internal-net:
    driver: bridge

import { Pool } from 'pg';

// Переменная DATABASE_URL передается через секцию environment в compose.yaml
const connectionString = process.env.DATABASE_URL;

if (!connectionString) {
  throw new Error('DATABASE_URL не определена в переменных окружения');
}

export const dbPool = new Pool({
  connectionString,
  max: 10, // Максимальный размер пула соединений
  idleTimeoutMillis: 30000,
  connectionTimeoutMillis: 5000,
});

export async function checkDatabaseHealth(): Promise<boolean> {
  try {
    const client = await dbPool.connect();
    const result = await client.query('SELECT NOW() as current_time;');
    client.release();
    console.log('[Database] Успешное подключение к PostgreSQL:', result.rows[0].current_time);
    return true;
  } catch (err: unknown) {
    const msg = err instanceof Error ? err.message : String(err);
    console.error('[Database Error] Сбой подключения к БД:', msg);
    return false;
  }
}

# 1. Запуск всех сервисов в фоновом режиме со сборкой образов при необходимости
docker compose up -d

# 2. Просмотр статуса сервисов и результатов проверок (State / Health)
docker compose ps

# 3. Чтение потоковых логов конкретного сервиса с отслеживанием (follow)
docker compose logs -f app

# 4. Выполнение интерактивной команды внутри работающего контейнера
# Вход в терминальный клиент psql внутри сервиса базы данных:
docker compose exec db psql -U postgres -d wpskills_db

# 5. Перезапуск отдельного сервиса (например, после изменения конфигурации)
docker compose restart app

# 6. Остановка и удаление контейнеров и сетей с сохранением данных в томах
docker compose down

# 7. ПОЛНАЯ очистка со сбросом баз данных (ВНИМАНИЕ: удаляет volumes!)
docker compose down -v