Основные инструкции Dockerfile

~3 минуты · 7 примеров · 3 вопроса

Разбираем по очереди главные инструкции Dockerfile: FROM, WORKDIR, COPY, RUN, CMD, EXPOSE, ENV.

Инструкция — команда Dockerfile, выполняемая при сборке образа; большинство инструкций создают новый слой.

FROM — базовый образ

Первая инструкция всегда FROM — она задаёт базовый образ, на котором всё строится. Берут официальный образ с нужным рантаймом:

FROM python:3.12-slim

Варианты -slim и -alpine заметно меньше полного образа — их предпочитают, чтобы уменьшить размер.

WORKDIR — рабочая директория

WORKDIR задаёт текущую папку внутри образа; все последующие COPY, RUN и CMD выполняются относительно неё. Если папки нет — она создаётся.

WORKDIR /app

COPY — копирование файлов

COPY ИСТОЧНИК НАЗНАЧЕНИЕ копирует файлы из контекста сборки (вашей папки) внутрь образа:

COPY requirements.txt .
COPY . .

RUN — выполнить при сборке

RUN выполняет команду во время сборки образа и сохраняет результат в новый слой. Типично — установка зависимостей:

RUN pip install -r requirements.txt

CMD — команда запуска контейнера

CMD задаёт команду, которая выполняется при запуске контейнера (а не при сборке). Предпочтительна форма-массив:

CMD ["python", "app.py"]

Важно не путать: RUN срабатывает один раз при сборке образа, CMD — каждый раз при старте контейнера. CMD в Dockerfile должна быть одна.

EXPOSE — документирование порта

EXPOSE сообщает, какой порт слушает приложение. Это документация: сам по себе порт наружу не открывается — для этого нужен -p при запуске.

EXPOSE 8000

ENV — переменные окружения

ENV задаёт переменные окружения внутри образа:

ENV APP_ENV=production
ENV PORT=8000
ИнструкцияКогда срабатываетНазначение
FROMсборкабазовый образ
WORKDIRсборкарабочая папка
COPYсборкакопировать файлы в образ
RUNсборкавыполнить команду (создаёт слой)
CMDзапусккоманда старта контейнера
EXPOSE—документирует порт
ENVсборка/запускпеременная окружения

Итог

  • FROM задаёт базовый образ, WORKDIR — рабочую папку, COPY переносит файлы.
  • RUN выполняется при сборке, CMD — при запуске контейнера.
  • EXPOSE лишь документирует порт, ENV задаёт переменные окружения.

Проверь себя

Три вопроса по уроку. Ответы никуда не идут — это для тебя.

1В чём разница между RUN и CMD?

2Что делает инструкция EXPOSE?

3Какая инструкция обязательно стоит первой в Dockerfile?

Следующий урок
11 · Сборка образа: docker build Открыть урок 11
Урок 9: Что такое Dockerfile