Какой минимальный набор строк для корректной работы Dockerfile?

Минимальный набор строк для корректного Dockerfile

Для создания минимального, но функционального Dockerfile достаточно трех строк. Однако в реальных проектах он обычно расширяется для оптимизации и соблюдения лучших практик. Рассмотрим базовые варианты.

Абсолютный минимум (3 строки)

FROM alpine:latest
COPY app /app
CMD ["/app/start.sh"]

Разбор минимального варианта:

• FROM: Обязательная строка, задающая базовый образ. Без нее сборка невозможна. Используется самый легкий образ alpine.
• COPY: Копирует файлы из контекста сборки (локальная папка) в образ. Здесь копируется вся директория app.
• CMD: Определяет команду, которая будет выполнена при запуске контейнера. Запускает скрипт из копированного содержимого.

Этот Dockerfile создаст образ, но имеет серьезные недостатки: нет установки зависимостей, не задана рабочая директория, используется latest тег (нестабильный).

Практический минимум для PHP-проекта (6-8 строк)

Для PHP Backend приложения типичный минимальный набор включает:

FROM php:8.2-fpm-alpine

WORKDIR /var/www/html

COPY composer.json composer.lock ./
RUN composer install --no-dev --optimize-autoloader

COPY . .

CMD ["php-fpm"]

Ключевые строки и их назначение:

1. FROM php:8.2-fpm-alpine

    * Выбирает специфичный для PHP образ с нужной версией и минимальной базой `alpine`. Это критично для корректной работы PHP.

1. WORKDIR /var/www/html

    * Устанавливает рабочую директорию внутри контейнера. Все последующие команды (`COPY`, `RUN`) выполняются относительно нее.

1. COPY composer.json composer.lock ./

    * Копирует файлы зависимостей перед их установкой. Это позволяет лучше использовать кэш Docker.

1. RUN composer install ...

    * Инструмент для управления зависимостями PHP. Флаг `--no-dev` исключает разработческие пакеты, `--optimize-autoloader` оптимизирует автозагрузку для производства.

1. COPY . .

    * Копирует остальные файлы проекта (включая исходный код) в образ.

1. CMD ["php-fpm"]

    * Запуск PHP FastCGI Process Manager как основного процесса контейнера.

Расширенный пример с оптимизацией

В реальности даже минимальный Dockerfile дополняется для производительности, безопасности и стабильности:

# Используем конкретный тег для стабильности
FROM php:8.2.15-fpm-alpine AS builder

# Устанавливаем системные зависимости для PHP расширений
RUN apk add --no-cache \
    git \
    unzip \
    $PHPIZE_DEPS \
    && rm -rf /var/cache/apk/*

# Настраиваем рабочую директорию
WORKDIR /app

# Копируем и устанавливаем Composer зависимости (с кэшированием)
COPY composer.json composer.lock ./
RUN composer install --no-dev --no-progress --optimize-autoloader \
    && composer clear-cache

# Копируем исходный код
COPY src/ ./src/
COPY public/ ./public/

# Этап для финального, минимального образа (мulti-stage build)
FROM php:8.2.15-fpm-alpine

WORKDIR /app
COPY --from=builder /app .

# Настройка пользователя для безопасности
RUN chown -R www-data:www-data /app
USER www-data

# Запуск приложения
CMD ["php-fpm"]

Дополнительные важные строки:

• AS builder и COPY --from=builder: Это multi-stage build. Сборка зависимостей происходит в промежуточном образе (builder), а финальный образ содержит только необходимые для запуска файлы. Это уменьшает размер итогового образа.
• RUN apk add ...: Установка системных пакетов, требуемых для работы Composer или PHP расширений (например, для gd, pdo_mysql).
• RUN chown ... и USER www-data: Изменение владельца файлов и переключение на непривилегированного пользователя повышает безопасность контейнера.

Итог

Минимальный теоретический набор — 3 строки (FROM, COPY, CMD).
Практический минимум для PHP — 6-8 строк, включающий выбор PHP-образа, установку зависимостей через Composer и задание рабочей директории.
Оптимальный подход — использование multi-stage build, установка только необходимых системных пакетов и настройка безопасности, что увеличивает количество строк, но значительно улучшает качество и эффективность образа. Главное правило: каждая строка должна быть обоснована и направлена на создание легкого, безопасного и стабильного контейнера.