v2.0.0-beta.1
Pre-release
Pre-release
·
232 commits
to main
since this release
v2.0.0-beta.1
AkihiroSuda
Akihiro Suda
This tag was signed with the committer’s verified signature.
AkihiroSuda
Akihiro Suda
Changes
nerdctl v2 enables "detach-netns" for Rootless mode by default (#2723).
This will bring:
- Faster and more stable
nerdctl pull,nerdctl push,nerdctl build, etc - Proper support for
nerdctl pull 127.0.0.1:.../... - Proper support for
nerdctl run --net=host
Depends on RootlessKit v2 and BuildKit v0.13 (included in nerdctl-full-*.tar.gz).
Note
After upgrading nerdctl (rootless mode) from v1.x to v2.x, it is highly recommended to
re-install the systemd units and the configurations:
containerd-rootless-setuptool.sh uninstall
rm -rf ~/.config/{nerdctl,buildkit}
containerd-rootless-setuptool.sh install
CONTAINERD_NAMESPACE=default containerd-rootless-setuptool.sh install-buildkit-containerd
Other major changes:
nerdctl run:- Add
--systemdflag for running systemd in containers flag (#2785, thanks to @sazzy4o) - Add
--ipc=(shareable|container:<container>)flag (#2757, thanks to @minuk-dev)
- Add
nerdctl build:
Full changes: https://github.com/containerd/nerdctl/milestone/37?closed=1
Thanks to @fahedouch @manugupt1 @minuk-dev @monirul @roman-kiselenko @sazzy4o @yankay @zwpaper
Compatible containerd versions
This release of nerdctl is expected to be used with containerd v1.6 or v1.7.
About the binaries
- Minimal (
nerdctl-2.0.0-beta.1-linux-amd64.tar.gz): nerdctl only - Full (
nerdctl-full-2.0.0-beta.1-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-2.0.0-beta.1-linux-amd64.tar.gz
-rwxr-xr-x root/root 25071616 2024-02-19 07:16 nerdctl
-rwxr-xr-x root/root 22764 2024-02-19 07:16 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root 8640 2024-02-19 07:16 containerd-rootless.sh
Full
Extract the archive to a path like /usr/local or ~/.local .
tar Cxzvvf /usr/local nerdctl-full-2.0.0-beta.1-linux-amd64.tar.gz
drwxr-xr-x 0/0 0 2024-02-19 07:23 bin/
-rwxr-xr-x 0/0 29671808 2015-10-21 00:00 bin/buildctl
-rwxr-xr-x 0/0 23724032 2022-09-05 09:52 bin/buildg
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-bandwidth -> ../libexec/cni/bandwidth
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-bridge -> ../libexec/cni/bridge
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-dhcp -> ../libexec/cni/dhcp
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-dummy -> ../libexec/cni/dummy
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-firewall -> ../libexec/cni/firewall
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-host-device -> ../libexec/cni/host-device
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-host-local -> ../libexec/cni/host-local
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-ipvlan -> ../libexec/cni/ipvlan
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-loopback -> ../libexec/cni/loopback
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-macvlan -> ../libexec/cni/macvlan
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-portmap -> ../libexec/cni/portmap
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-ptp -> ../libexec/cni/ptp
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-sbr -> ../libexec/cni/sbr
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-static -> ../libexec/cni/static
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-tap -> ../libexec/cni/tap
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-tuning -> ../libexec/cni/tuning
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-vlan -> ../libexec/cni/vlan
lrwxrwxrwx 0/0 0 2024-02-19 07:23 bin/buildkit-cni-vrf -> ../libexec/cni/vrf
-rwxr-xr-x 0/0 57170042 2015-10-21 00:00 bin/buildkitd
-rwxr-xr-x 0/0 7277816 2024-02-19 07:21 bin/bypass4netns
-rwxr-xr-x 0/0 5308416 2024-02-19 07:21 bin/bypass4netnsd
-rwxr-xr-x 0/0 38864536 2024-02-19 07:23 bin/containerd
-rwxr-xr-x 0/0 9474048 2023-11-02 17:34 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0 22764 2024-02-19 07:22 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0 8640 2024-02-19 07:22 bin/containerd-rootless.sh
-rwxr-xr-x 0/0 12066816 2024-02-19 07:23 bin/containerd-shim-runc-v2
-rwxr-xr-x 0/0 45903872 2023-10-31 08:57 bin/containerd-stargz-grpc
-rwxr-xr-x 0/0 20495865 2024-02-19 07:23 bin/ctd-decoder
-rwxr-xr-x 0/0 18763776 2024-02-19 07:22 bin/ctr
-rwxr-xr-x 0/0 29446171 2024-02-19 07:23 bin/ctr-enc
-rwxr-xr-x 0/0 19931136 2023-10-31 08:58 bin/ctr-remote
-rwxr-xr-x 0/0 1785448 2024-02-19 07:23 bin/fuse-overlayfs
-rwxr-xr-x 0/0 65347946 2024-02-19 07:23 bin/ipfs
-rwxr-xr-x 0/0 25042944 2024-02-19 07:22 bin/nerdctl
-rwxr-xr-x 0/0 10128131 2024-02-06 02:44 bin/rootlessctl
-rwxr-xr-x 0/0 11774347 2024-02-06 02:44 bin/rootlesskit
-rwxr-xr-x 0/0 15074072 2024-02-19 07:22 bin/runc
-rwxr-xr-x 0/0 2346328 2024-02-19 07:23 bin/slirp4netns
-rwxr-xr-x 0/0 870496 2024-02-19 07:23 bin/tini
drwxr-xr-x 0/0 0 2024-02-19 07:23 lib/
drwxr-xr-x 0/0 0 2024-02-19 07:23 lib/systemd/
drwxr-xr-x 0/0 0 2024-02-19 07:23 lib/systemd/system/
-rw-r--r-- 0/0 1475 2024-02-19 07:23 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0 1414 2024-02-19 07:21 lib/systemd/system/containerd.service
-rw-r--r-- 0/0 312 2024-02-19 07:23 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0 0 2024-02-19 07:23 libexec/
drwxrwxr-x 0/0 0 2024-02-19 07:23 libexec/cni/
-rwxr-xr-x 0/0 4109351 2023-12-04 16:38 libexec/cni/bandwidth
-rwxr-xr-x 0/0 4652757 2023-12-04 16:39 libexec/cni/bridge
-rwxr-xr-x 0/0 11050013 2023-12-04 16:39 libexec/cni/dhcp
-rwxr-xr-x 0/0 4297556 2023-12-04 16:39 libexec/cni/dummy
-rwxr-xr-x 0/0 4736299 2023-12-04 16:39 libexec/cni/firewall
-rwxr-xr-x 0/0 4191837 2023-12-04 16:39 libexec/cni/host-device
-rwxr-xr-x 0/0 3549866 2023-12-04 16:39 libexec/cni/host-local
-rwxr-xr-x 0/0 4315686 2023-12-04 16:39 libexec/cni/ipvlan
-rwxr-xr-x 0/0 3636792 2023-12-04 16:39 libexec/cni/loopback
-rwxr-xr-x 0/0 4349395 2023-12-04 16:39 libexec/cni/macvlan
-rwxr-xr-x 0/0 4085020 2023-12-04 16:39 libexec/cni/portmap
-rwxr-xr-x 0/0 4470977 2023-12-04 16:39 libexec/cni/ptp
-rwxr-xr-x 0/0 3851218 2023-12-04 16:39 libexec/cni/sbr
-rwxr-xr-x 0/0 3110828 2023-12-04 16:39 libexec/cni/static
-rwxr-xr-x 0/0 4371897 2023-12-04 16:39 libexec/cni/tap
-rwxr-xr-x 0/0 3726382 2023-12-04 16:39 libexec/cni/tuning
-rwxr-xr-x 0/0 4310173 2023-12-04 16:39 libexec/cni/vlan
-rwxr-xr-x 0/0 4001842 2023-12-04 16:39 libexec/cni/vrf
drwxr-xr-x 0/0 0 2024-02-19 07:22 share/
drwxr-xr-x 0/0 0 2024-02-19 07:22 share/doc/
drwxr-xr-x 0/0 0 2024-02-19 07:22 share/doc/nerdctl/
-rw-r--r-- 0/0 12390 2024-02-19 07:16 share/doc/nerdctl/README.md
drwxr-xr-x 0/0 0 2024-02-19 07:16 share/doc/nerdctl/docs/
-rw-r--r-- 0/0 3953 2024-02-19 07:16 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0 2570 2024-02-19 07:16 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0 3749 2024-02-19 07:16 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0 75459 2024-02-19 07:16 share/doc/nerdctl/docs/command-reference.md
-rw-r--r-- 0/0 1814 2024-02-19 07:16 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0 5329 2024-02-19 07:16 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0 9128 2024-02-19 07:16 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0 5660 2024-02-19 07:16 share/doc/nerdctl/docs/cvmfs.md
-rw-r--r-- 0/0 2435 2024-02-19 07:16 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0 906 2024-02-19 07:16 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0 14217 2024-02-19 07:16 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0 884 2024-02-19 07:16 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0 3273 2024-02-19 07:16 share/doc/nerdctl/docs/gpu.md
-rw-r--r-- 0/0 14463 2024-02-19 07:16 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0 1748 2024-02-19 07:16 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0 2960 2024-02-19 07:16 share/doc/nerdctl/docs/notation.md
-rw-r--r-- 0/0 2596 2024-02-19 07:16 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0 3277 2024-02-19 07:16 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0 1876 2024-02-19 07:16 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0 15657 2024-02-19 07:16 share/doc/nerdctl/docs/registry.md
-rw-r--r-- 0/0 7276 2024-02-19 07:16 share/doc/nerdctl/docs/rootless.md
-rw-r--r-- 0/0 2015 2024-02-19 07:16 share/doc/nerdctl/docs/soci.md
-rw-r--r-- 0/0 10312 2024-02-19 07:16 share/doc/nerdctl/docs/stargz.md
drwxr-xr-x 0/0 0 2024-02-19 07:23 share/doc/nerdctl-full/
-rw-r--r-- 0/0 1164 2024-02-19 07:23 share/doc/nerdctl-full/README.md
-rw-r--r-- 0/0 8057 2024-02-19 07:23 share/doc/nerdctl-full/SHA256SUMS
Included components
See share/doc/nerdctl-full/README.md:
# nerdctl (full distribution)
- nerdctl: v2.0.0-beta.1
- containerd: v1.7.13
- runc: v1.1.12
- CNI plugins: v1.4.0
- BuildKit: v0.13.0-rc1
- Stargz Snapshotter: v0.15.1
- imgcrypt: v1.1.9
- RootlessKit: v2.0.1
- slirp4netns: v1.2.3
- bypass4netns: v0.4.0
- fuse-overlayfs: v1.13
- containerd-fuse-overlayfs: v1.0.8
- Kubo (IPFS): v0.26.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.3/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.26.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:alpineRootless
$ containerd-rootless-setuptool.sh install
$ nerdctl run -d --name nginx -p 8080:80 nginx:alpineEnabling 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/7955896798
The sha256sum of the SHA256SUMS file itself is d3df83a2527d08ae8b01e4af3813e0d802c4b160a1eb6e7f7246c2bf1359fcc2 .
Release manager: Akihiro Suda (@AkihiroSuda)
Contributors
manugupt1, monirul, and 7 other contributors