Глава 1 — Основы работы с Docker

Compose — Управление сервисами
Docker — Отладка контейнеров
Docker Compose — Структура docker-compose.yml

Compose — Управление сервисами

Эта страница объясняет базовые команды docker compose, которые используются для запуска, остановки, пересборки и перезапуска сервисов в проекте. Материал рассчитан на начинающих: здесь разобрано, что делает каждая команда, в каких случаях её использовать и на что обратить внимание, чтобы случайно не сломать рабочее окружение.

Что такое Docker Compose

Docker Compose — это инструмент для управления несколькими контейнерами как единым приложением. Обычно в проекте есть файл docker-compose.yml, где описано:

какие сервисы нужно запускать
какие образы использовать
какие порты пробрасывать
какие папки подключать как volumes
какие переменные окружения передавать контейнерам

Например, один проект может состоять из:

nginx
php
mysql
redis

Вместо того чтобы запускать каждый контейнер отдельно длинными командами docker run, Compose позволяет поднять всё одной командой.

Перед началом работы

Обычно работа с Compose ведётся из директории проекта, где лежит docker-compose.yml.

Пример:

cd /opt/flamy_projects/project_name

Проверить, что файл действительно есть в текущей папке:

ls -la

Если нужно найти compose-файлы во всей папке проектов:

find /opt/flamy_projects -type f -name "docker-compose*.yml"

Примечание: Большинство команд docker compose нужно выполнять именно в той директории, где находится docker-compose.yml. Иначе Docker не поймёт, с каким проектом работать.

Базовый принцип работы

Чаще всего цикл работы выглядит так:

перейти в папку проекта
запустить сервисы
проверить, что контейнеры работают
посмотреть логи при ошибках
при необходимости пересобрать или перезапустить сервисы

Запуск сервисов

Запуск всех сервисов в фоне

docker compose up -d

Эта команда:

читает docker-compose.yml
создаёт нужные контейнеры
запускает их
оставляет терминал свободным для дальнейшей работы

Флаг -d означает detached mode, то есть запуск в фоне.

Когда использовать

Подходит почти для любого обычного старта проекта:

после перезагрузки сервера
после первого клонирования проекта
после остановки контейнеров
после мелких изменений конфигурации

Пример

cd /opt/flamy_projects/site1
docker compose up -d

Что важно помнить

Если образа ещё нет локально, Docker попытается:

скачать его из реестра
либо собрать локально, если это описано в конфигурации

Для новичков: up не всегда означает просто «включить». Эта команда может не только запускать, но и создавать контейнеры заново, если это требуется по конфигурации.

Остановка и удаление контейнеров проекта

Остановка проекта

docker compose down

Команда останавливает и удаляет:

контейнеры проекта
созданные Compose-сети

Когда использовать

Подходит, если нужно:

полностью выключить проект
освободить ресурсы
заново поднять окружение
сбросить сетевые проблемы внутри проекта

Что команда не удаляет

По умолчанию docker compose down не удаляет volumes. Это важно, потому что именно в volumes часто лежат данные:

база данных
загруженные файлы
кэш приложения
постоянные данные сервисов

Важно: Для новичков это одна из самых полезных вещей: обычный down не стирает данные сам по себе. Но всё равно всегда нужно понимать, где именно проект хранит данные — в volumes, bind mounts или внутри контейнера.

Пример

docker compose down

После этого проект можно снова поднять:

docker compose up -d

Принудительное пересоздание контейнеров

Пересоздать контейнеры даже без изменений

docker compose up -d --force-recreate

Эта команда заставляет Docker пересоздать контейнеры, даже если он считает, что ничего не поменялось.

Когда использовать

Полезно, если:

контейнер ведёт себя странно
изменились переменные окружения
конфигурация применена не так, как ожидалось
нужен «чистый» перезапуск контейнера без удаления volumes

Что важно помнить

контейнеры будут пересозданы
volumes останутся на месте
данные в volumes не пропадут

Пояснение: Контейнер и volume — это не одно и то же. Контейнер — это «запущенная оболочка приложения». Volume — это место, где могут лежать постоянные данные. Поэтому пересоздание контейнера не обязательно означает потерю данных.

Пересборка образов

