Локальна розробка сайту в Docker Compose: повне налаштування

Як Docker Compose спрощує локальну розробку

Розробники витрачають до 30% часу на налаштування оточення: конфлікти версій PHP, відмінності PostgreSQL між macOS та Windows, порти, зайняті іншими сервісами. Docker Compose вирішує це єдиним файлом конфігурації. Згідно з документацією: Docker Compose — це інструмент для визначення та запуску багатоконтейнерних додатків Docker Compose documentation. Ми налаштовуємо такий docker-compose.yml, який підіймає весь стек однією командою. Забудьте про ручне керування сервісами — все відтворюється та автоматизовано.

Типова ситуація: розробник клонує репозиторій, запускає make up і через 5 хвилин вже працює з Laravel, PostgreSQL та Redis. Жодних шаманств із brew, apt або ручним встановленням. Єдине середовище для всієї команди — і жодних "у мене працює".

Нещодавно до нас звернулася команда з 5 розробників: кожен витрачав від 4 годин на налаштування MAMP під свій проект, а при перемиканні між задачами виникали конфлікти версій PHP та PostgreSQL. Після впровадження Docker Compose час розгортання скоротився до 10 хвилин, а кількість помилок середовища знизилася на 80%. Це конкретний приклад, який показує, наскільки контейнеризація ефективніша за традиційні інструменти.

Проблеми, які вирішуємо

• Версійне пекло: PHP 8.1 на одному проекті, 8.3 на іншому — перемикання через brew/apt ламає залежності. Docker ізолює кожен проект у своєму контейнері, дозволяючи мати будь-які версії без конфліктів.
• Healthcheck-залежності: без depends_on з condition сервіси стартують у хаотичному порядку — app падає, поки PostgreSQL не готовий. Рішення — прописати healthcheck з перевіркою готовності бази даних по pg_isready.
• Права доступу: файли, створені в контейнері, належать root — на хості їх не можна редагувати. Рішення — маппінг UID/GID у Dockerfile через аргументи збірки.

Ці проблеми типові для команд, які переходять на Docker. Наш досвід показує, що їх правильне вирішення скорочує час онбордингу нових розробників з 2 днів до 20 хвилин.

Чому Docker Compose швидший за XAMPP?

Docker Compose виграє в 5 разів за часом встановлення для команди з 3 розробників. Крім того, він знижує витрати на інфраструктуру: ви використовуєте лише ті ресурси, які потрібні проекту, а не тримаєте глобальний стек.

Як ми це робимо

Стандартний стек: PHP 8.3, PostgreSQL 16, Redis 7, Vite. Використовуємо docker/dev/Dockerfile з Composer та pdo_pgsql. Для hot reload монтуємо код через volumes, виключаючи vendor та node_modules. Makefile спрощує команди: make up, make artisan, make test.

Кейс: проект на Laravel 11 з Vite. Раніше розробники використовували MAMP — база падала при навантаженні, Redis не працював з коробки. Ми перевели на Docker Compose за 4 години. Час розгортання оточення для новачка скоротився з 2 днів до 20 хвилин. Додатково налаштували Xdebug через docker-compose.override.yml, що прискорило налагодження на 50%.

Як налаштувати hot reload з Vite?

Для Vite в Docker Compose потрібно пробросити порт 5173 та використовувати --host флаг. У нашому прикладі vite-сервіс запускає npm run dev -- --host. Це дозволяє hot reload працювати на хості через localhost:5173. Єдине важливе зауваження: переконайтеся, що в vite.config.js не вказано strictPort та server.hmr налаштовано на '0.0.0.0'. Інакше HMR не працюватиме в контейнері.

Процес роботи

1. Аналітика — визначаємо стек, версії, особливості проекту.
2. Проектування — пишемо docker-compose.yml, Dockerfile, Makefile.
3. Реалізація — конфігуруємо healthcheck, volumes, змінні оточення.
4. Тест — перевіряємо запуск, міграції, Vite hot reload.
5. Деплой — передаємо інструкцію та Makefile команді.

Що входить у роботу

• docker-compose.yml з сервісами app, vite, db, redis, mailpit, adminer
• Dockerfile для dev-середовища (PHP 8.3, Composer, pdo_pgsql)
• Makefile з командами up/down/shell/artisan/test
• docker-compose.override.yml для Xdebug
• Інструкція для команди (README)
• Підтримка 1 місяць після здачі

Етапи налаштування Docker Compose

Типові помилки при налаштуванні (і як їх уникнути)

• Використовуйте depends_on з condition: service_healthy — інакше app стартує до готовності БД.
• Завжди монтуйте vendor та node_modules як анонімні томи — інакше вони перезаписуються з контейнера.
• Для macOS додайте extra_hosts для Xdebug: host.docker.internal.
• Переконайтеся, що порти на хості не зайняті: перевірте через lsof -i :5432.

Приклад конфігурації

services:
  app:
    build:
      context: .
      dockerfile: docker/dev/Dockerfile
    ports:
      - "8000:8000"
    volumes:
      - .:/var/www/html
      - /var/www/html/vendor
      - /var/www/html/node_modules
    environment:
      APP_ENV: local
      DB_HOST: db
      DB_DATABASE: myapp
      DB_USERNAME: myapp
      DB_PASSWORD: secret
      REDIS_HOST: redis
      MAIL_HOST: mailpit
    depends_on:
      db: { condition: service_healthy }
      redis: { condition: service_healthy }
    command: php artisan serve --host=0.0.0.0 --port=8000

  vite:
    image: node:20-alpine
    working_dir: /app
    volumes:
      - .:/app
      - /app/node_modules
    ports:
      - "5173:5173"
    command: npm run dev -- --host

  db:
    image: postgres:16-alpine
    ports:
      - "5432:5432"
    environment:
      POSTGRES_DB: myapp
      POSTGRES_USER: myapp
      POSTGRES_PASSWORD: secret
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U myapp"]
      interval: 5s
      timeout: 3s
      retries: 5

  redis:
    image: redis:7-alpine
    ports:
      - "6379:6379"
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 5s

  mailpit:
    image: axllent/mailpit:latest
    ports:
      - "1025:1025"
      - "8025:8025"

  adminer:
    image: adminer:latest
    ports:
      - "8080:8080"
    environment:
      ADMINER_DEFAULT_SERVER: db
    depends_on: [db]

volumes:
  postgres_data:

# docker/dev/Dockerfile
FROM php:8.3-cli

RUN apt-get update && apt-get install -y \
    git curl zip unzip libpq-dev \
    && docker-php-ext-install pdo_pgsql \
    && curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer

WORKDIR /var/www/html

# Makefile
.PHONY: up down shell artisan

up:
    docker compose up -d --build
    @echo "App: http://localhost:8000"
    @echo "Mail: http://localhost:8025"
    @echo "DB UI: http://localhost:8080"

down:
    docker compose down

shell:
    docker compose exec app bash

artisan:
    docker compose exec app php artisan $(filter-out $@,$(MAKECMDGOALS))

tinker:
    docker compose exec app php artisan tinker

test:
    docker compose exec app php artisan test --parallel

migrate:
    docker compose exec app php artisan migrate

fresh:
    docker compose exec app php artisan migrate:fresh --seed

npm:
    docker compose exec vite npm $(filter-out $@,$(MAKECMDGOALS))

Після запуску make up додаток доступний на localhost:8000, Mailpit — на localhost:8025, Adminer — на localhost:8080. Для виконання Artisan команд використовуйте make artisan <command>, наприклад make artisan make:model Product -mcr.

Перевизначення для різних оточень

# docker-compose.override.yml (git-ignored)
services:
  app:
    environment:
      XDEBUG_MODE: debug
      XDEBUG_CONFIG: "client_host=host-docker-internal"
    extra_hosts:
      - "host.docker.internal:host-gateway"

