К списку статей DevOps и Инфраструктура

Организация стандартизированного локального окружения в команде разработки на базе Docker

Опубликовано: 28.09.2026 в 15:09

Ликвидация хаоса в разработке: как забыть о проблеме «а на моем компьютере всё работает»

Знакомая картина: в команду приходит новый разработчик, и его первый рабочий день (а иногда и два) полностью уходит на ручную установку PHP, баз данных, расширений и локальных серверов. Но даже после этого начинаются сюрпризы. Разные версии библиотек, локальные пути или неучтенные системные зависимости приводят к тому, что код, написанный одним программистом, намертво ломается у другого или падает сразу после деплоя на продакшн. Единственный способ прекратить этот хаос — полностью изолировать среду разработки. Мы разберем, как развернуть единое, предсказуемое локальное окружение на базе Docker, которое запускается одной командой за 5 минут на любой ОС (Windows, macOS, Linux).

Архитектура стандартизированного окружения разработки

Профессиональное локальное окружение должно не просто дублировать production-стек, но и содержать все необходимые инструменты отладки, которые категорически запрещено включать на «живом» сервере. Мы упакуем бэкенд в связку Nginx + PHP-FPM, добавим изолированные контейнеры для СУБД MySQL, кэша Redis, а также внедрим почтовую заглушку Mailpit (чтобы случайно не отправить тестовые письма реальным клиентам из базы данных) и прокинем Xdebug для удобного пошагового поиска багов прямо в вашей IDE.

💡 Рис 1. Схема изоляции локального Docker-окружения

Шаг 1: Конфигурация docker-compose.yml для всей команды

Создаем единый файл оркестрации инфраструктуры, который фиксирует версии всех системных компонентов и пакетов.

yaml

version: '3.8'

services:
  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./:/var/www/isitreal
      - ./docker/nginx:/etc/nginx/conf.d
    depends_on:
      - php

  php:
    build:
      context: .
      dockerfile: ./docker/php.dockerfile
    volumes:
      - ./:/var/www/isitreal

  mysql:
    image: mysql:8.0
    ports:
      - "3306:3306"
    environment:
      MYSQL_DATABASE: isitreal_local
      MYSQL_ROOT_PASSWORD: secret_password
    volumes:
      - mysql_data:/var/lib/mysql

  mailpit:
    image: axllent/mailpit
    ports:
      - "8025:8025" # Веб-интерфейс для просмотра писем

volumes:
  mysql_data:

Шаг 2: Создание Makefile для автоматизации рутинных команд

Чтобы разработчикам не приходилось каждый раз писать длинные команды вызова Docker, мы заворачиваем ключевые процессы (запуск, остановка, очистка кэша, запуск тестов) в короткие псевдонимы через системный Makefile проекта.

makefile

init:
	cp .env.example .env
	docker-compose up -d --build
	docker-compose exec php composer install
	docker-compose exec php php artisan key:generate
	docker-compose exec php php artisan migrate --seed

up:
	docker-compose up -d

down:
	docker-compose down

test:
	docker-compose exec php vendor/bin/phpunit

Итоги и резюме

Эффект от внедрения единого стандарта

Перевод команды на стандартизированное Docker-окружение полностью решает проблему онбординга: новый программист разворачивает проект и приступает к написанию кода в первый же час, просто выполнив команду make init. Полная идентичность окружений гарантирует, что тесты будут проходить одинаково у всех участников команды, а написанный функционал уедет на продакшн-сервер без неожиданных сюрпризов и сбоев.

Была ли полезна статья?

Оценки помогают мне понимать, какие темы вам наиболее интересны.

Чтобы оценить, войдите или зарегистрируйтесь.