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

Коротко о главном

Docker позволяет запускать приложение вместе с его зависимостями в контейнере, не устанавливая всё в основную систему. Это упрощает разработку, тестирование и развёртывание. Важно понимать, что контейнер — не виртуальная машина: он использует ядро хоста и требует аккуратной настройки прав.

Контейнеры дают воспроизводимость: одинаковый образ работает на ноутбуке и сервере. Они быстрее VM, проще масштабируются и удобны для CI. Но безопасность и хранение данных требуют отдельного внимания.

Docker — инструмент, который стоит освоить, если вы регулярно работаете в Linux. Ниже — путь от установки до уверенной повседневной работы: без предположений, что всё уже настроено само.

Зачем нужен Docker

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

Установка

В Debian, Ubuntu и Linux Mint используется пакетный менеджер APT:

sudo apt install docker.io docker-compose-v2

В Fedora и RHEL-совместимых системах пакет ставится через DNF:

sudo dnf install docker docker-compose

В Arch Linux и производных пакет доступен в официальных репозиториях:

sudo pacman -S docker docker-compose

Пошаговая настройка

После установки переходите к базовому сценарию. Команды ниже выполняйте от пользователя с достаточными правами, но не запускайте всё под root без необходимости.

1. Запустите службу

Включите Docker в автозагрузку и добавьте пользователя в группу docker. Помните: членство в группе docker фактически даёт root-доступ к хосту.

sudo systemctl enable --now docker
sudo usermod -aG docker $USER

2. Проверьте установку

Запустите тестовый контейнер и убедитесь, что клиент видит демон.

docker run --rm hello-world
docker info

3. Соберите первый образ

Создайте простой Dockerfile. Фиксируйте версию базового образа и не запускайте приложение от root.

FROM python:3.12-slim
WORKDIR /app
COPY . .
RUN pip install --no-cache-dir -r requirements.txt
USER 1000
CMD ["python", "app.py"]

4. Запустите через Compose

Compose описывает сервисы, сети и volume в одном файле. Это удобнее десятков docker run.

services:
  web:
    build: .
    ports:
      - "127.0.0.1:8000:8000"
    restart: unless-stopped

5. Смотрите логи и ресурсы

Для диагностики используйте docker logs, stats и inspect. Не удаляйте volume, пока не убедились, что данные не нужны.

docker compose logs -f
docker stats
docker volume ls

Базовая конфигурация

Начните с минимального рабочего варианта. Не копируйте большой конфиг целиком: добавляйте параметры по одному и проверяйте результат после каждого изменения.

{
  "log-driver": "json-file",
  "log-opts": {"max-size": "10m", "max-file": "3"}
}

Практические советы

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

Совет 1. Не используйте тег latest в продакшене: фиксируйте конкретную версию.

Не используйте тег latest в продакшене: фиксируйте конкретную версию.

Совет 2. Храните секреты вне образа: в переменных окружения или secrets.

Храните секреты вне образа: в переменных окружения или secrets.

Совет 3. Ограничивайте ресурсы контейнера через —memory и —cpus.

Ограничивайте ресурсы контейнера через —memory и —cpus.

Совет 4. Настройте ротацию логов, иначе диск заполнится.

Настройте ротацию логов, иначе диск заполнится.

Совет 5. Для баз данных всегда используйте именованный volume.

Для баз данных всегда используйте именованный volume.

Практический сценарий

Представьте типовую задачу: нужно развернуть Docker на одной машине, проверить работу и передать доступ коллеге. Начните с чистой системы или снапшота, чтобы результат был воспроизводим. Запишите все команды в отдельный файл — это одновременно шпаргалка и черновик будущей автоматизации.

Дальше действуйте короткими шагами: установка, минимальная конфигурация, проверка, затем расширение. После каждого шага фиксируйте, что именно изменилось и как это проверить. Такой журнал экономит время, когда через месяц понадобится повторить настройку на другом сервере или объяснить её коллеге.

Порядок работ для этого сценария выглядит так:

1. Запустите службу
2. Проверьте установку
3. Соберите первый образ
4. Запустите через Compose
5. Смотрите логи и ресурсы

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

Типичные ошибки

Ниже — сбои, которые встречаются чаще всего. Перед исправлением сохраните текущие конфиги и запишите, какие изменения вносите: так проще откатиться.

1. Permission denied при подключении к Docker

Пользователь не в группе docker или не перелогинился. Проверьте id и перезайдите в сессию.

2. Порт уже занят

Найдите процесс через ss -ltnp и остановите его либо измените публикуемый порт.

3. Данные исчезли после пересоздания контейнера

Контейнеры не хранят данные постоянно. Подключите именованный volume или bind mount и проверьте путь.

Что проверить перед вводом в работу

Перед тем как считать настройку завершённой, пройдитесь по короткому списку. Он не заменяет полноценный аудит, но отсекает большинство очевидных проблем.

Если какой-то пункт вызывает затруднение, это сигнал вернуться к соответствующему разделу, а не откладывать проверку. Настройка, которую нельзя повторить, плохо работает не только у коллег, но и у вас самих через полгода.

Итог

Docker — это не «поставил и забыл». Рабочая конфигурация складывается из понимания задачи, аккуратной установки и проверки результата. Начните с базового сценария, затем добавляйте только те возможности, которые действительно используете.