Repolode
Enviar
ktock

ktock/buildg

Depurador interactivo para builds de Dockerfile, con puntos de interrupción, ejecución paso a paso y acceso a una shell en los pasos, basado en BuildKit.

Ver en GitHub
Estrellas
1,503
Forks
40
Issues abiertos
15
Último commit
hace 3 meses

¿Qué es?

buildg es un depurador para builds de Dockerfile. En lugar de volver a ejecutar un build largo y tratar de adivinar dónde falló, puedes establecer puntos de interrupción en las líneas del Dockerfile, avanzar por las instrucciones una a una e inspeccionar el contexto de build y el sistema de archivos en cada paso.

Cuando la ejecución se pausa en un paso, puedes abrir una shell interactiva en el estado de ese paso y ejecutar tus propias herramientas de depuración. También puedes asociar una imagen de depuración personalizada para que la shell incluya herramientas que no están disponibles en la imagen de build. Además, buildg funciona con editores mediante el Debug Adapter Protocol, que permite depurar con puntos de interrupción visuales desde VS Code, Emacs y Neovim.

buildg está basado en BuildKit e incluye algunos parches que aún no se han integrado en el proyecto upstream; también admite la ejecución rootless. La ejecución nativa actualmente se limita a Linux; otras plataformas necesitan una VM de Linux. El proyecto se considera software en fase inicial. También está disponible como subcomando de nerdctl.

Funciones clave

  • 01Establece puntos de interrupción en líneas del Dockerfile o en los pasos que fallan.
  • 02Avanza por las instrucciones del build paso a paso y continúa hasta un punto de interrupción elegido.
  • 03Abre una shell interactiva dentro de un paso del build para inspeccionar su estado.
  • 04Asocia una imagen de depuración personalizada con tus propias herramientas.
  • 05Se integra con editores como VS Code, Emacs y Neovim mediante DAP.
  • 06Admite la ejecución rootless.

Casos de uso

  • Encontrar qué instrucción de un Dockerfile grande y lento hace fallar el build.
  • Inspeccionar archivos y el entorno en un paso intermedio del build.
  • Depurar builds de Dockerfile desde VS Code o Neovim.
  • Investigar el comportamiento de la caché del build examinando builds almacenados en caché de forma remota.

Inicio rápido

  1. 1

    Instala Go 1.23 o una versión posterior y clona el repositorio

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

    Compila el binario con make

    make
  3. 3

    Instala el binario en tu sistema

    sudo make install
  4. 4

    Inicia una sesión de depuración en un contexto de compilación

    buildg debug /path/to/build/context

Antes de usarlo

  • La ejecución nativa solo está disponible en Linux; las demás plataformas requieren una VM de Linux.
  • El proyecto está en una fase inicial y se basa en BuildKit con parches aún no integrados.
  • Para la integración con IDE (DAP), es necesario ejecutarlo en modo rootless.

Temas

#docker#dockerfile#debugger#buildkit#container#devtools#dap

Preguntas frecuentes

¿Qué es buildg?
Depurador interactivo para builds de Dockerfile, con puntos de interrupción, ejecución paso a paso y acceso a una shell en los pasos, basado en BuildKit. buildg es un depurador para builds de Dockerfile. En lugar de volver a ejecutar un build largo y tratar de adivinar dónde falló, puedes establecer puntos de interrupción en las líneas del Dockerfile, avanzar por las instrucciones una a una e inspeccionar el contexto de build y el sistema de archivos en cada paso.
¿buildg es gratuito? ¿Qué licencia tiene?
buildg es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿buildg sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de buildg fue el 30 jul 2026.
¿Para qué puedo usar buildg?
Encontrar qué instrucción de un Dockerfile grande y lento hace fallar el build. Inspeccionar archivos y el entorno en un paso intermedio del build. Depurar builds de Dockerfile desde VS Code o Neovim. Investigar el comportamiento de la caché del build examinando builds almacenados en caché de forma remota.
¿Cómo se instala buildg?
Instala Go 1.23 o una versión posterior y clona el repositorio: git clone https://github.com/ktock/buildg Compila el binario con make: make Instala el binario en tu sistema: sudo make install Inicia una sesión de depuración en un contexto de compilación: buildg debug /path/to/build/context
¿Dónde consigo buildg?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/ktock/buildg

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados