ktock/buildg

O que é?

Recursos principais

• 01Defina breakpoints em linhas do Dockerfile ou nas etapas que falharem.
• 02Avance pelas instruções do build passo a passo e continue até um breakpoint escolhido.
• 03Abra um shell interativo dentro de uma etapa do build para inspecionar seu estado.
• 04Adicione uma imagem de debugger personalizada com suas próprias ferramentas.
• 05Integra-se a editores como VS Code, Emacs e Neovim por meio do DAP.
• 06Oferece suporte à execução rootless.

Casos de uso

• Descobrir qual instrução em um Dockerfile grande e demorado está interrompendo o build.
• Inspecionar arquivos e o ambiente em uma etapa intermediária do build.
• Depurar builds de Dockerfile diretamente no VS Code ou no Neovim.
• Investigar o comportamento do cache de build examinando builds armazenados remotamente.

Início rápido

1. 1

   Instale o Go 1.23 ou posterior e clone o repositório

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

   Compile o binário com make

   make
3. 3

   Instale o binário no seu sistema

   sudo make install
4. 4

   Inicie uma sessão de depuração em um contexto de build

   buildg debug /path/to/build/context

Antes de usar

• !A execução nativa é compatível apenas com Linux; outras plataformas precisam de uma VM Linux.
• !O projeto ainda está em estágio inicial e é baseado no BuildKit com patches ainda não integrados.
• !Para a integração com IDE (DAP), é necessário executá-lo no modo rootless.

Tópicos

Perguntas frequentes

O que é buildg?

Debugger interativo para builds de Dockerfile, com breakpoints, execução passo a passo e acesso ao shell dentro das etapas, baseado no BuildKit. buildg é um debugger para builds de Dockerfile. Em vez de executar novamente um build demorado e tentar adivinhar onde ocorreu a falha, você pode definir breakpoints em linhas do Dockerfile, avançar pelas instruções uma de cada vez e inspecionar o contexto do build e o sistema de arquivos em cada etapa.

buildg é gratuito? Qual é a licença?

buildg é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

buildg ainda é mantido?

Atualizado nos últimos 6 meses. O último commit de buildg foi em 30 de jul. de 2026.

Para que posso usar buildg?

Descobrir qual instrução em um Dockerfile grande e demorado está interrompendo o build. Inspecionar arquivos e o ambiente em uma etapa intermediária do build. Depurar builds de Dockerfile diretamente no VS Code ou no Neovim. Investigar o comportamento do cache de build examinando builds armazenados remotamente.

Como instalar buildg?

Instale o Go 1.23 ou posterior e clone o repositório: git clone https://github.com/ktock/buildg Compile o binário com make: make Instale o binário no seu sistema: sudo make install Inicie uma sessão de depuração em um contexto de build: buildg debug /path/to/build/context

Onde consigo buildg?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ktock/buildg