re:re:actable
Урок 013 минуты чтения

Что такое Dockerfile

На этой странице
Кратко

Dockerfile — текстовый рецепт сборки образа: базовый образ (FROM), рабочий каталог, установка зависимостей, копирование кода, сборка, пользователь и команда запуска. Инструкции выполняются сверху вниз, а изменяющие файловую систему (RUN, COPY, ADD) создают слои, которые кэшируются. Поэтому хороший Dockerfile упорядочен от редко меняющегося к часто меняющемуся: сначала lock-файлы и npm ci, потом исходники.

Вопрос

Что такое Dockerfile и как он превращается в образ?

Основная идея

FROM node:24-alpine           # базовый образ: ОС-userland + Node.js
 
WORKDIR /app                  # рабочий каталог для следующих инструкций
 
COPY package.json package-lock.json ./
RUN npm ci                    # зависимости — отдельным слоем ради кэша
 
COPY . .                      # исходный код
RUN npm run build
 
EXPOSE 3000                   # документация: приложение слушает 3000
USER node                     # не root
CMD ["node", "dist/main.js"]  # команда запуска контейнера
docker build -t my-api .
docker run -p 3000:3000 my-api

Как Dockerfile превращается в образ

ИнструкцияРезультат
FROMСлои базового образа
RUN, COPY, ADDНовый слой файловой системы
WORKDIR, ENV, USER, EXPOSE, CMD, ENTRYPOINT, LABELТолько метаданные (WORKDIR ещё и создаёт каталог)

Если инструкция и её входные данные не изменились, BuildKit берёт слой из кэша. Как только слой изменился, все следующие пересобираются — подробнее в уроке про слои и кэш.

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

# Плохо: любая правка кода заново запускает npm ci
COPY . .
RUN npm ci
 
# Хорошо: npm ci берётся из кэша, пока не изменился lock-файл
COPY package.json package-lock.json ./
RUN npm ci
COPY . .

На реальном проекте это разница между сборкой за 5 секунд и за 2 минуты.

Что должен описывать хороший Dockerfile

  • Фиксированную версию runtime (node:24-alpine, а не node:latest).
  • Воспроизводимую установку зависимостей (npm ci по lock-файлу).
  • Что попадает в образ, а что нет (вместе с .dockerignore).
  • Пользователя, от которого работает процесс.
  • Команду запуска в exec-форме (["node", "dist/main.js"]).
  • Для production — multi-stage сборку, чтобы в финальный образ не попали компиляторы и devDependencies.

Парсер-директива syntax

# syntax=docker/dockerfile:1
FROM node:24-alpine

Первая строка-комментарий подключает актуальную версию синтаксиса Dockerfile с возможностями BuildKit: RUN --mount=type=cache, --mount=type=secret, heredoc в RUN. В современных версиях Docker BuildKit включён по умолчанию.

Частые ошибки

  • Копировать весь проект до установки зависимостей.
  • Не использовать .dockerignore и тащить в образ node_modules, .git и .env.
  • Оставлять devDependencies и исходники в production-образе.
  • Запускать приложение от root.
  • Использовать npm install вместо npm ci — сборка перестаёт быть воспроизводимой.

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

  • RUN выполняется при сборке, CMD — при запуске контейнера.
  • Каждая инструкция, меняющая файлы, — новый слой; удаление файла в следующем слое не уменьшает образ.
  • Dockerfile — часть кода проекта: его ревьюят, версионируют и проверяют в CI.

Мини-шпаргалка

  • FROM → WORKDIR → lock-файлы → RUN npm ci → COPY . . → build → USER → CMD.
  • Редко меняющееся — выше, часто меняющееся — ниже.
  • .dockerignore обязателен.
  • Production — multi-stage.

Документация

Docker: Dockerfile reference, Docker: Building best practices.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам