Что такое Dockerfile и как его использовать

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

На этой странице описаны команды, которые вы можете использовать в Dockerfile.

При запуске команды docker build для создания нового образа подразумевается, что Dockerfile находится в текущей рабочей директории. Если этот файл находится в каком-то другом месте, его расположение можно указать с использованием флага -f. Создадим простой Dockerfile:

FROM ubuntu:20.04
RUN apt-get update && apt-get install -y wget curl nano
 
WORKDIR /root/docker
COPY myfile myfile

И создадим новый образ с именем и тегом custom_ubuntu:1

docker build -t custom_ubuntu:1 .

Dockerfile все открывается инструкцией FROM с указанием родительского образа.

Далее зачастую пишутся команды RUN, поскольку каждая инструкция RUN создает новый слой. Хорошей практикой считается писать конвейеры логически связанных команд в одной инструкции RUN. Например, мы поместили команды обновления пакетов apt, установку нескольких утилит в одну инструкцию. Для комбинирования команд используется логический оператор «И», обозначающийся как &&.

Инструкция WORKDIR устанавливает рабочую директорию контейнера. Все последующие команды, работающие с привязками к директории, такие как COPY, RUN, CMD, ENTRYPOINT будут выполняться исходя из установленной директории. Например, в команде COPY, нашего примера, второй аргумент в действительности выглядит так

COPY myfile /root/docker/myfile

Проверим создался новый образ или нет командой docker images:

REPOSITORY                 TAG       IMAGE ID       CREATED         SIZE
custom_ubuntu              1         af08e52086b9   4 minutes ago   72.8MB

Запустим образ и проверим отработала ли WORKDIR из Dockerfile, да как видим pwd выдало правильный путь

docker run --rm -it custom_ubuntu:1
root@3cc16903b955:~/docker# pwd
/root/docker

docker history custom_ubuntu:1 позволяет увидеть что происходило при сборке вашего образа.

Таблица инструкций Dockerfile с примерами команд и опций

Все инструкции описаны в официальной документации Dockerfile reference.

Инструкция	Описание	Пример использования	Комментарий
FROM	Задает базовый образ. Все последующие инструкции создают слои поверх родительского образа.	FROM python:latest FROM debian:wheezy	Быстрее всего можно найти образ с нужным тегом на Docker hub.
RUN	Выполняет команду внутри контейнера и сохраняет результат.	RUN mkdir /usr/src/app/ RUN apt-get update && apt-get install python3-pip -y"	RUN может исполнять конвейер команд с логическими операторами && \|\|
COPY	Копирует файлы и папки из текущей директории, где находится пользователь в указанную директорию в контейнере. Если файл нужно скачать по ссылке или распаковать архив используйте ADD.	COPY . /usr/src/app/	COPY считывает позицию пользователя на хосте, поэтому первым аргументом идет «.».
ADD	Копирует файлы и папки из текущей позиции пользователя, скачивает файлы по URL и работает с tar-архивами."	ADD https://wiki.dieg.info/_media/winmtr.zip /usr/src/app/	Официальная документация не рекомендует применять ADD. Для скачивания по URL можно использовать RUN с CURL или WGET, а для копирования — COPY.
CMD	Выполняет команду с указанными аргументами во время запуска контейнера.	CMD ["python","web_interface.py"]	CMD должна быть одна в конце Dockerfile. CMD может вызывать исполняемый файл — .sh Аргументы docker run переопределяют CMD. Базовое поведение CMD дополнять инструкцию ENTRYPOINT. CMD всегда пишется после ENTRYPOINT.
ENTRYPOINT	Похожа на CMD. Инструкции ENTRYPOINT и CMD могут быть переопределены с помощью флагов командной строки.	ENTRYPOINT ["python", "web_interface.py"]	ENTRYPOINT может использоваться совместно с CMD.
ENV	Задает переменные среды внутри образа, на которые могут ссылаться другие инструкции.	ENV ADMIN="darkfire" Также можно передать переменную окружения TOKEN при запуске контейнера, используя ключ e docker run --rm -it -e TOKEN=abc ubuntu/entry или ключ –env-file - записывает в переменные окружения все данные из файла	ENV часто применяется для передачи информации в контейнеризированное приложение через переменные среды.
ARG	Задает переменные, значение которых передается докером во время сборки образа.	ARG maintainer=darkfire	В отличие от ENV-переменных, ARG-переменные недоступны во время выполнения контейнера.
WORKDIR	Устанавливает рабочую директорию внутри контейнера.	WORKDIR /usr/src/app/	Последующие инструкции CMD, RUN, ENTRYPOINT наследуют привязку к директории установленной WORKDIR.
VOLUME	Создает и подключает постоянный том хранения данных.	VOLUME /data_cont_1	Просмотреть существующие тома можно командой docker volume ls. К контейнеру можно подключить существующий том, для этого достаточно указать уже существующий том.
EXPOSE	Инструкция, которая позволяет сообщить пользователю, какой(ие) порт(ы) слушает приложение внутри контейнера. Инструкция сама по себе не прокидывает порты на хост. Чтобы использовался указанный в EXPOSE порт — нужно указать docker run -P при запуске контейнера.	EXPOSE 5000	Если требуется пробросить и сопоставить разные порты внутри и снаружи контейнера используется docker run -p порт на хосте: порт в контейнере docker run -d -p 81:80 --name httpd-container httpd Эта команда запускает Docker-контейнер httpd (HTTP-сервер Apache) и маппинг 81 порта хоста с 80 портом внутри Docker-контейнера. Подробнее в статье Проброс портов или маппинг портов
LABEL	maintainer="darkfire@dieg.info"	Обычно содержит информацию об авторе образа

ENTRYPOINT

Зачем нужен Entrypoint?

Используйте ENTRYPOINT, если вы не хотите, чтобы пользователь вашего образа изменял исполняемый файл, который запускается при запуске контейнера. Используйте CMD, если записываете команду (исполняемый файл) по умолчанию, которую пользователь с лёгкостью может переопределить на этапе запуска контейнера. Если точка входа определена, исполняемый файл все равно можно переопределить, используя флаг –entrypoint. Подробнее в официальной документации Понимание взаимодействия CMD и ENTRYPOINT.

LABEL

LABEL добавляет метаданные в образ и обычно содержит информацию об авторе образа.

LABEL maintainer="darkfire@dieg.info"

ARG

Docker Cache: Как сделать чистую пересборку образа, Запрет кеширования (3 способа): Использования ARG для отключения кеширования

ADD

Docker Cache: Как сделать чистую пересборку образа, Запрет кеширования (3 способа): Использования ADD для отключения кеширования

Как найти запущенного контейнера

Заходишь на хост где запущены контейнеры и этот радует, что хотя бы это получилось Задача нужно посмотреть как контейнер собирался то есть нужен Dockerfile. Пробуем искать по всему жесткому диску:

find / -name Dockerfile

Заключение

Docker Cache: Как сделать чистую пересборку образа, Запрет кеширования (3 способа)