Что такое Dockerfile и как его написать?

Question

Accepted Answer

**Dockerfile** — это текстовый файл с инструкциями для **сборки образа Docker** — он описывает базовый образ, зависимости, файлы для копирования и способ запуска приложения. Это делает сборку образов воспроизводимой и управляемой по версиям.

## Базовый Dockerfile

```dockerfile
# FROM — the base image to build on
FROM node:20-alpine

# WORKDIR — set the working directory inside the image
WORKDIR /app

# COPY dependency files first (for better layer caching)
COPY package*.json ./
# RUN — execute a command during the BUILD (install dependencies)
RUN npm install

# COPY the rest of the application code
COPY . .

# EXPOSE — document the port the app listens on
EXPOSE 3000

# CMD — the command to run when a CONTAINER starts
CMD ["node", "server.js"]
```

## Ключевые инструкции

```text
FROM     → the base image (starting point) — REQUIRED, usually first
WORKDIR  → set the working directory for subsequent instructions
COPY/ADD → copy files from the host into the image
RUN      → execute a command at BUILD time (install packages, compile) → creates a layer
ENV      → set environment variables
EXPOSE   → document which port(s) the container listens on
CMD      → the default command to run when the container STARTS (one per Dockerfile)
ENTRYPOINT → the executable that runs (CMD provides default args to it)
ARG      → build-time variables
```

## RUN vs CMD vs ENTRYPOINT (часто путают)

```text
RUN        → runs at BUILD time (builds the image — e.g. install dependencies)
CMD        → runs at CONTAINER START (the default command; overridable at run)
ENTRYPOINT → the main executable at start (CMD becomes its default arguments)
→ RUN builds the image; CMD/ENTRYPOINT define what runs when it starts.
```

## Почему это важно

Понимание Dockerfile необходимо, потому что это то, как собираются образы Docker, поэтому написание Dockerfile — это фундаментальный, повседневный навык Docker.

Dockerfile обеспечивает **воспроизводимую, управляемую по версиям сборку образов** — описывая в коде ровно то, как построить образ (базовый образ, зависимости, файлы, конфигурацию и команду запуска), так что любой может собрать один и тот же образ последовательно, что является центральным для ценности Docker по воспроизводимости.

Понимание **ключевых инструкций** — `FROM` (базовый образ), `WORKDIR`, `COPY` (добавление файлов), `RUN` (выполнение команд на этапе сборки, например установка зависимостей), `ENV`, `EXPOSE`, и `CMD`/`ENTRYPOINT` (определение того, что запускается при старте контейнера) — необходимо для написания эффективных Dockerfile'ов для реальных приложений.

Особенно важное и часто путаемое различие — **`RUN` vs `CMD` vs `ENTRYPOINT`**: `RUN` выполняется во **время сборки** (построение образа, например установка пакетов), а `CMD`/`ENTRYPOINT` определяют, что запускается при **старте контейнера** (команда приложения) — понимание этого предотвращает распространённые ошибки.

Знание практических паттернов (например, копирование файлов зависимостей перед кодом для лучшего кеширования слоёв) отражает написание эффективных Dockerfile'ов.

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