Пересборка нужна тогда, когда меняется не только запуск контейнера, а именно его образ. Обычно это происходит, если вы изменили:

Dockerfile
системные пакеты
зависимости приложения
шаги сборки

Пересборка без использования кэша

docker compose build --no-cache

Docker при сборке старается использовать кэш, чтобы не выполнять одинаковые шаги повторно. Это ускоряет работу, но иногда мешает, если нужен действительно «чистый» rebuild.

Флаг --no-cache говорит: не использовать ранее сохранённые слои, а собрать всё заново.

Когда использовать

Подходит, если:

изменения в Dockerfile «не подхватываются»
обновились зависимости
есть подозрение на устаревший build cache
нужно убедиться, что образ собран полностью с нуля

Пример

docker compose build --no-cache
docker compose up -d

Примечание: Эта операция может занять заметно больше времени, чем обычная сборка.

Пересобрать и сразу запустить

docker compose up -d --build

Команда делает два действия сразу:

при необходимости пересобирает образ
запускает контейнеры

Когда использовать

Это один из самых частых сценариев после изменения:

Dockerfile
зависимостей
конфигурации сборки

Пример

docker compose up -d --build

Чем отличается от `build --no-cache`

docker compose up -d --build может использовать кэш
docker compose build --no-cache собирает всё полностью заново

Если нужно просто обновить контейнер после обычных изменений — чаще хватает:

docker compose up -d --build

Если есть сомнения в корректности кэша — используйте:

docker compose build --no-cache
docker compose up -d

Обновление образов из реестра

Скачать свежие версии образов

docker compose pull

Команда скачивает новые версии образов, которые указаны в docker-compose.yml.

Когда использовать

Подходит, если проект использует готовые образы из registry, например:

nginx:latest
redis:7
mysql:8

Важный момент

docker compose pull только скачивает образы, но не перезапускает контейнеры автоматически.

Чтобы применить обновление, обычно выполняют:

docker compose pull && docker compose up -d

Пример

cd /opt/flamy_projects/site1
docker compose pull
docker compose up -d

Важно: На production-серверах обновление образов нужно делать осторожно. Новая версия образа может изменить поведение приложения или сломать совместимость.

Перезапуск сервисов

Иногда контейнер не нужно пересобирать или пересоздавать — достаточно просто перезапустить процесс.

Перезапуск одного сервиса

docker compose restart <service>

Пример:

docker compose restart nginx

Когда использовать

Подходит, если:

сервис завис
нужно перечитать конфигурацию
произошёл временный сбой
после некоторых изменений достаточно обычного рестарта

Перезапуск всех сервисов

docker compose restart

Перезапускает все сервисы, описанные в compose-файле.

Когда использовать

Подходит, если:

нужно быстро перезапустить весь проект
нет уверенности, какой именно сервис работает некорректно
нужно «освежить» всё окружение без удаления контейнеров

Остановка и запуск отдельного сервиса вручную

docker compose stop <service> && docker compose start <service>

Пример:

docker compose stop php && docker compose start php

Зачем это нужно, если есть `restart`

Иногда удобнее разделить действия на две части:

сначала корректно остановить контейнер
затем отдельно запустить снова

Это бывает полезно при диагностике или когда нужно убедиться, что сервис полностью остановился.

Запуск только одного сервиса

docker compose up -d <service>

Пример:

docker compose up -d nginx

Когда использовать

Полезно, если:

нужно поднять только один сервис
вы тестируете конкретный контейнер
не хотите трогать всё окружение

Примечание: Если сервис зависит от других, Compose может поднять и их тоже.

Проверка итоговой конфигурации

Посмотреть итоговый compose-конфиг

docker compose config

Эта команда показывает итоговую конфигурацию после обработки:

docker-compose.yml
override-файлов
переменных окружения
подстановок из .env

Когда использовать

Очень полезно перед запуском, если:

не подставляются env-переменные
есть сомнения в корректности конфигурации
нужно понять, что Docker реально «видит»

Почему это важно для новичков

Иногда в YAML всё выглядит правильно, но итоговая конфигурация получается другой. docker compose config помогает увидеть конечный результат до запуска.

Наиболее частые сценарии в работе

Обычный запуск проекта

docker compose up -d

Обновить образы и применить изменения

docker compose pull && docker compose up -d

После изменения Dockerfile или зависимостей

docker compose up -d --build

Полная пересборка без кэша

docker compose build --no-cache
docker compose up -d

Быстро перезапустить один сервис

docker compose restart nginx

Полностью выключить проект

docker compose down

Что выбрать в типовых ситуациях

Ситуация: нужно просто запустить проект

Используйте:

docker compose up -d

Ситуация: поменялся Dockerfile

Используйте:

docker compose up -d --build

Ситуация: образ ведёт себя странно, нужен чистый rebuild

Используйте:

docker compose build --no-cache
docker compose up -d

Ситуация: нужно скачать свежие образы из registry

Используйте:

docker compose pull && docker compose up -d

Ситуация: сервис просто нужно перезапустить

Используйте:

docker compose restart <service>

Частые ошибки новичков

Запуск команды не из той директории

Если выполнить docker compose up -d не там, где лежит docker-compose.yml, можно получить ошибку о том, что конфигурационный файл не найден.

Путаница между `restart`, `up`, `build` и `down`

Кратко:

restart — просто перезапуск уже существующих контейнеров
up — поднять проект
up --build — поднять проект с пересборкой
down — остановить и удалить контейнеры проекта

Ожидание, что `pull` сам обновит работающие контейнеры

docker compose pull только скачивает новый образ. Чтобы контейнеры начали работать на новой версии, нужен ещё запуск:

docker compose up -d

Краткая памятка

docker compose up -d                     # Запуск проекта в фоне
docker compose down                      # Остановка и удаление контейнеров проекта
docker compose up -d --force-recreate    # Пересоздать контейнеры принудительно
docker compose build --no-cache          # Полная пересборка без кэша
docker compose up -d --build             # Пересборка и запуск
docker compose pull                      # Скачать свежие образы
docker compose restart <service>         # Перезапуск одного сервиса
docker compose restart                   # Перезапуск всех сервисов
docker compose stop <service> && docker compose start <service>  # Остановить и запустить сервис отдельно
docker compose up -d <service>           # Запуск одного сервиса
docker compose config                    # Проверка итоговой конфигурации

Docker — Отладка контейнеров

Эта страница объясняет основные команды Docker, которые используются для диагностики и отладки контейнеров. Здесь разобраны способы посмотреть запущенные контейнеры, проверить их состояние, изучить логи, подключиться внутрь контейнера и выполнить команды для анализа проблемы. Материал рассчитан на начинающих и помогает быстро понять, что происходит внутри контейнера, если приложение работает некорректно.

Когда используется отладка контейнеров

На практике команды из этой страницы используются в следующих ситуациях:

контейнер не запускается
сервис падает после старта
приложение возвращает ошибки
сервис не отвечает
контейнер постоянно перезапускается
нужно проверить что происходит внутри контейнера

Типичный порядок диагностики:

проверить список контейнеров
проверить статус контейнера
посмотреть логи
зайти внутрь контейнера
проверить процессы или выполнить команды

Просмотр контейнеров

Показать контейнеры текущего проекта

docker compose ps

Команда показывает контейнеры, которые относятся к текущему docker-compose проекту.

Пример вывода:

NAME                IMAGE          STATUS        PORTS
project_nginx       nginx:latest   Up 2 hours    0.0.0.0:80->80/tcp
project_php         php:8.2-fpm    Up 2 hours

Что здесь можно увидеть

имя контейнера
используемый образ
статус контейнера
проброшенные порты

Когда использовать

Это первая команда, которую стоит выполнить, если нужно проверить:

запущен ли сервис
работает ли контейнер
не упал ли он

Показать все запущенные контейнеры

docker ps

Эта команда показывает все запущенные контейнеры в системе, независимо от проекта.

Пример:

CONTAINER ID   IMAGE         STATUS         PORTS
ab12cd34       nginx         Up 2 hours     80/tcp
cd34ef56       redis         Up 3 hours     6379/tcp

Чем отличается от `docker compose ps`

Команда	Показывает
`docker compose ps`	контейнеры текущего проекта
`docker ps`	все контейнеры на сервере

Показать все контейнеры (включая остановленные)

docker ps -a

Показывает:

