Provision
—— XP

Имя образа, теги и реестр

теория~8 минут+160 XP

Ты уже пользовался реестром, даже не заметив: docker run nginx скачал образ с Docker Hub, публичного реестра Docker. Реестр — это склад образов: туда отправляют собранное, а оттуда его забирают серверы, конвейеры и кластеры. Без него образ так и живёт на ноутбуке, где его собрали, а с ним образ с одной машины доходит до всех остальных. Свои образы компании держат в своих реестрах: GitLab Container Registry, облачных или поднятых у себя.

Чтобы образ туда попал, у него должно быть правильное полное имя — как адрес на почтовой посылке: адрес реестра, путь внутри него, имя и версия. Короткое nginx — посылка «в соседний подъезд», полный адрес Docker допишет сам. Дальше в уроке — как это имя устроено, чем тег отличается от digest и почему образ, собранный на Mac с чипом M, падает на обычном сервере.

Полное имя образа

Полное имя состоит из четырёх частей, и каждая что-то значит.

Полное имя образа разобрано выносками на четыре части: адрес реестра, путь внутри него, имя образа и тег. Ниже показано, во что разворачивается короткое имя postgres:17-alpine.
Короткое имя — сокращение: postgres:17-alpine разворачивается в полный адрес на Docker Hub.

Чтобы отправить свой образ в реестр, ему дают имя с адресом этого реестра. Команда docker tag не копирует образ, а вешает на него второе имя. Адрес длинный, поэтому положим его в переменную оболочки — имя, вместо которого bash подставит значение.

ubuntu@stand:~$
REPO=localhost:5000/provision/app
ubuntu@stand:~$
docker tag provision-app:2.0 $REPO:2.0
ubuntu@stand:~$
docker images | grep provision
ubuntu@stand:~$
localhost:5000/provision/app:2.0   c56396a73fb5   229MB   50.3MB
provision-app:1.0                  a2a34da434f4   234MB   51.8MB
provision-app:2.0                  c56396a73fb5   229MB   50.3MB

grep оставил строки с нашими образами. Это формат Docker 29: в первой колонке имя вместе с тегом, во второй — идентификатор. Одинаковый идентификатор у первой и третьей строки — это один и тот же образ под двумя именами. Места второе имя не занимает.

Отправить и забрать

Образ уходит в реестр командой docker push, забирается командой docker pull. Так выглядит отправка в реестр на стенде, который мы поднимем в миссии; передаётся образ слоями.

ubuntu@stand:~$
docker push $REPO:2.0
ubuntu@stand:~$
62c1a4b8d3e9: Pushed
4f7d2e91c0a3: Layer already exists
2.0: digest: sha256:9f2a71c4e8b0... size: 1573

Pushed — слой отправлен, его в реестре не было. Layer already exists — слой уже есть, передавать нечего: так работает экономия от слоёв, и при правильном порядке инструкций в Dockerfile при каждой новой версии уезжает только слой с кодом.

В последней строке — digest, контрольная сумма образа. Тег можно передвинуть на другой образ, а digest — нет, и для выката это разница между «примерно тем» и «ровно тем».

Тег против digest

Тег выглядит как версия, но ведёт себя как наклейка на коробке: её можно переклеить на другую. Digest — опись содержимого: поменяли хоть байт, и опись перестала сходиться.

Вверху тег как подвижная ссылка: одно имя app:1.4.2 в разные дни указывает на разные контрольные суммы. Внизу digest, который всегда указывает на один образ.
Наклейку можно переклеить, опись — нет. Поэтому для машин фиксируют digest, а тег оставляют людям.

Отсюда ошибка, на которую напарываются все: кто-то пересобрал и отправил тот же тег, два сервера скачали его в разное время — и под одной «версией» работает разное содержимое. Правило: тег релиза выпускается один раз и больше не двигается. Понадобилась правка — новая версия. Digest своих образов показывает флаг --digests.

ubuntu@stand:~$
docker images --digests $REPO
ubuntu@stand:~$
REPOSITORY                     TAG   DIGEST                  SIZE
localhost:5000/provision/app   2.0   sha256:9f2a71c4e8b0...  229MB

На практике одну сборку помечают сразу несколькими тегами: версией 1.0.0 для людей и коротким хешем коммита sha-a2f5d81 — по нему из любого контейнера можно найти исходники. Тег latest в эксплуатации не используют: получить его случайно проще, чем осознанно. Как это делает конвейер сам, увидишь в разделе про CI/CD.

Под какой процессор собран образ

