Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-02-26

1 На Docker Hub выложено множество готовых образов, которые используются администраторами и разработчиками: интерпретаторы и компиляторы языков, веб-сервера, базы данных и многое другое. Большую часть из них можно использовать на серверах без изменений, передав какие-то переменные окружения. Но для любого разрабатываемого приложения нужно создавать свой собственный образ. В него войдет код приложения и все его зависимости. Даже когда нам будет нужно изменить всего лишь конфигурацию, например Nginx, все равно придется создать свой собственный образ, в который добавлен конфигурационный файл.

2 В этом уроке мы научимся создавать Docker-образ на примере JavaScript проекта: данный язык программирования достаточно распространен в среде разработчиков. Но все описанные принципы так же будут подходить и для других языков. Для создания образа будем использовать популярный микрофреймворк<a>fastify</a>.

3 Для начала создадим каркас приложения с помощью готового шаблона:

4 Эта команда создаст шаблон приложения в директории/outзапущенного контейнера, которая, на самом деле, является директорией/var/tmp/docker-fastify-exampleна нашей машине. В итоге у нас получается такая структура проекта:

5 Для запуска этого приложения, нам нужно выполнить две основные задачи: установить зависимости и запустить сервер. Без Docker это выглядит так:

6 Установку зависимостей нужно выполнить еще до создания образа, так как во время первой установки формируется файлpackage-lock.json. Он нужен для фиксации зависимостей: с его помощью мы гарантируем, что в образе будут использоваться ровно те зависимости, которые мы подключали во время разработки. Сделать это можно следующим образом:

7 Теперь директория с приложением выглядит так:

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

9 В основном, командыDockerfileинтуитивно понятны. Видно, что мы "упаковываем" приложение в образ, выполняем установку зависимостей и описываем то, как его запустить. Подробнее о командах мы поговорим позже, а сейчас посмотрим, как собирается, запускается и пушится образ в Docker Hub.

10 Для сборки образа в директории сDockerfileнужно выполнить команду указанную ниже:

11 Сборка образа занимает какое-то время: нужно подождать, пока выполнятся все команды. Как результат, в списке образов появляется образ с именемhexlet/docker-fastify-exampleи тегомlatest. Его можно запустить и убедиться в работоспособности:

12 Для полной проверки, откройте в браузере ссылку<a>http://localhost:3000</a>и убедитесь что сайт открылся. Остался последний шаг - загрузить образ на Docker Hub. Для этого понадобится подготовительная работа:

13 <ol><li>Регистрация<a>https://hub.docker.com/</a></li>

14 <li>Подключение к аккаунту через запуск команды docker login в терминале. Docker попросит ввести имя пользователя и пароль</li>

15 <li>Создание репозитория с именемdocker-fastify-exampleв<a>личном кабинете</a></li>

16 </ol>Теперь, чтобы загрузить образ в Docker Hub, мы должны дать ему правильное имя. По соглашению, часть имени Docker-образа до символа/, должна совпадать с именем вашего пользователя Docker Hub. Чтобы так сделать, вам необходимо запустить команду сборки еще раз:

17 Теперь можнопушить:

18 Если репозиторий публичный, то скачать и запустить этот образ сможет любой человек, с доступом в интернет.

19 <h2>Теги</h2>

20 Теги у Docker-репозиториев изменяемые. Если изменить образ и снова его запушить с тем же тегом, образ поменяется. Для тегаlatestэто ожидаемое поведение, а вот для версий нет. За этим нужно следить самостоятельно и не менять образ для уже существующих тегов. Если меняется образ, то правильно создавать новый тег:

21 <h2>Команды Dockerfile</h2>

22 Dockerfileсостоит из команд, которые выполнятся сверху вниз по очереди, формируя файловую систему образа. Каждая последующая команда "видит" результаты предыдущей команды. Ниже мы разберем наиболее популярные команды, которые встречаются в большинстве образов.

23 <h3>FROM</h3>

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

25 Практически все образы в Docker формируются не с нуля, а на базе уже существующих образов. Образы формируют дерево, в котором одни образы наследуют файловые системы других образов начиная с базового образа<a>scratch</a>.

26 Команда FROM задает образ, чья файловая система берется за основу. Все последующие команды, которые изменяют файловую систему, работают уже с ней. Потому команда FROM идет первой вDockerfile.

27 <h3>WORKDIR</h3>

28 Команда WORKDIR задает рабочий каталог, относительно которого выполняются все действия во время формирования образа и при входе в контейнер:

29 WORKDIR автоматически создает директорию, если ее еще нет.

30 <h3>COPY</h3>

31 Команда COPY копирует файлы и директории с хост-машины внутрь Docker-образа. Она принимает два параметра: первый - что копируем, второй - куда копируем и под каким именем. Второй параметр может принимать три варианта:

32 <ul><li>Абсолютный путь, копирование происходит ровно по нему</li>

33 <li>Относительный путь, копирование происходит относительно установленной рабочей директории WORKDIR</li>

34 <li>Точка, файл или директория копируется как есть в рабочую директорию</li>

35 </ul>Если точка идет первым параметром, то это обозначает что копироваться будет директория целиком.

36 Для полного понимания принципов работы команды COPY, нужно представлять что такое контекст. Помните, когда мы указывали точку во время сборки образа? Это и есть контекст:

37 Контекст - это директория, относительно которой работает первый параметр в COPY. Обычно контекстом указывают ту директорию, которая содержитDockerfile. Но это не обязательно, ведь контекстом может быть и другая директория:

38 Во время сборки образа, контекст целиком копируется внутрь системных директорий Docker, из которых в образ переносится все, что указано в команде COPY. Из-за этого иногда возникают проблемы. Контекст может содержать директории, которые не должны попадать в образ, например, .git, или зависимости установленные локально (node_modules), так как они все равно устанавливаются заново во время сборки. Чтобы избежать их попадания во внутрь, нужно создать файл.dockerignoreи указать там те директории и файлы, которые не должны быть частью контекста. Принцип работы файла такой же, как и у.gitignore.

39 node_modules .git logs tmp

40 Игнорирование таких директорий и файлов дает дополнительный плюс. Чем меньше размер контекста, тем быстрее он копируется. Если не следить за его размером, то процесс копирования может увеличиться до десятков секунд и даже минут.

41 <h3>RUN</h3>

42 Команда RUN выполняет переданную строчку в терминале от пользователяroot. С ее помощью вносятся основные изменения в файловую систему, добавляются пакеты, ставятся зависимости и так далее. Команд RUN может быть добавлено любое количество, обычно делают по одной команде на одно действие.

43 RUN выполняется в не интерактивном режиме, это значит, что если выполняемая команда запросит пользовательский ввод, например разрешение на установку чего-либо, то мы не сможем выбрать ответyes. Поэтому все команды в RUN запускают в неинтерактивном режиме:

44 <h3>CMD</h3>

45 CMD задает команду, которая выполняется при запуске контейнера по умолчанию. Она используется только в том случае, если контейнер был запущен без указания команды

46 <h3>ENV</h3>

47 Задает переменные окружения. Команды, выполняющиеся после ENV, видят эти переменные и могут их использовать.

48 С этой командой нужно быть острожнее. Переменные окружения созданы для того, чтобы их можно было менять, а их указание в Dockerfile фиксирует значения. По этому случаю, в Dockerfile обычно указывают только те переменные окружения, которые не зависят от среды запуска, как в примере выше. Нам в любом случае надо указать, что сервер должен запускаться на 0.0.0.0, иначе его будет невозможно увидеть снаружи. В большинстве ситуаций переменные окружения передаются снаружи для конкретного запуска: