Основы Dockerfile
Тема дорожной карты · Docker & Containers
Dockerfile — декларативный рецепт, который BuildKit читает, чтобы собрать образ. Файл начинается с FROM, далее идут команды сборки, копирование файлов, установка переменных окружения и в конце — описание запуска контейнера (CMD/ENTRYPOINT). Сборка: docker build -t myapp:1.0 .. Частые ошибки: контекст сборки — это весь указанный каталог, поэтому добавляйте .dockerignore, чтобы не утащить node_modules, .git и секреты; пробелы в конце строк и регистр инструкций ловят новичков; быстрая пересборка возможна только при правильном порядке слоёв. Продвинутые темы — multi-stage сборки, BuildKit-фронтенды и buildx.
Как это работает
Основы Dockerfile хранятся как стек read-only слоёв + JSON config. docker build читает Dockerfile и создаёт по одному слою на инструкцию (RUN, COPY, ADD) — попадание в кэш пропускает работу, если родительский слой и команда не изменились. Теги (repo:tag) — изменяемые указатели; контент адресуется SHA-256 digest. Multi-stage сборки (FROM base AS builder … FROM slim … COPY --from=builder) поставляют только финальный stage, ужимая runtime-образ.
Когда применять
Сортируйте инструкции Dockerfile от наименее- к наиболее-часто-меняющимся (system deps → app deps → app source) — максимизируете попадания в кэш. Multi-stage сборки — везде, где финальный образ требует меньше, чем сборка (Go-бинарники, скомпилированные ассеты, npm-собранный JS). Закрепляйте базовые образы по digest (FROM node:22-alpine@sha256:...) для воспроизводимости — node:latest пересобирается с тем Node, что выкатили сегодня. .dockerignore держит .git, node_modules, тестовые артефакты вне build context.
Типичные ошибки
Ловушки Основы Dockerfile: изменяемый тег :latest в production (образ сегодня ≠ образ вчера); огромные образы из-за apt-get update без rm -rf /var/lib/apt/lists/* в том же RUN; убитый кэш из-за COPY . . перед RUN npm install (каждое изменение кода инвалидирует слой deps); секреты, запечённые в слой через ENV (живут в history навсегда — используйте --secret mount или build args аккуратно).