01
Откройте список этапов
Пример разделяет сборку и выполнение. Нумерация начинается с нуля. Нажмите на этап для перехода к FROM; раскройте инструкцию, чтобы увидеть исходный текст и её назначение.
Docker / Контейнеры
Форматировщик Dockerfile
Перейдите от диагностики к исходной строке и проверьте отступы до замены текста.
Форматировщик Dockerfile
Исходный Dockerfile
Результат
Обработка в памяти браузера, без запросов на сборку или к реестру образов.
Результат устарел. Повторите проверку перед экспортом.
Форматировщик Dockerfile помогает при ревью длинного файла, где трудно найти границу между сборкой и запуском. Исходный текст остаётся рядом с результатом, поэтому структуру можно проверить без немедленной перезаписи.
Здесь можно форматировать Dockerfile онлайн и увидеть, как устроена многоэтапная сборка. Встроенный линтер Dockerfile показывает поддерживаемые статические замечания; проверка Dockerfile не подтверждает доступность образа или успешное выполнение команд.
Зачем нужен Форматировщик Dockerfile
Переход к границе этапа
Форматировщик Dockerfile перечисляет все FROM в исходном порядке с образом, необязательным именем и позицией. Этапы без имени тоже доступны для перехода к соответствующей строке.
Изменения видны до применения
Отформатированный текст отображается отдельно. Сравните отступы продолжений и число изменённых строк. После применения один возврат восстанавливает исходный ввод вместе с предыдущим результатом и диагностикой.
Как не потерять место при проверке
02
Выберите момент проверки
Автопроверка ждёт 350 мс после ввода. При отключении ожидающие задачи отменяются. В ручном режиме работают кнопка и Ctrl/Cmd + Enter. Изменения сразу блокируют экспорт устаревшего результата.
03
Сравните варианты отступа
Для продолжений по умолчанию используются четыре пробела. Можно выбрать два пробела или табуляцию. Предпросмотр показывает число затронутых строк; новая правка делает его недействительным.
Диагностика в контексте исходного файла
Строки и столбцы
Ошибки и предупреждения считаются отдельно. Ссылка перемещает редактор к нужной позиции. Категории переведены на русский; в раскрываемых подробностях сохранены исходные английские сообщения движка и их коды.
Справка по используемым инструкциям
Посмотрите, чем ARG отличается от ENV и почему EXPOSE не публикует порт. Список строится по текущему файлу. Команды оболочки отображаются как текст, но не анализируются и не выполняются.
Комментарии и heredoc
Сохраняются комментарии, регистр и порядок инструкций. Незавершённый heredoc считается ошибкой. Если аргумент похож на JSON, но не является массивом строк, появляется предупреждение о возможной интерпретации в форме shell.
Границы статической проверки
- Без сборки и аудита безопасности
- Инструмент не выполняет RUN, не читает контекст и не скачивает образы. Он не проверяет наличие файлов, доступность образов, уязвимости и соответствие политикам безопасности.
- Ограниченный набор правил
- Это не замена Hadolint, ShellCheck и всем проверкам BuildKit. Расширения собственного frontend могут не поддерживаться. Комментарий ignore учитывается, но отдельное предупреждение сообщает о подавлении части диагностики.
- Без изменения логики
- Меняются только отступы перед инструкциями, строки из пробелов и отступы продолжений. RUN не объединяется, пакеты не сортируются. COPY --from может ссылаться на внешний образ, поэтому отсутствие имени в списке этапов само по себе не ошибка.
- Один файл с явными пределами
- Допускается 131072 единицы UTF-16 и 2000 физических строк. При превышении обработка останавливается без обрезки. Списки раскрываются по 50 элементов; экспорт содержит весь текущий текст с переводами строк LF.
Форматировщик Dockerfile: частые вопросы
Какие части файла меняются при форматировании?
Движок выравнивает начало инструкций, пустые строки с пробелами и продолжения. Комментарии, регистр и порядок сохраняются. Перед применением сравните предпросмотр, особенно если в файле есть сложные многострочные команды.
Как проверить Dockerfile на соответствие рекомендациям?
Статические замечания здесь охватывают ограниченный набор правил. Для дополнительных рекомендаций используйте проверки Hadolint или BuildKit, принятые в проекте. Отсутствие ошибок на этой странице их не заменяет.
Зачем закреплять тег базового образа?
Изменяемый тег со временем может указывать на другой контент. Конкретная версия или digest помогают воспроизводимости, но не гарантируют безопасность. Этот инструмент не обращается к реестру и не меняет ссылку на образ.
Можно ли сохранить результат в файл Dockerfile?
Да. Если результат актуален и ошибок нет, кнопка скачивания сохраняет весь текст в файл Dockerfile. После изменения ввода или отступа экспорт блокируется до следующей проверки.
Отправляется ли вставленный Dockerfile на сервер?
Текст обрабатывается в браузере и не отправляется сервису форматирования или реестру образов. После перезагрузки страницы локальная история ввода не остаётся. Сохраните нужный результат самостоятельно.
Остался вопрос?
Вернуться к проверке
Форматировщик Dockerfile поможет найти нужную строку или границу этапа. Экспортируйте текущий предпросмотр после проверки изменений.
После статической проверки проверьте реальную сборку в своей среде.