Образ собирается под процессор той машины, на которой его собирали. Стенд на Mac с чипами M1–M4 или на Raspberry Pi — это процессор arm64, а почти все облачные серверы и VPS — amd64, то есть обычный x86. Образ с arm64-стенда, запущенный на amd64-сервере, падает сразу с ошибкой exec format error: процессор не понимает программ внутри. Готовые образы вроде nginx или postgres этим не страдают — в реестре под одним тегом лежат варианты для нескольких процессоров, и Docker берёт свой. Свои образы так автоматически не умеют.

Под какой процессор собран образ, говорит docker inspect — он описывает не только контейнеры, но и образы, — а флаг -f вынимает одно поле.

ubuntu@stand:~$
docker inspect -f '{{.Architecture}}' provision-app:2.0
ubuntu@stand:~$
arm64

На amd64-стенде здесь будет amd64, и тогда беспокоиться не о чем. Если же собираешь на arm64, а выкатывать будешь на amd64, процессор называют явно флагом --platform у команды docker buildx build — это та же сборка с расширенными возможностями.

ubuntu@stand:~$
docker buildx build --platform linux/amd64 -t $REPO:2.0 .
ubuntu@stand:~$
[+] Building 96.4s (14/14) FINISHED
 => [builder 1/4] FROM docker.io/library/python:3.12-slim
 => [builder 4/4] RUN pip install --no-cache-dir --prefix=/install
 => => naming to localhost:5000/provision/app:2.0

Вывод тот же, что у обычной сборки, только дольше: почти полторы минуты против пятидесяти секунд. После неё docker inspect из прошлой команды ответит amd64.

Чужой процессор сборщик изображает программно, поэтому такая сборка заметно медленнее. На Docker Desktop эмуляция включена сразу, на Linux её ставят один раз по инструкции из документации Docker, раздел Multi-platform builds: https://docs.docker.com/build/building/multi-platform/. Через список вроде --platform linux/amd64,linux/arm64 собирают сразу оба варианта под одним тегом — так устроены образы на Docker Hub.

Какой реестр выбрать

Docker Hub знаком всем, но у него лимит скачиваний для анонимных клиентов. Серверы выходят в интернет через один адрес, лимит быстро выбирается, и выкат падает с ошибкой toomanyrequests: You have reached your pull rate limit. Поэтому рабочие образы держат рядом с кодом — в GitLab Container Registry — или в облачном реестре, а для стенда хватит своего.

Свой реестр — это тоже контейнер, образ registry:3. Поднимем его в миссии раздела и опубликуем только на петлю: у него нет ни пароля, ни шифрования, и наружу его выставляют только за прокси с TLS.

Хранение и чистка

Образы копятся незаметно и однажды занимают весь диск. Сколько занято, показывает docker system df.

ubuntu@stand:~$
docker system df
ubuntu@stand:~$
TYPE            TOTAL   ACTIVE   SIZE      RECLAIMABLE
Images          17      4        4.8GB     3.9GB (81%)
Containers      6       4        12MB      0B (0%)
Local Volumes   3       2        210MB     48MB (22%)
Build Cache     84      0        1.6GB     1.6GB

Смотри на RECLAIMABLE — сколько можно освободить без вреда: образы, которыми не пользуется ни один контейнер, и кеш сборки. Чистит их docker image prune -a, флаг -a значит «все неиспользуемые, а не только безымянные». Тома эта команда не трогает — и правильно.

Словарь урока

Реестр
Хранилище образов, откуда их забирают серверы и кластеры. Docker Hub, GitLab Container Registry, свой registry:3. ↩ к тексту
Тег
Подвижная метка образа. Тег релиза выпускают один раз и не переставляют. ↩ к тексту
Digest
Контрольная сумма содержимого образа. Указать на другой образ не может. ↩ к тексту

Что спросят на собеседовании

  • Почему latest не используют в проде?
    Это подвижная метка: под одним именем на разных серверах может оказаться разное содержимое, и откатиться некуда — прежнего образа под этим тегом уже нет.
  • Выкат упал с toomanyrequests. Что произошло?
    Выбран лимит скачиваний Docker Hub: серверы выходят в интернет через один адрес. Лечится авторизацией, зеркалом или своим реестром.

Что дальше

Всё для миссии есть. Дальше — собрать образ стенда как для эксплуатации и положить его в свой реестр.

Проверь себя+160 XPдве попытки
1
Имя образа
Что делает docker tag?
2
Тег и digest
Чем digest надёжнее тега?
3
Схема тегов
Каким тегом помечать релиз, по которому потом откатываются?
4
Хранение и чистка
Какая команда показывает, сколько места заняли образы, контейнеры и кеш?
ответь на все вопросы, чтобы проверить

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.