The fly stage1 is an alternative stage1 that runs a single-application ACI with only
The motivation of the fly feature is to add the ability to run applications with full privileges on the host but still benefit from the image management and discovery from rkt.
kubelet is one candidate for rkt fly.
In comparison to the default stage1, there is no process manager involved in the stage1. This a visual illustration for the differences in the process tree between the default and the fly stage1:
host OS └─ rkt └─ systemd-nspawn └─ systemd └─ chroot └─ user-app1
host OS └─ rkt └─ chroot └─ user-app1
The rkt application sets up bind mounts for
/sys, and the user-provided volumes.
In addition to the bind mounts, an additional tmpfs mount is done at
After the mounts are set up, rkt
chroots to the application's RootFS and finally executes the application.
The fly stage1 makes use of Linux mount propagation modes. If a volume source path is a mountpoint on the host, this mountpoint is made recursively shared before the host path is mounted on the target path in the container. Hence, changes to the mounts inside the container will be propagated back to the host.
The bind mounts for
/sys are done automatically and are recursive, because their hierarchy contains mounts which also need to be available for the container to function properly.
User-provided volumes are not mounted recursively.
This is a safety measure to prevent system crashes when multiple containers are started that mount
/ into the container.
You can either use
stage1-fly.aci from the official release, or build rkt yourself with the right options:
$ ./autogen.sh && ./configure --with-stage1-flavors=fly && make
For more details about configure parameters, see the configure script parameters documentation.
This will build the rkt binary and the stage1-fly.aci in
Here is a quick example of how to use a container with the official fly stage1:
# rkt run --stage1-name=coreos.com/rkt/stage1-fly:1.21.0 coreos.com/etcd:v2.2.5
If the image is not in the store,
--stage1-name will perform discovery and fetch the image.
By design, the fly stage1 does not provide the same isolaton and security features as the default stage1.
Specifically, the following constraints are not available when using the fly stage1:
When using systemd on the host it is possible to wrap rkt with a systemd unit file to provide additional isolation. For more information please consult the systemd manual.