Skip to content

v1.6.0

Compare
Choose a tag to compare
@github-actions github-actions released this 19 Sep 08:27
· 1453 commits to main since this release
v1.6.0
5f39d76

This release improves compatibility with Docker 23, adds the support for pushing SOCI images, and allows running Linux containers on FreeBSD.

Changes

  • nerdctl push:

  • nerdctl compose:

    • Implement nerdctl compose cp. (#2499, #2513, thanks to @yankay)
    • Implement nerdctl compose exec -T (#2507)
    • Silence warning build.config should be relative path (#2510)
  • nerdctl attach:

  • nerdctl volume create:

    • Support creating anonymous volumes (#2433, thanks to @yankay)
  • nerdctl version:

    • Fulfill the version field from debug/buildinfo to support go install (#2444)
    • Skip inspecting rootless daemon if the daemon is not running (2514)
  • Misc:

  • nerdctl-full:

    • Update runc (1.1.9), containerd (1.7.6), BuildKit (0.12.2), imgcrypt (1.1.8), RootlessKit (1.1.1), slirp4netns (1.2.1), Kubo (0.22.0) (#2435, #2497, #2515)
  • Project:

Full changes: https://github.com/containerd/nerdctl/milestone/29?closed=1
Thanks to 
@akhramov@austinvazquez @davidhsingyuchen @fahedouch @gabriel-samfira @metux @ningziwen @testwill @vsiravar @webwurst @yankay

Compatible containerd versions

This release of nerdctl is expected to be used with containerd v1.6 or v1.7.

About the binaries

  • Minimal (nerdctl-1.6.0-linux-amd64.tar.gz): nerdctl only
  • Full (nerdctl-full-1.6.0-linux-amd64.tar.gz): Includes dependencies such as containerd, runc, and CNI

Minimal

Extract the archive to a path like /usr/local/bin or ~/bin .

tar Cxzvvf /usr/local/bin nerdctl-1.6.0-linux-amd64.tar.gz

-rwxr-xr-x root/root  24567808 2023-09-19 06:48 nerdctl
-rwxr-xr-x root/root     21618 2023-09-19 06:47 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root      7187 2023-09-19 06:47 containerd-rootless.sh

Full

Extract the archive to a path like /usr/local or ~/.local .

tar Cxzvvf /usr/local nerdctl-full-1.6.0-linux-amd64.tar.gz

drwxr-xr-x 0/0               0 2023-09-19 06:59 bin/
-rwxr-xr-x 0/0        27623705 2015-10-21 00:00 bin/buildctl
-rwxr-xr-x 0/0        23724032 2022-09-05 09:52 bin/buildg
-rwxr-xr-x 0/0        53353409 2015-10-21 00:00 bin/buildkitd
-rwxr-xr-x 0/0         3788344 2023-09-19 06:55 bin/bypass4netns
-rwxr-xr-x 0/0         5283840 2023-09-19 06:55 bin/bypass4netnsd
-rwxr-xr-x 0/0        57355480 2023-09-19 06:57 bin/containerd
-rwxr-xr-x 0/0        10432512 2023-05-11 08:23 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0           21618 2023-09-19 06:57 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0            7187 2023-09-19 06:57 bin/containerd-rootless.sh
-rwxr-xr-x 0/0        12275712 2023-09-19 06:58 bin/containerd-shim-runc-v2
-rwxr-xr-x 0/0        59637768 2023-03-08 10:08 bin/containerd-stargz-grpc
-rwxr-xr-x 0/0        20394184 2023-09-19 06:59 bin/ctd-decoder
-rwxr-xr-x 0/0        28830976 2023-09-19 06:57 bin/ctr
-rwxr-xr-x 0/0        29366269 2023-09-19 06:59 bin/ctr-enc
-rwxr-xr-x 0/0        26664136 2023-03-08 10:08 bin/ctr-remote
-rwxr-xr-x 0/0         1785448 2023-09-19 06:59 bin/fuse-overlayfs
-rwxr-xr-x 0/0        83555368 2023-08-08 18:07 bin/ipfs
-rwxr-xr-x 0/0        24539136 2023-09-19 06:57 bin/nerdctl
-rwxr-xr-x 0/0        10113536 2023-05-30 06:31 bin/rootlessctl
-rwxr-xr-x 0/0        11600435 2023-05-30 06:31 bin/rootlesskit
-rwxr-xr-x 0/0        15038440 2023-09-19 06:56 bin/runc
-rwxr-xr-x 0/0         2346328 2023-09-19 06:59 bin/slirp4netns
-rwxr-xr-x 0/0          870496 2023-09-19 06:59 bin/tini
drwxr-xr-x 0/0               0 2023-09-19 06:58 lib/
drwxr-xr-x 0/0               0 2023-09-19 06:58 lib/systemd/
drwxr-xr-x 0/0               0 2023-09-19 06:58 lib/systemd/system/
-rw-r--r-- 0/0            1475 2023-09-19 06:58 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0            1414 2023-09-19 06:55 lib/systemd/system/containerd.service
-rw-r--r-- 0/0             312 2023-09-19 06:58 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0               0 2023-09-19 06:58 libexec/
drwxrwxr-x 0/0               0 2023-09-19 06:58 libexec/cni/
-rwxr-xr-x 0/0         4016001 2023-05-09 19:53 libexec/cni/bandwidth
-rwxr-xr-x 0/0         4531309 2023-05-09 19:53 libexec/cni/bridge
-rwxr-xr-x 0/0        10816051 2023-05-09 19:53 libexec/cni/dhcp
-rwxr-xr-x 0/0         4171248 2023-05-09 19:53 libexec/cni/dummy
-rwxr-xr-x 0/0         4649749 2023-05-09 19:53 libexec/cni/firewall
-rwxr-xr-x 0/0         4059321 2023-05-09 19:53 libexec/cni/host-device
-rwxr-xr-x 0/0         3444776 2023-05-09 19:53 libexec/cni/host-local
-rwxr-xr-x 0/0         4193323 2023-05-09 19:53 libexec/cni/ipvlan
-rwxr-xr-x 0/0         3514598 2023-05-09 19:53 libexec/cni/loopback
-rwxr-xr-x 0/0         4227193 2023-05-09 19:53 libexec/cni/macvlan
-rwxr-xr-x 0/0         3955775 2023-05-09 19:53 libexec/cni/portmap
-rwxr-xr-x 0/0         4348835 2023-05-09 19:53 libexec/cni/ptp
-rwxr-xr-x 0/0         3716095 2023-05-09 19:53 libexec/cni/sbr
-rwxr-xr-x 0/0         2984504 2023-05-09 19:53 libexec/cni/static
-rwxr-xr-x 0/0         4258344 2023-05-09 19:53 libexec/cni/tap
-rwxr-xr-x 0/0         3603365 2023-05-09 19:53 libexec/cni/tuning
-rwxr-xr-x 0/0         4187498 2023-05-09 19:53 libexec/cni/vlan
-rwxr-xr-x 0/0         3754911 2023-05-09 19:53 libexec/cni/vrf
drwxr-xr-x 0/0               0 2023-09-19 06:57 share/
drwxr-xr-x 0/0               0 2023-09-19 06:57 share/doc/
drwxr-xr-x 0/0               0 2023-09-19 06:57 share/doc/nerdctl/
-rw-r--r-- 0/0           12386 2023-09-19 06:47 share/doc/nerdctl/README.md
drwxr-xr-x 0/0               0 2023-09-19 06:47 share/doc/nerdctl/docs/
-rw-r--r-- 0/0            3953 2023-09-19 06:47 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0            2570 2023-09-19 06:47 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0            3996 2023-09-19 06:47 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0           72895 2023-09-19 06:47 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0            1846 2023-09-19 06:47 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0            5329 2023-09-19 06:47 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0            9128 2023-09-19 06:47 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0            2435 2023-09-19 06:47 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0             906 2023-09-19 06:47 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0           14217 2023-09-19 06:47 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0             884 2023-09-19 06:47 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0            2439 2023-09-19 06:47 share/doc/nerdctl/docs/gpu.md
-rw-r--r-- 0/0           14463 2023-09-19 06:47 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0            1748 2023-09-19 06:47 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0            2936 2023-09-19 06:47 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0            2596 2023-09-19 06:47 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0            3277 2023-09-19 06:47 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0            1876 2023-09-19 06:47 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0           15657 2023-09-19 06:47 share/doc/nerdctl/docs/registry.md
-rw-r--r-- 0/0            5088 2023-09-19 06:47 share/doc/nerdctl/docs/rootless.md
-rw-r--r-- 0/0            2003 2023-09-19 06:47 share/doc/nerdctl/docs/soci.md
-rw-r--r-- 0/0           10312 2023-09-19 06:47 share/doc/nerdctl/docs/stargz.md
drwxr-xr-x 0/0               0 2023-09-19 06:59 share/doc/nerdctl-full/
-rw-r--r-- 0/0            1151 2023-09-19 06:59 share/doc/nerdctl-full/README.md
-rw-r--r-- 0/0            6300 2023-09-19 06:59 share/doc/nerdctl-full/SHA256SUMS

Included components

See share/doc/nerdctl-full/README.md:

# nerdctl (full distribution)
- nerdctl: v1.6.0
- containerd: v1.7.6
- runc: v1.1.9
- CNI plugins: v1.3.0
- BuildKit: v0.12.2
- Stargz Snapshotter: v0.14.3
- imgcrypt: v1.1.8
- RootlessKit: v1.1.1
- slirp4netns: v1.2.1
- bypass4netns: v0.3.0
- fuse-overlayfs: v1.13
- containerd-fuse-overlayfs: v1.0.6
- Kubo (IPFS): v0.22.0
- Tini: v0.19.0
- buildg: v0.4.1

## License
- bin/slirp4netns:    [GNU GENERAL PUBLIC LICENSE, Version 2](https://github.com/rootless-containers/slirp4netns/blob/v1.2.1/COPYING)
- bin/fuse-overlayfs: [GNU GENERAL PUBLIC LICENSE, Version 2](https://github.com/containers/fuse-overlayfs/blob/v1.13/COPYING)
- bin/ipfs: [Combination of MIT-only license and dual MIT/Apache-2.0 license](https://github.com/ipfs/kubo/blob/v0.22.0/LICENSE)
- bin/{runc,bypass4netns,bypass4netnsd}: Apache License 2.0, statically linked with libseccomp ([LGPL 2.1](https://github.com/seccomp/libseccomp/blob/main/LICENSE), source code available at https://github.com/seccomp/libseccomp/)
- bin/tini: [MIT License](https://github.com/krallin/tini/blob/v0.19.0/LICENSE)
- Other files: [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0)

Quick start

Rootful

$ sudo systemctl enable --now containerd
$ sudo nerdctl run -d --name nginx -p 80:80 nginx:alpine

Rootless

$ containerd-rootless-setuptool.sh install
$ nerdctl run -d --name nginx -p 8080:80 nginx:alpine

Enabling cgroup v2 is highly recommended for rootless mode, see https://rootlesscontaine.rs/getting-started/common/cgroup2/ .


The binaries were built automatically on GitHub Actions.
The build log is available for 90 days: https://github.com/containerd/nerdctl/actions/runs/6232118186

The sha256sum of the SHA256SUMS file itself is 86ae32752c992de4b32161f1ea28962b3010b3757a30732f437c98f72a92fe62 .


Release manager: Akihiro Suda (@AkihiroSuda)