v0.4.1

Change

• Remove .m suffix from release binary (#81)

Refer to v0.4.0 release note for other notable changes of v0.4.

About the binaries

• Minimal(e.g. buildg-v0.4.1-linux-amd64.tar.gz): contains only buildg binary
• Full(e.g. buildg-full-v0.4.1-linux-amd64.tar.gz): contains buildg and its dependencies

Minimal

Extract it to a path like /usr/local/bin/ or ~/bin/

list of files

-rwxr-xr-x root/root  23724032 2022-09-05 09:52 buildg

Full

Extract it to a path like /usr/local/ or ~/.local

list of files

drwxr-xr-x 0/0               0 2022-09-05 09:55 bin/
-rwxr-xr-x 0/0        23916544 2022-09-05 09:54 bin/buildg
-rwxr-xr-x 0/0         9443526 2022-05-02 08:24 bin/rootlessctl
-rwxr-xr-x 0/0        10879193 2022-05-02 08:24 bin/rootlesskit
-rwxr-xr-x 0/0        13733640 2022-09-05 09:55 bin/runc
-rwxr-xr-x 0/0         2338128 2022-09-05 09:55 bin/slirp4netns
drwxr-xr-x 0/0               0 2022-09-05 09:55 share/
drwxr-xr-x 0/0               0 2022-09-05 09:55 share/doc/
drwxr-xr-x 0/0               0 2022-09-05 09:55 share/doc/buildg-full/
-rw-r--r-- 0/0             329 2022-09-05 09:55 share/doc/buildg-full/README.md
-rw-r--r-- 0/0             508 2022-09-05 09:55 share/doc/buildg-full/SHA256SUMS

---

The sha256sum of SHA256SUM is b2a291eb3686cec66fdf5cc830ecbb08f56c3f23f164cd3e2b751cfce7135622

v0.4.0

Notable Changes

Rootless without shellscript(buildg.sh) (#72)

Now buildg can run in rootless mode without shellscript(buildg.sh).

$ buildg debug /path/to/context

Buildg still depends on RootlessKit and slirp4netns on your host.

DAP configurations (examples/dap/nvim/plugins.lua and examples/dap/emacs/dap-dockerfile.el) have also been updated not to use buildg.sh but directly use buildg command.

Release full binary tarball (#76)

For easier installation of buildg, our release artifact starts containing binary dependencies (runc, rootlesskit and slirp4netns) in a single tar (discussed later).

Containerized buildg (#47, #59), thanks to @developer-guy

This release start to distribute containerized buildg on ghcr.io/ktock/buildg.

$ docker run --rm -it --privileged -v /path/to/ctx:/ctx:ro ghcr.io/ktock/buildg:0.4.0 debug /ctx

You can also build this container image on the buildg repo.

$ docker build -t buildg .
$ docker run --rm -it --privileged -v /path/to/ctx:/ctx:ro buildg debug /ctx

Other notable changes

• Allow launching shell on an arbitrary instruction (#54)
• Enable cache reuse feature by default (#62)
• Add reload command to reload and restart Dockerfile (#74)
• Add log command to show buildg logs (#71)
• Allow to specify the target breakpoint on continue (#75)
• Add --version flag (#73)
• Statically link buildg binary (#57)
• DAP: update documents and example configurations of IDEs(#43, #48, #50, #80)

About the binaries

• Minimal(e.g. buildg-v0.4.0-linux-amd64.tar.gz): contains only buildg binary
• Full(e.g. buildg-full-v0.4.0-linux-amd64.tar.gz): contains buildg and its dependencies

Minimal

Extract it to a path like /usr/local/bin/ or ~/bin/

list of files

-rwxr-xr-x root/root  23724032 2022-09-05 08:53 buildg

Full

Extract it to a path like /usr/local/ or ~/.local

list of files

drwxr-xr-x 0/0               0 2022-09-05 08:56 bin/
-rwxr-xr-x 0/0        23916544 2022-09-05 08:56 bin/buildg
-rwxr-xr-x 0/0         9443526 2022-05-02 08:24 bin/rootlessctl
-rwxr-xr-x 0/0        10879193 2022-05-02 08:24 bin/rootlesskit
-rwxr-xr-x 0/0        13733640 2022-09-05 08:56 bin/runc
-rwxr-xr-x 0/0         2338128 2022-09-05 08:56 bin/slirp4netns
drwxr-xr-x 0/0               0 2022-09-05 08:56 share/
drwxr-xr-x 0/0               0 2022-09-05 08:56 share/doc/
drwxr-xr-x 0/0               0 2022-09-05 08:56 share/doc/buildg-full/
-rw-r--r-- 0/0             329 2022-09-05 08:56 share/doc/buildg-full/README.md
-rw-r--r-- 0/0             508 2022-09-05 08:56 share/doc/buildg-full/SHA256SUMS

---

The sha256sum of SHA256SUM is 9a6ba435ab420e0b19b1e242f8bf8eb835a8cb1f631deb7bf0a9e10671d42637

v0.3.0

This release contains initial support for DAP (Debug Adapter Protocol). This allows visual and interactive debugging of Dockerfiles on IDEs supporting DAP (e.g. VS Code, Emacs, Neovim).

See ./examples/dap for details.

Notable Changes

• Initial support of DAP (Debug Adapter Protocol) (#42)
• Support importing external cache. One of the use-cases is to inspect the remotely cached build emitted from the remotely performed build (e.g. on Kubernetes). See docs/cache-from.md for details and the example. (#36)
• Support overlayfs snapshotter (#38)
• Fix panic bugs (#40, #41)

v0.2.0

Now instructions cached by --cache-reuse experimental flag supports breakpoints. You can use this flag to reuse cached instructions and make 2nd-time debugging faster.

Notable Changes

• Allow breakpoints on cached instructions (#33)
• Added prune and du subcommands (#34)
• Move worker flags (--rootless, --oci-*) to global (#34)
• added --env and --workdir flags to exec command (#29)
• docs(README): fix typo (#7), thanks to @developer-guy
• decrease error verbosity (#27), thanks to @fahedouch

v0.1.1

Notable Changes

• Allow buildg reusing cached build results among invocation (#24)
• ls: Allow specifying the range of lines to print (#25)
• docs: Add doc about that nerdctl provides buildg as a subcommand (#26)

v0.1.0

Notable Changes

• The debug session now supports shell-styled quoting and escaping (#16)
• Added support for mount=type=ssh|secret (#17)
• Now supports breakpoints on any instructions (exec is allowed only on RUN as of now) (#21)
• UI improvement (#19, #20, #23)

v0.0.3

Notable Changes

• Improved command reference to README (#14)
• Introduced structured command parser (#13, #15)
• CI: Added tests (#13)

v0.0.2

Notable Changes

• Added arm64 binary release
• Fixed clear to take breakpoint key as the arg instead of line number (#6)
• Added on-fail breakpoint to make debugging of failed step easy (#9)
• Fixed command to correctly exit when reached EOF (#12)

v0.0.1

The first release of buildg.