ktock/buildg

어떤 프로젝트인가요?

핵심 기능

• 01Dockerfile 줄이나 실패한 단계에 브레이크포인트를 설정합니다.
• 02빌드 명령을 단계별로 실행하고 원하는 브레이크포인트까지 진행합니다.
• 03빌드 단계 내부에서 대화형 셸을 열어 상태를 살펴봅니다.
• 04사용자 지정 디버거 이미지를 연결해 원하는 도구를 사용할 수 있습니다.
• 05DAP를 통해 VS Code, Emacs, Neovim 등의 에디터와 연동됩니다.
• 06rootless 실행을 지원합니다.

활용 사례

• 규모가 크고 빌드에 오래 걸리는 Dockerfile에서 어떤 명령이 빌드를 실패시키는지 찾습니다.
• 중간 빌드 단계에서 파일과 환경을 살펴봅니다.
• VS Code나 Neovim에서 Dockerfile 빌드를 디버깅합니다.
• 원격 캐시된 빌드를 살펴보며 빌드 캐시 동작을 조사합니다.

빠른 시작

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 VM이 필요합니다.
• !이 프로젝트는 아직 병합되지 않은 패치를 포함하는 BuildKit 기반의 초기 단계 소프트웨어입니다.
• !IDE(DAP) 연동을 위해서는 rootless 모드로 실행해야 합니다.

토픽

자주 묻는 질문

buildg은(는) 무엇인가요?

BuildKit 기반 Dockerfile 빌드 디버거로, 브레이크포인트 설정, 단계별 실행, 빌드 단계 내부의 셸 접근을 지원합니다. buildg는 Dockerfile 빌드를 위한 디버거입니다. 오래 걸리는 빌드를 처음부터 다시 실행하며 실패 지점을 추측하는 대신, Dockerfile의 줄에 브레이크포인트를 설정하고 명령을 하나씩 실행하면서 각 단계의 빌드 컨텍스트와 파일 시스템을 살펴볼 수 있습니다.

buildg은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

buildg은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

buildg은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. buildg의 마지막 커밋은 2026년 7월 30일입니다.

buildg은(는) 어디에 사용할 수 있나요?

규모가 크고 빌드에 오래 걸리는 Dockerfile에서 어떤 명령이 빌드를 실패시키는지 찾습니다. 중간 빌드 단계에서 파일과 환경을 살펴봅니다. VS Code나 Neovim에서 Dockerfile 빌드를 디버깅합니다. 원격 캐시된 빌드를 살펴보며 빌드 캐시 동작을 조사합니다.

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