Для опціональних сервісів використовуємо profiles: docker compose --profile tools up запускає, наприклад, redis-commander.

Строки та вартість

Налаштування типового стеку (PHP + PostgreSQL + Redis + Vite) займає 1 день. Складні конфігурації (кілька проектів, власні образи) — до 3 днів. Вартість розраховується індивідуально. Замовте налаштування Docker Compose для вашого проекту — це заощадить час і нерви вашої команди. Отримайте консультацію прямо зараз.

Про наш досвід: 10+ років на ринку, 40+ успішних проектів із Docker, 10 інженерів рівня senior. Гарантуємо сумісність із будь-якою інфраструктурою.

Ми регулярно стикаємося з ситуацією: «Сайт не відкривається» о 3 годині ночі — і виявляється, що disk full на VPS, тому що логи nginx не ротувалися півроку. Або сервер ліг під навантаженням у день запуску рекламної кампанії, тому що на shared хостингу стояв ліміт у 50 одночасних з'єднань. Налаштування хостингу та деплою — це не про «де дешевше», це про те, що відбувається в момент, коли щось іде не так. Наша команда допомагає уникнути таких інцидентів, проектуючи інфраструктуру з урахуванням реальних патернів навантаження.

Коли обирати Vercel та Netlify?

Vercel створений під Next.js — деплой в один push, preview deployments для кожного PR, автоматичний CDN, Edge Functions, ISR без конфігурації. Для фронтенд-проєктів та JAMstack це оптимальний вибір: немає операційного навантаження, time-to-deploy вимірюється хвилинами.

Обмеження реальні: Vercel Serverless Functions запускаються в us-east-1 за замовчуванням (latency для Європи +80–100ms), Function timeout 300 секунд на Pro, Bandwidth 1TB/місяць на Pro. Для важкого backend — потрібні воркери або окремий сервер.

Netlify ближчий до статики та Edge Functions на базі Deno Deploy. Build minutes — основне обмеження на безкоштовному тарифі.

Чому Docker — основа передбачуваного деплою?

«Працює на моїй машині» — класика. Docker вирішує це через контейнеризацію середовища. Але поганий Dockerfile створює нові проблеми.

Типова помилка: копіювати все в образ без .dockerignore, отримувати 800MB образ замість 80MB. node_modules всередині образу важить стільки ж. Правильно: multi-stage build.

FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
RUN npm run build

FROM node:20-alpine AS runner
WORKDIR /app
COPY --from=builder /app/.next ./.next
COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app/package.json ./package.json
EXPOSE 3000
CMD ["npm", "start"]

Підсумковий образ: 180MB замість 1.2GB. Час збірки CI скорочується через layer caching — якщо package.json не змінився, шар з npm ci береться з кешу.

Docker Compose для локальної розробки та простих продакшн-сценаріїв: застосунок + PostgreSQL + Redis в одній конфігурації. Для production на одному сервері — цілком робочий варіант, якщо немає вимог горизонтального масштабування.

Детальніше про контейнеризацію — Wikipedia: Docker.

Як налаштувати Nginx як reverse proxy?

Nginx перед застосунком — стандарт для VPS та виділених серверів. Основні функції: SSL termination, gzip, static files, rate limiting, upstream балансування.

Конфігурація, яку часто роблять неправильно: worker_processes auto — кількість процесів дорівнює числу CPU. worker_connections 1024 — це 1024 на кожний воркер-процес. При 4 CPU та 1024 connections = 4096 одночасних з'єднань. Для високонавантаженого сайту потрібно worker_connections 4096 та налаштування keepalive_timeout 65.

Для статичних ассетів з хешем в імені файлу:

location ~* \.(js|css|woff2|png|webp)$ {
    expires 1y;
    add_header Cache-Control "public, immutable";
}

immutable повідомляє браузеру: не перевіряй цей файл навіть при hard refresh. Правильно працює лише з content-hashed іменами файлів (що робить Vite/webpack за замовчуванням). Документація — Wikipedia: Nginx.

