v1.0.0
v1.0.0
AkihiroSuda
Akihiro Suda
This tag was signed with the committer’s verified signature.
AkihiroSuda
Akihiro Suda
After nearly two years of development, nerdctl finally reached v1.0.0 🤓 .
A huge thanks to more than 80 contributors, 4,600 stargazers, and an uncountable number of users, for making this possible! 🎉
Also, Lima joined the CNCF Sandbox recently to popularize containerd/nerdctl for Mac users 🎉
Lima v0.13.0 will be released very soon with nerdctl v1.0.0.
Changes
-
nerdctl run: -
nerdctl build: -
nerdctl compose:- Add
nerdctl compose versioncommand (#1389, thanks to @yardenshoham)
- Add
-
IPFS:
- Add more examples of Kubernetes (Kind) + IPFS (#1499, thanks to @ktock)
-
nerdctl-full:
- Update imgcrypt (1.1.7), BuildKit (0.10.5), stargz-snapshotter (0.12.1), Kubo (0.16.0) (#1454)
Full changes: https://github.com/containerd/nerdctl/milestone/23?closed=1
Thanks to @Bingmang @alebcay @davidhsingyuchen @fahedouch @iyear @ktock @manugupt1 @ningziwen @sshedi @yardenshoham @yuchanns
Compatible containerd versions
This release of nerdctl is expected to be used with containerd v1.5 or v1.6.
About the binaries
- Minimal (
nerdctl-1.0.0-linux-amd64.tar.gz): nerdctl only - Full (
nerdctl-full-1.0.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.0.0-linux-amd64.tar.gz
-rwxr-xr-x root/root 27639808 2022-10-21 13:11 nerdctl
-rwxr-xr-x root/root 21562 2022-10-21 13:10 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root 7032 2022-10-21 13:10 containerd-rootless.sh
Full
Extract the archive to a path like /usr/local or ~/.local .
tar Cxzvvf /usr/local nerdctl-full-1.0.0-linux-amd64.tar.gz
drwxr-xr-x 0/0 0 2022-10-21 13:28 bin/
-rwxr-xr-x 0/0 25370211 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 39694633 2015-10-21 00:00 bin/buildkitd
-rwxr-xr-x 0/0 3602648 2022-10-21 13:21 bin/bypass4netns
-rwxr-xr-x 0/0 5107712 2022-10-21 13:22 bin/bypass4netnsd
-rwxr-xr-x 0/0 54681048 2022-10-21 13:24 bin/containerd
-rwxr-xr-x 0/0 9752576 2021-11-19 07:44 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0 21562 2022-10-21 13:22 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0 7032 2022-10-21 13:22 bin/containerd-rootless.sh
-rwxr-xr-x 0/0 9764864 2022-10-21 13:25 bin/containerd-shim-runc-v2
-rwxr-xr-x 0/0 59948992 2022-10-14 10:26 bin/containerd-stargz-grpc
-rwxr-xr-x 0/0 20130655 2022-10-21 13:27 bin/ctd-decoder
-rwxr-xr-x 0/0 27913688 2022-10-21 13:24 bin/ctr
-rwxr-xr-x 0/0 28853414 2022-10-21 13:27 bin/ctr-enc
-rwxr-xr-x 0/0 30493408 2022-10-14 10:27 bin/ctr-remote
-rwxr-xr-x 0/0 1778112 2022-10-21 13:28 bin/fuse-overlayfs
-rwxr-xr-x 0/0 81162984 2022-10-04 10:42 bin/ipfs
-rwxr-xr-x 0/0 27607040 2022-10-21 13:22 bin/nerdctl
-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 13785304 2022-10-21 13:22 bin/runc
-rwxr-xr-x 0/0 2338128 2022-10-21 13:27 bin/slirp4netns
-rwxr-xr-x 0/0 870496 2022-10-21 13:28 bin/tini
drwxr-xr-x 0/0 0 2022-10-21 13:27 lib/
drwxr-xr-x 0/0 0 2022-10-21 13:27 lib/systemd/
drwxr-xr-x 0/0 0 2022-10-21 13:27 lib/systemd/system/
-rw-r--r-- 0/0 1331 2022-10-21 13:27 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0 1270 2022-10-21 13:21 lib/systemd/system/containerd.service
-rw-r--r-- 0/0 312 2022-10-21 13:27 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0 0 2022-10-21 13:27 libexec/
drwxrwxr-x 0/0 0 2022-10-21 13:27 libexec/cni/
-rwxr-xr-x 0/0 3780654 2022-03-09 17:08 libexec/cni/bandwidth
-rwxr-xr-x 0/0 4221977 2022-03-09 17:08 libexec/cni/bridge
-rwxr-xr-x 0/0 9742834 2022-03-09 17:08 libexec/cni/dhcp
-rwxr-xr-x 0/0 4345726 2022-03-09 17:08 libexec/cni/firewall
-rwxr-xr-x 0/0 3811793 2022-03-09 17:08 libexec/cni/host-device
-rwxr-xr-x 0/0 3241605 2022-03-09 17:08 libexec/cni/host-local
-rwxr-xr-x 0/0 3922560 2022-03-09 17:08 libexec/cni/ipvlan
-rwxr-xr-x 0/0 3295519 2022-03-09 17:08 libexec/cni/loopback
-rwxr-xr-x 0/0 3959868 2022-03-09 17:08 libexec/cni/macvlan
-rwxr-xr-x 0/0 3679140 2022-03-09 17:08 libexec/cni/portmap
-rwxr-xr-x 0/0 4092460 2022-03-09 17:08 libexec/cni/ptp
-rwxr-xr-x 0/0 3484284 2022-03-09 17:08 libexec/cni/sbr
-rwxr-xr-x 0/0 2818627 2022-03-09 17:08 libexec/cni/static
-rwxr-xr-x 0/0 3379564 2022-03-09 17:08 libexec/cni/tuning
-rwxr-xr-x 0/0 3920827 2022-03-09 17:08 libexec/cni/vlan
-rwxr-xr-x 0/0 3523475 2022-03-09 17:08 libexec/cni/vrf
drwxr-xr-x 0/0 0 2022-10-21 13:22 share/
drwxr-xr-x 0/0 0 2022-10-21 13:22 share/doc/
drwxr-xr-x 0/0 0 2022-10-21 13:22 share/doc/nerdctl/
-rw-r--r-- 0/0 72265 2022-10-21 13:10 share/doc/nerdctl/README.md
drwxr-xr-x 0/0 0 2022-10-21 13:22 share/doc/nerdctl/docs/
-rw-r--r-- 0/0 3953 2022-10-21 13:10 share/doc/nerdctl/docs/build.md
-rw-r--r-- 0/0 2570 2022-10-21 13:10 share/doc/nerdctl/docs/builder-debug.md
-rw-r--r-- 0/0 3996 2022-10-21 13:10 share/doc/nerdctl/docs/cni.md
-rw-r--r-- 0/0 1846 2022-10-21 13:10 share/doc/nerdctl/docs/compose.md
-rw-r--r-- 0/0 3030 2022-10-21 13:10 share/doc/nerdctl/docs/config.md
-rw-r--r-- 0/0 3192 2022-10-21 13:10 share/doc/nerdctl/docs/cosign.md
-rw-r--r-- 0/0 2435 2022-10-21 13:10 share/doc/nerdctl/docs/dir.md
-rw-r--r-- 0/0 598 2022-10-21 13:10 share/doc/nerdctl/docs/experimental.md
-rw-r--r-- 0/0 13802 2022-10-21 13:10 share/doc/nerdctl/docs/faq.md
-rw-r--r-- 0/0 1197 2022-10-21 13:10 share/doc/nerdctl/docs/freebsd.md
-rw-r--r-- 0/0 2439 2022-10-21 13:10 share/doc/nerdctl/docs/gpu.md
-rw-r--r-- 0/0 13268 2022-10-21 13:10 share/doc/nerdctl/docs/ipfs.md
-rw-r--r-- 0/0 1748 2022-10-21 13:10 share/doc/nerdctl/docs/multi-platform.md
-rw-r--r-- 0/0 1509 2022-10-21 13:10 share/doc/nerdctl/docs/nydus.md
-rw-r--r-- 0/0 3277 2022-10-21 13:10 share/doc/nerdctl/docs/ocicrypt.md
-rw-r--r-- 0/0 1308 2022-10-21 13:10 share/doc/nerdctl/docs/overlaybd.md
-rw-r--r-- 0/0 15626 2022-10-21 13:10 share/doc/nerdctl/docs/registry.md
-rw-r--r-- 0/0 5090 2022-10-21 13:10 share/doc/nerdctl/docs/rootless.md
-rw-r--r-- 0/0 4918 2022-10-21 13:10 share/doc/nerdctl/docs/stargz.md
drwxr-xr-x 0/0 0 2022-10-21 13:28 share/doc/nerdctl-full/
-rw-r--r-- 0/0 1149 2022-10-21 13:28 share/doc/nerdctl-full/README.md
-rw-r--r-- 0/0 5816 2022-10-21 13:28 share/doc/nerdctl-full/SHA256SUMS
Included components
See share/doc/nerdctl-full/README.md:
# nerdctl (full distribution)
- nerdctl: v1.0.0
- containerd: v1.6.8
- runc: v1.1.4
- CNI plugins: v1.1.1
- BuildKit: v0.10.5
- Stargz Snapshotter: v0.12.1
- imgcrypt: v1.1.7
- RootlessKit: v1.0.1
- slirp4netns: v1.2.0
- bypass4netns: v0.3.0
- fuse-overlayfs: v1.9
- containerd-fuse-overlayfs: v1.0.4
- Kubo (IPFS): v0.16.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.0/COPYING)
- bin/fuse-overlayfs: [GNU GENERAL PUBLIC LICENSE, Version 3](https://github.com/containers/fuse-overlayfs/blob/v1.9/COPYING)
- bin/ipfs: [Combination of MIT-only license and dual MIT/Apache-2.0 license](https://github.com/ipfs/kubo/blob/v0.16.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/3297686885
The sha256sum of the SHA256SUMS file itself is 925f57dac24d54e35560ad2d41191243ab08b1918713f6737a0be701a19d8614 .
Contributors
manugupt1, alebcay, and 10 other contributors