ktock/buildg

Что это?

Ключевые возможности

• 01Ставьте точки останова на строках Dockerfile или на этапах, завершившихся ошибкой.
• 02Выполняйте инструкции сборки пошагово и продолжайте выполнение до выбранной точки останова.
• 03Открывайте интерактивный shell внутри этапа сборки, чтобы проверить его состояние.
• 04Подключайте собственный образ отладчика с нужными инструментами.
• 05Интеграция с редакторами, например VS Code, Emacs и Neovim, через DAP.
• 06Поддерживается запуск без root-прав.

Сценарии использования

• Поиск инструкции в большом и медленно собирающемся Dockerfile, из-за которой сборка завершается ошибкой.
• Проверка файлов и окружения на промежуточном этапе сборки.
• Отладка сборок Dockerfile из VS Code или Neovim.
• Исследование работы кеша сборки с помощью проверки сборок, закешированных удалённо.

Быстрый старт

1. 1

   Установите Go 1.23 или новее и клонируйте репозиторий

   git clone https://github.com/ktock/buildg
2. 2

   Соберите бинарный файл с помощью make

   make
3. 3

   Установите бинарный файл в систему

   sudo make install
4. 4

   Запустите сеанс отладки в контексте сборки

   buildg debug /path/to/build/context

Что важно знать

• !Нативное выполнение поддерживается только в Linux; для других платформ потребуется виртуальная машина с Linux.
• !Проект находится на ранней стадии разработки и основан на BuildKit с ещё не влитыми патчами.
• !Для интеграции с IDE (DAP) требуется запуск в режиме rootless.

Темы

Частые вопросы

Что такое buildg?

Интерактивный отладчик сборок Dockerfile на базе BuildKit: точки останова, пошаговое выполнение и доступ к shell внутри этапов сборки. buildg — отладчик сборок Dockerfile. Вместо того чтобы перезапускать долгую сборку и гадать, на каком этапе произошёл сбой, можно ставить точки останова на строках Dockerfile, выполнять инструкции по одной и проверять контекст сборки и файловую систему на каждом этапе.

buildg можно использовать бесплатно? Какая у него лицензия?

buildg распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.

buildg всё ещё поддерживается?

Обновлялся за последние 6 месяцев. Последний коммит в buildg — 30 июл. 2026 г..

Для чего можно использовать buildg?

Поиск инструкции в большом и медленно собирающемся Dockerfile, из-за которой сборка завершается ошибкой. Проверка файлов и окружения на промежуточном этапе сборки. Отладка сборок Dockerfile из VS Code или Neovim. Исследование работы кеша сборки с помощью проверки сборок, закешированных удалённо.

Как установить buildg?

Установите Go 1.23 или новее и клонируйте репозиторий: git clone https://github.com/ktock/buildg Соберите бинарный файл с помощью make: make Установите бинарный файл в систему: sudo make install Запустите сеанс отладки в контексте сборки: buildg debug /path/to/build/context

Где скачать buildg?

Исходный код и инструкции по установке — на GitHub: https://github.com/ktock/buildg