Если тест читает image:latest, а деплой позже читает тот же тег, они могут получить разные образы. Зафиксируйте digest опубликованного артефакта и передавайте его дальше как результат сборки. Первый безопасный тест проводится в отдельном registry-назначении: переставьте тестовый тег между двумя образами и убедитесь, что выпуск по сохранённому digest не изменился.
Номер commit полезен для происхождения, но сам не доказывает равенство файлов двух сборок. Зависимости, базовый образ и параметры могут различаться. Ожидаемый результат — одна прослеживаемая идентичность от опубликованного образа через тест до фактического запуска, а тег остаётся удобным именем, не единственным доказательством версии.
Паспорт релиза связывает несколько идентификаторов
Условный паспорт без секретов:
source_revision: <commit>
build_run: <сборка и попытка>
image_reference: <registry/repository@digest>
platform: <целевая платформа>
tested_reference: <тот же артефакт>
deployed_reference: <проверенное назначение>Docker документирует загрузку по digest как способ закрепить определённую версию образа. Проверено 15 октября 2026 года. Закрепление не обновляет образ автоматически: для получения нового, в том числе исправленного по безопасности, нужно выпустить и проверить новый digest. Поэтому неизменяемость дополняют процессом обновления, а не используют как повод забыть о зависимости.
| Идентификатор | На какой вопрос отвечает | Ограничение |
|---|---|---|
| Commit | Из какой ревизии собирали | Повторная сборка может отличаться |
| Тег | Как удобно назвать образ | Указатель может измениться |
| Digest | Какой объект опубликован | Нужен доступный registry и контекст платформы |
| Запущенная версия | Что обслуживает запрос | Нужно проверить каждый узел |
Продвигайте результат сборки, а не повторяйте её
Если между staging и production заново запускается сборка, после теста возникает другой артефакт. По возможности продвигайте уже проверенный результат, а конфигурацию окружения передавайте предусмотренным способом. Когда часть параметров встраивается при build, честно учитывайте это как отдельную сборку с отдельной проверкой, не называя её тем же результатом.
Для многоплатформенного образа различайте общий опубликованный объект и выбранный платформенный вариант. Не сравнивайте произвольный локальный image ID с другим видом digest и не объявляйте несовпадение дефектом без выяснения уровня. В паспорте должны быть понятны тип ссылки и целевая платформа; тест выполняется для реально используемого варианта.
После запуска проверьте фактические версии на всех обслуживающих узлах. Один ответ health endpoint не доказывает, что весь пул обновился. При поэтапном выпуске старый и новый артефакты могут некоторое время сосуществовать; критерий завершения должен это учитывать. Печатать переменные окружения контейнера ради такой проверки не требуется.
Возврат требует доступного предыдущего объекта
- Проверенный digest сохранён в записи выпуска.
- Тест не перечитывает latest после выбора артефакта.
- Все целевые платформы известны.
- Предыдущий образ защищён от очистки на период возврата.
- Новая попытка развёртывания использует тот же утверждённый артефакт.
Digest не гарантирует, что registry будет хранить объект вечно, и не доказывает доверие к его автору сам по себе. Политика доступа, проверки происхождения и удержание нужных версий решаются отдельно. Если tag уже сдвинулся, восстановите фактическую идентичность из записи сборки и запуска, а не угадывайте её по времени. Для разбора подготовьте безопасный паспорт двух попыток и карту узлов: этого достаточно, чтобы найти место подмены между тестом и деплоем.