работающие контейнеры
остановленные контейнеры
контейнеры с ошибками

Пример статуса:

Exited (1) 5 minutes ago

Что это означает

Контейнер запустился, но приложение внутри завершилось с ошибкой.

В таком случае следующим шагом нужно посмотреть логи.

Табличный формат вывода

docker ps -a --format "table {{.ID}}\t{{.Names}}\t{{.Status}}\t{{.Ports}}"

Этот формат удобен, если нужно быстро увидеть:

ID контейнера
имя
статус
порты

Пример вывода:

CONTAINER ID   NAMES         STATUS          PORTS
3acb1234       project_php   Up 10 minutes
7d8e5678       project_nginx Up 10 minutes   80/tcp

Просмотр логов контейнеров

Логи — это основной источник информации при отладке.

Именно здесь можно увидеть:

ошибки приложения
ошибки запуска
проблемы подключения к базе
ошибки конфигурации

Просмотр логов сервиса

docker compose logs <service>

Пример:

docker compose logs nginx

Вывод покажет весь лог контейнера.

Просмотр логов в реальном времени

docker compose logs -f <service>

Флаг -f означает follow — следить за логом в реальном времени.

Пример:

docker compose logs -f php

Это удобно, если:

вы только что перезапустили сервис
нужно увидеть новые ошибки

Выход из режима просмотра:

CTRL + C

Показать последние строки логов

docker compose logs --tail=100 <service>

Показывает только последние 100 строк.

Пример:

docker compose logs --tail=100 nginx

Когда использовать

Если контейнер работает давно и лог очень большой.

Логи с временными метками

docker compose logs --timestamps <service>

Пример:

docker compose logs --timestamps php

Вывод будет выглядеть примерно так:

2026-03-11T12:32:10 app started
2026-03-11T12:32:11 connected to database

Это удобно для анализа событий во времени.

Подключение внутрь контейнера

Иногда для диагностики нужно зайти внутрь контейнера, чтобы:

посмотреть файлы
проверить конфигурацию
выполнить команды
проверить сетевые подключения

Подключиться через shell

docker compose exec <service> sh

Пример:

docker compose exec php sh

После выполнения команды вы окажетесь внутри контейнера.

Использование bash

Если в контейнере установлен bash, можно использовать:

docker compose exec <service> bash

Пример:

docker compose exec php bash

Важно: Не во всех контейнерах есть bash. Многие минимальные образы используют только sh.

Проверить файлы внутри контейнера

После входа можно выполнять обычные команды Linux:

ls
cd
cat
ps
top

Например:

ls /var/www/html

Просмотр процессов внутри контейнера

docker compose top <service>

Пример:

docker compose top php

Команда показывает список процессов внутри контейнера.

Пример вывода:

UID     PID     CMD
root    123     php-fpm

Когда использовать

Полезно, если:

приложение зависло
нужно проверить, запущен ли процесс
нужно убедиться, что сервис действительно работает

Выполнение команды внутри контейнера

Можно выполнить команду без входа в shell.

Формат:

docker compose exec <service> <command>

Пример:

docker compose exec php php -v

Вывод:

PHP 8.2.4 (cli)

Ещё примеры

Проверить установленные пакеты:

docker compose exec php composer --version

Проверить Node.js:

docker compose exec node node -v

Копирование файлов из контейнера

Иногда нужно забрать файл из контейнера.

Копирование файла из контейнера

docker cp container:/path/file .

Пример:

docker cp project_php:/var/log/php.log .

Файл будет скопирован в текущую папку.

Копирование файла в контейнер

docker cp file container:/path/

Пример:

docker cp config.php project_php:/var/www/config.php

Типичный сценарий диагностики

Если сервис не работает, обычно делают следующее:

1 Проверить контейнеры

docker compose ps

2 Проверить логи

docker compose logs --tail=100

3 Если ошибка не очевидна — подключиться внутрь

docker compose exec php sh

4 Проверить процессы

docker compose top php

5 Проверить приложение вручную

Например:

curl localhost

Полезные советы для новичков

Всегда начинайте диагностику с логов

В большинстве случаев ошибка уже записана в лог.

Не путайте контейнер и сервис

В Compose:

service — описание контейнера в docker-compose.yml
container — фактически запущенный экземпляр

Проверяйте статус контейнера

Если статус:

Exited

контейнер уже остановился, и нужно смотреть логи.

Краткая памятка

docker compose ps                          # контейнеры текущего проекта
docker ps                                  # все запущенные контейнеры
docker ps -a                               # все контейнеры включая остановленные

docker compose logs <service>              # логи сервиса
docker compose logs -f <service>           # логи в реальном времени
docker compose logs --tail=100 <service>   # последние строки логов
docker compose logs --timestamps <service> # логи с временными метками

docker compose exec <service> sh           # войти в контейнер
docker compose exec <service> bash         # войти через bash
docker compose exec <service> <command>    # выполнить команду

docker compose top <service>               # процессы контейнера

docker cp container:/path/file .           # копировать из контейнера
docker cp file container:/path/            # копировать в контейнер

Docker Compose — Структура docker-compose.yml

Эта страница объясняет структуру файла docker-compose.yml и основные параметры, используемые при описании сервисов Docker. Здесь разобраны ключевые разделы конфигурации, такие как services, volumes, networks, environment, ports и другие. Материал рассчитан на начинающих и помогает понять, как правильно описывать инфраструктуру приложения в Docker Compose.

Что такое docker-compose.yml

docker-compose.yml — это файл конфигурации, который описывает:

какие контейнеры нужно запустить
какие образы использовать
какие порты открыть
какие volumes подключить
какие сети создать

Compose позволяет запускать всё приложение одной командой:

docker compose up -d

Базовая структура docker-compose.yml

Пример минимального файла:

version: "3.9"

services:
  nginx:
    image: nginx:1.25
    ports:
      - "8080:80"

Этот файл создаёт контейнер nginx и открывает порт 8080.

Основные разделы docker-compose.yml

Типичная структура файла выглядит так:

services:
volumes:
networks:

Раздел services

Раздел services описывает контейнеры проекта.

Пример:

services:
  nginx:
    image: nginx:1.25

  php:
    image: php:8.2-fpm

В этом примере создаются два сервиса:

nginx
php

Каждый сервис становится отдельным контейнером.

Параметр image

Определяет Docker-образ, который будет использоваться.

Пример:

services:
  nginx:
    image: nginx:1.25

Docker скачает образ nginx:1.25, если он отсутствует.

Параметр build

Используется, если образ нужно собрать локально из Dockerfile.

Пример:

services:
  app:
    build: .

Это означает:

собрать образ из Dockerfile текущей директории

Можно указать путь:

services:
  app:
    build: ./app

Параметр ports

Используется для проброса портов.

Пример:

ports:
  - "8080:80"

Это означает:

сервер:8080 → контейнер:80

После запуска приложение будет доступно:

http://server:8080

Параметр volumes

Подключает volumes или папки сервера.

Пример:

volumes:
  - ./src:/var/www/html

Это означает:

сервер ./src → контейнер /var/www/html

Использование Docker Volumes

Пример с volume:

services:
  mysql:
    image: mysql:8
    volumes:
      - mysql_data:/var/lib/mysql

volumes:
  mysql_data:

Volume будет хранить данные базы.

Параметр environment

Передаёт переменные окружения контейнеру.

Пример:

environment:
  MYSQL_ROOT_PASSWORD: secret
  MYSQL_DATABASE: app_db

Контейнер получит переменные:

MYSQL_ROOT_PASSWORD
MYSQL_DATABASE

Использование .env файла

Переменные можно хранить в .env.

Пример:

DB_PASSWORD=secret
APP_ENV=production

И использовать в Compose:

environment:
  DB_PASSWORD: ${DB_PASSWORD}

Параметр depends_on

Определяет зависимости между сервисами.

Пример:

services:
  php:
    depends_on:
      - mysql

Это означает:

сначала запускается mysql
затем php

Важно: depends_on не гарантирует, что сервис полностью готов к работе.

Параметр restart

Определяет политику перезапуска контейнера.

Пример:

restart: always

Возможные значения:

Значение	Поведение
no	не перезапускать
always	всегда перезапускать
on-failure	только при ошибке
unless-stopped	перезапускать, пока не остановлен вручную

Параметр networks

Определяет сети Docker.

Пример:

services:
  app:
    networks:
      - backend

networks:
  backend:

Контейнер будет подключён к сети backend.

Пример полного docker-compose.yml

Пример простого веб-приложения:

services:

  nginx:
    image: nginx:1.25
    ports:
      - "80:80"
    volumes:
      - ./src:/var/www/html

  php:
    image: php:8.2-fpm
    volumes:
      - ./src:/var/www/html
    depends_on:
      - mysql

  mysql:
    image: mysql:8
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: app
    volumes:
      - mysql_data:/var/lib/mysql

volumes:
  mysql_data:

Этот файл запускает:

nginx
php
mysql

Проверка docker-compose.yml

Перед запуском полезно проверить конфигурацию:

docker compose config

Команда покажет итоговую конфигурацию после обработки переменных.

Запуск проекта

Запуск всех сервисов:

docker compose up -d

Остановка проекта

docker compose down

Типичные ошибки в docker-compose.yml

Ошибка YAML

Файл YAML чувствителен к отступам.

Неправильно:

services:
nginx:
image: nginx

Правильно:

services:
  nginx:
    image: nginx

Неверные порты

Если порт уже используется:

Bind for 0.0.0.0:80 failed

Нужно изменить порт.

Отсутствие volumes

Если данные не вынесены в volumes, они могут потеряться при пересоздании контейнера.

Краткая памятка

services     → контейнеры проекта
image        → используемый образ
build        → сборка образа
ports        → проброс портов
volumes      → подключение хранилища
environment  → переменные окружения
depends_on   → зависимости сервисов
restart      → политика перезапуска
networks     → сети контейнеров

Глава 1 — Основы работы с Docker

Compose — Управление сервисами

Что такое Docker Compose

Перед началом работы

Базовый принцип работы

Запуск сервисов

Запуск всех сервисов в фоне

Когда использовать

Пример

Что важно помнить

Остановка и удаление контейнеров проекта

Остановка проекта

Когда использовать

Что команда не удаляет

Пример

Принудительное пересоздание контейнеров

Пересоздать контейнеры даже без изменений

Когда использовать

Что важно помнить

Пересборка образов

Пересборка без использования кэша

Когда использовать

Пример

Пересобрать и сразу запустить

Когда использовать

Пример

Чем отличается от build --no-cache

Обновление образов из реестра

Скачать свежие версии образов

Когда использовать

Важный момент

Пример

Перезапуск сервисов

Перезапуск одного сервиса

Когда использовать

Перезапуск всех сервисов

Когда использовать

Остановка и запуск отдельного сервиса вручную

Зачем это нужно, если есть restart

Запуск только одного сервиса

Когда использовать

Проверка итоговой конфигурации

Посмотреть итоговый compose-конфиг

Когда использовать

Почему это важно для новичков

Наиболее частые сценарии в работе

Обычный запуск проекта

Обновить образы и применить изменения

После изменения Dockerfile или зависимостей

Полная пересборка без кэша

Быстро перезапустить один сервис

Полностью выключить проект

Что выбрать в типовых ситуациях

Ситуация: нужно просто запустить проект

Ситуация: поменялся Dockerfile

Ситуация: образ ведёт себя странно, нужен чистый rebuild

Ситуация: нужно скачать свежие образы из registry

Ситуация: сервис просто нужно перезапустить

Частые ошибки новичков

Запуск команды не из той директории

Путаница между restart, up, build и down

Ожидание, что pull сам обновит работающие контейнеры

Краткая памятка

Docker — Отладка контейнеров

Когда используется отладка контейнеров

Просмотр контейнеров

Показать контейнеры текущего проекта

Что здесь можно увидеть

Когда использовать

Показать все запущенные контейнеры

Чем отличается от docker compose ps

Показать все контейнеры (включая остановленные)

Что это означает

Табличный формат вывода

Просмотр логов контейнеров

Просмотр логов сервиса

Просмотр логов в реальном времени

Показать последние строки логов

Когда использовать

Логи с временными метками

Чем отличается от `build --no-cache`

Зачем это нужно, если есть `restart`

Путаница между `restart`, `up`, `build` и `down`

Ожидание, что `pull` сам обновит работающие контейнеры

Чем отличается от `docker compose ps`