Changes (since 0.6.1)
New commands:
New flags:
nerdctl run --entrypoint
(#96)nerdctl --insecure-registry run
(#85). This flag disables HTTPS verification and allows falling back to plain HTTP
Other new features:
- Support running ocicrypt images (#94). See
docs/ocicrypt.md
. - Allow running rootless containers without cgroup (#91, #92)
- Implemented Bash autocompletion. Add
source <(nerdctl completion bash)
to~/.bash_profile
to enable. (#98)
Distribution:
- Added "full" distribution (#81). Contains all the dependencies such as containerd, runc, CNI, and BuildKit.
Bug fixes:
About the binaries
- Minimal (
nerdctl-0.7.0-linux-amd64.tar.gz
): nerdctl only - Full (
nerdctl-full-0.7.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-0.7.0-linux-amd64.tar.gz
-rwxr-xr-x root/root 20865024 2021-03-09 10:05 nerdctl
-rwxr-xr-x root/root 12487 2021-03-09 10:04 containerd-rootless-setuptool.sh
-rwxr-xr-x root/root 5838 2021-03-09 10:04 containerd-rootless.sh
Full
Extract the archive to a path like
See
/usr/local
or ~/.local
.
tar Cxzvvf /usr/local nerdctl-full-0.7.0-linux-amd64.tar.gz
drwxr-xr-x 0/0 0 2021-03-09 10:07 bin/
-rwxr-xr-x 0/0 24806586 2015-10-21 00:00 bin/buildctl
-rwxr-xr-x 0/0 36003412 2015-10-21 00:00 bin/buildkitd
-rwxr-xr-x 0/0 48241888 2021-02-26 17:01 bin/containerd
-rwxr-xr-x 0/0 9986048 2021-03-08 08:10 bin/containerd-fuse-overlayfs-grpc
-rwxr-xr-x 0/0 12487 2021-03-09 10:07 bin/containerd-rootless-setuptool.sh
-rwxr-xr-x 0/0 5838 2021-03-09 10:07 bin/containerd-rootless.sh
-rwxr-xr-x 0/0 9314304 2021-02-26 17:01 bin/containerd-shim-runc-v2
-rwxr-xr-x 0/0 32571392 2021-02-12 09:28 bin/containerd-stargz-grpc
-rwxr-xr-x 0/0 21595905 2021-03-09 10:07 bin/ctd-decoder
-rwxr-xr-x 0/0 26731392 2021-02-26 17:01 bin/ctr
-rwxr-xr-x 0/0 30717452 2021-03-09 10:07 bin/ctr-enc
-rwxr-xr-x 0/0 23996296 2021-02-12 09:28 bin/ctr-remote
-rwxr-xr-x 0/0 2462760 2021-03-09 10:07 bin/fuse-overlayfs
-rwxr-xr-x 0/0 20836352 2021-03-09 10:07 bin/nerdctl
-rwxr-xr-x 0/0 9159430 2021-03-02 07:37 bin/rootlessctl
-rwxr-xr-x 0/0 10670829 2021-03-02 07:37 bin/rootlesskit
-rwxr-xr-x 0/0 14753696 2021-03-09 10:07 bin/runc
-rwxr-xr-x 0/0 3621328 2021-03-09 10:07 bin/slirp4netns
drwxr-xr-x 0/0 0 2021-03-09 10:07 lib/
drwxr-xr-x 0/0 0 2021-03-09 10:07 lib/systemd/
drwxr-xr-x 0/0 0 2021-03-09 10:07 lib/systemd/system/
-rw-r--r-- 0/0 1331 2021-03-09 10:07 lib/systemd/system/buildkit.service
-rw-r--r-- 0/0 1270 2021-03-09 10:07 lib/systemd/system/containerd.service
-rw-r--r-- 0/0 300 2021-03-09 10:07 lib/systemd/system/stargz-snapshotter.service
drwxr-xr-x 0/0 0 2021-03-09 10:07 libexec/
drwxrwxr-x 0/0 0 2021-03-09 10:07 libexec/cni/
-rwxr-xr-x 0/0 4151672 2021-02-05 15:42 libexec/cni/bandwidth
-rwxr-xr-x 0/0 4536104 2021-02-05 15:42 libexec/cni/bridge
-rwxr-xr-x 0/0 10270090 2021-02-05 15:42 libexec/cni/dhcp
-rwxr-xr-x 0/0 4767801 2021-02-05 15:42 libexec/cni/firewall
-rwxr-xr-x 0/0 3357992 2021-02-05 15:42 libexec/cni/flannel
-rwxr-xr-x 0/0 4144106 2021-02-05 15:42 libexec/cni/host-device
-rwxr-xr-x 0/0 3565330 2021-02-05 15:42 libexec/cni/host-local
-rwxr-xr-x 0/0 4288339 2021-02-05 15:42 libexec/cni/ipvlan
-rwxr-xr-x 0/0 2387968 2021-01-19 09:17 libexec/cni/isolation
-rwxr-xr-x 0/0 3530531 2021-02-05 15:42 libexec/cni/loopback
-rwxr-xr-x 0/0 4367216 2021-02-05 15:42 libexec/cni/macvlan
-rwxr-xr-x 0/0 3966455 2021-02-05 15:42 libexec/cni/portmap
-rwxr-xr-x 0/0 4467317 2021-02-05 15:42 libexec/cni/ptp
-rwxr-xr-x 0/0 3701138 2021-02-05 15:42 libexec/cni/sbr
-rwxr-xr-x 0/0 3153330 2021-02-05 15:42 libexec/cni/static
-rwxr-xr-x 0/0 3668289 2021-02-05 15:42 libexec/cni/tuning
-rwxr-xr-x 0/0 4287972 2021-02-05 15:42 libexec/cni/vlan
-rwxr-xr-x 0/0 3759977 2021-02-05 15:42 libexec/cni/vrf
drwxr-xr-x 0/0 0 2021-03-09 10:07 share/
drwxr-xr-x 0/0 0 2021-03-09 10:07 share/doc/
drwxr-xr-x 0/0 0 2021-03-09 10:08 share/doc/nerdctl-full/
-rw-r--r-- 0/0 684 2021-03-09 10:07 share/doc/nerdctl-full/README.md
-rw-r--r-- 0/0 3559 2021-03-09 10:08 share/doc/nerdctl-full/SHA256SUMS
Included components
share/doc/nerdctl-full/README.md
:
# nerdctl (full distribution)
- nerdctl: v0.7.0
- containerd: v1.5.0-beta.2
- runc: v1.0.0-rc93
- CNI plugins: v0.9.1
- CNI isolation plugin: v0.0.3
- BuildKit: v0.8.2
- Stargz Snapshotter: v0.4.1
- imgcrypt: v1.1.0
- RootlessKit: v0.14.0-beta.0
- slirp4netns: v1.1.9
- fuse-overlayfs: v1.4.0
- containerd-fuse-overlayfs: v1.0.1
## License
- bin/slirp4netns: [GNU GENERAL PUBLIC LICENSE, Version 2](https://github.com/rootless-containers/slirp4netns/blob/v1.1.9/COPYING)
- bin/fuse-overlayfs: [GNU GENERAL PUBLIC LICENSE, Version 3](https://github.com/containers/fuse-overlayfs/blob/v1.4.0/COPYING)
- 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/635372825
The sha256sum of the SHA256SUMS file itself is f48404bd2e67c77035f4179faa1a84ee4ec6aebd619afbb6cc818bf3b4f6422a
.