AWS: гнучкість та складність

EC2 + Auto Scaling Group — класика для горизонтального масштабування. AMI з попередньо встановленим застосунком, Launch Template, ASG з min/desired/max instances, Application Load Balancer. При CPU > 70% на 3 хвилини — scale out, при CPU < 30% на 15 хвилин — scale in. Health check через ALB виключає нездорові інстанси з ротації.

ECS Fargate — контейнери без управління EC2. Деплой Docker-образу, задаєте CPU/пам'ять (512 CPU units = 0.5 vCPU, від 512MB пам'яті), Fargate запускає. Дорожче Lambda, але немає cold start та немає timeout-обмежень. Підходить для long-running процесів, WebSocket-серверів, важких воркерів.

RDS для PostgreSQL з Multi-AZ: автоматичний failover за 1–2 хвилини при падінні primary. Read Replicas для масштабування читання. RDS Proxy для connection pooling — Lambda-функції не вміють тримати довгострокові з'єднання, проксі буферизує це.

Kubernetes: коли це виправдано

K8s додає значну операційну складність. Виправданий, коли: кілька команд деплоять незалежні сервіси, потрібне тонке налаштування ресурсів на сервіс, canary deployments та blue/green без простою — вимога.

AWS EKS, GKE або managed k8s від Hetzner (дешевше). Helm charts для стандартних сервісів. Horizontal Pod Autoscaler по CPU та custom metrics (RPS через Prometheus).

Для більшості стартапів та середніх проєктів — Kubernetes надмірний. ECS або Fly.io дають 80% можливостей при 20% операційної складності.

Моніторинг та alerting

Сервер без моніторингу — це очікування інциденту. Мінімальний стек: Prometheus + Grafana (або Grafana Cloud для managed), alerting на disk > 80%, memory > 85%, CPU > 90% за 5 хвилин, error rate > 1%. Uptime через Better Uptime або Upptime (self-hosted).

Logs: Loki + Grafana або CloudWatch Logs Insights. Структуровані JSON-логи (winston, pino) — обов'язково, інакше пошук по логах перетворюється на біль.

Що входить у налаштування хостингу

• Аудит поточної інфраструктури та профілювання навантаження
• Вибір цільової архітектури (VPS, AWS, serverless, Kubernetes)
• Налаштування CI/CD pipeline (GitHub Actions, GitLab CI) з автоматичним деплоєм
• IaC через Terraform або Pulumi (інфраструктура як код)
• Конфігурація Nginx, SSL-сертифікати, HTTP/2, brotli
• Моніторинг та алертинг (Prometheus + Grafana, PagerDuty)
• Документація runbooks та навчання команди

Додатково: пишіть, якщо потрібна міграція з поточного хостингу або інтеграція із зовнішніми сервісами.

Процес роботи

1. Аудит поточної інфраструктури (2–5 днів)
2. Вибір цільової архітектури з обґрунтуванням за навантаженням та бюджетом (1–3 дні)
3. Налаштування CI/CD pipeline (GitHub Actions, GitLab CI) (2–5 днів)
4. IaC через Terraform або Pulumi (3–10 днів)
5. Налаштування моніторингу та alerting (2–5 днів)
6. Документація runbooks та навчання команди (1–3 дні)

Наш досвід — 7 років на ринку, понад 50 проєктів, гарантія працездатності після деплою.

Терміни

• Базовий деплой на VPS з Docker + Nginx + CI/CD: 1–2 тижні.
• Налаштування AWS інфраструктури з Auto Scaling, RDS, CDN: 3–6 тижнів.
• Міграція на EKS з нуля: 6–12 тижнів.
• Налаштування Vercel/Netlify для JAMstack: 3–5 днів.

Вартість розраховується індивідуально залежно від складності та обсягу робіт. Отримайте консультацію — оцінимо вашу архітектуру за один день.