starlight

README

Starlight: Fast Container Provisioning

Starlight is an accelerator for provisioning container-based applications. It speeds up deploying and updating containers on workers inside and outside the cloud, while maintaining backwards compatibility with existing tools. It is so fast that containers can start faster than merely downloading an optimized data package, yet with practically no overhead.

The image on the right compares time to download and start containers using containerd ("baseline"), eStargz, Starlight, and the time it takes to download an optimized update package using wget. The registry is in North Virginia. Top row shows time to deploy a container to an empty worker, and bottom row time to update the container to a later version. Read our NSDI 2022 paper for more results.

Extend cloud practices to the edge and WAN

Using containers to provision workers in high-latency or low-bandwidth environments can be tricky. The time it takes to deploy software and start a container increases dramatically with latency, and increases at a higher rate than the equivalent time to simply download the data. Outside the datacenter, where round-trip times are in the order of tens or hundreds of milliseconds, container provisioning can be several times slower than in the cloud, even when the network has reasonable bandwidth.

Why is container provisiong slow?

The root cause for this slow provisioning time is the overall design of the provisioning pipeline: it is pull-based, designed around the stack-of-layers abstraction container images, and does not explicitly consider container updates. For example, updating a Java application to fix the Log4j vulnerability usually requires re-downloading the entire container image, even though the updated Log4j library only takes a fraction of that space. This can make provisioning slower than it should be even inside cloud data centers.

How do we address this?

Starlight decouples the mechanism of container provisioning from container development. Starlight maintains the convenient stack-of-layers structure of container images, but uses a different representation when deploying them over the network. The development and operational pipelines remain unchanged.
See how Starlight works ➡️ or read our NSDI 2022 paper.

Architecture

Starlight is implemented on top of containerd. It is comprised of cloud and worker components.

• A proxy server on the cloud side mediates between Starlight workers and any standard registry server.
• On the worker side, a command line tool tells Starlight to PULL containers.
• A Starlight daemon (snapshotter plugin) runs belongs the containerd of each worker node.

Getting Started

Starlight is compatible with Kubernetes and can replace the default overlayfs snapshotter. We could use helm to deploy Starlight on a Kubernetes cluster.

• I am familiar with K8s & Helm. TL;DR
• I have 2 Virtual Machines, but TL;DR

---

Suppose you have a container on a OCI compatible registry that you want to deploy. You need to:

1. Set up a Starlight proxy, ideally close to the registry server you are using. Configure the proxy server to point to the registry and run it. Starlight supports any standard registry. (It can be deployed to k8s using Helm)
   Find out how to install Starlight proxy ➡️

2. Set up the worker to be able to run Starlight. This involves installing containerd and the Starlight snapshotter plugin, configuring containerd to use the plugin, and starting the Starlight snapshotter daemon (you also need to tell the snapshotter the address of the proxy server).
   Find out how to install containerd & Starlight snapshotter plugin ➡️

3. Convert the container image to the Starlight format container image. More specifically, the storage format of the compressed layers needs to be converted to the Starlight format and then the layers stored in the registry. The Starlight format is backwards compatible and almost the same size, so there is no need to store compressed layers twice. In other words, non-Starlight workers will descrompress Starlight images with no chanages. The Starlight CLI tool features the image conversion, example:

    ctr-starlight convert --notify \
      --platform=linux/amd64 \
      docker.io/library/redis:6.2.7 harbor.yuri.moe/x/redis:6.2.7
   

   In addition, the proxy needs some metadata about the list of files in the container to compute the data for deployment. The --nofity flag tells the proxy to fetch the metadata from the registry and store it in the metadata database.

4. Collect traces on the worker for container startup. This entails starting the container on the worker while collecting file access traces that are sent to the proxy.

   The Starlight CLI tool features trace collection, example:

   sudo ctr-starlight optimizer on
   sudo ctr-starlight pull harbor.yuri.moe/x/redis:6.2.7 && \
   mkdir /tmp/redis-data && \
   sudo ctr c create --snapshotter=starlight \
        --mount type=bind,src=/tmp/redis-data,dst=/data,options=rbind:rw \
        --env-file ./demo/config/all.env --network=host \
        harbor.yuri.moe/x/redis:6.2.7
        instance1 && \
   sudo ctr t start instance1
   

   You may terminate the container using Ctrl-C and turn off the optimizer using

   sudo ctr-starlight optimizer off
   

   We could repeat this process several times, then can report all the traces to the proxy, using:

   sudo ctr-starlight report
   

5. Reset containerd and starlight. Clean up all the downloaded containers and cache.

   sudo ./demo/reset.sh
   

🙌 That's it! You can now deploy the container to as many Starlight workers as you want, and it should be fast!

Note step 2 must be done on each worker, and steps 3 and 4 must be done for every container image you want to deploy using Starlight. The good news is that they should be quick, a few minutes for each container.

Deploying containers

Start a container using Starlight

sudo ctr-starlight pull harbor.yuri.moe/starlight/redis:6.2.7 && \
mkdir /tmp/test-redis-data && \
sudo ctr c create \
    --snapshotter=starlight \
    --mount type=bind,src=/tmp/test-redis-data,dst=/data,options=rbind:rw \
    --env-file ./demo/config/all.env \
    --net-host \
    harbor.yuri.moe/x/redis:6.2.7 \
    instance3 && \
sudo ctr t start instance3

Update a container using Starlight (Step 3 and Step 4 need to be done for redis:7.0.5)

sudo ctr-starlight pull harbor.yuri.moe/starlight/redis:7.0.5 && \
sudo ctr c create \
    --snapshotter=starlight  \
    --mount type=bind,src=/tmp/test-redis-data,dst=/data,options=rbind:rw \
    --env-file ./demo/config/all.env \
    --net-host \
    harbor.yuri.moe/x/redis:7.0.5 \
    instance4 && \
sudo ctr t start instance4

For more information, please check out ctr-starlight --help and starlight-daemon --help

Citation

If you find Starlight useful in your work, please cite our NSDI 2022 paper:

@inproceedings {chen2022starlight,
    author = {Jun Lin Chen and Daniyal Liaqat and Moshe Gabel and Eyal de Lara},
    title = {Starlight: Fast Container Provisioning on the Edge and over the {WAN}},
    booktitle = {19th USENIX Symposium on Networked Systems Design and Implementation (NSDI 22)},
    year = {2022},
    address = {Renton, WA},
    url = {https://www.usenix.org/conference/nsdi22/presentation/chen-jun-lin},
    publisher = {USENIX Association},
    month = apr,
}

Roadmap

Starlight is not complete. Our roadmap:

Version	Status	Release Date
v0.1.3		2022-10-12
v0.2.7		2022-11-27
v0.3.2		2023-01-27
v0.4.7	stable	2023-06-05
v0.5.x	in progress

Feature List:

• Scalable database backend (v0.2)
  • Postgres Database Schema (v0.2)
  • Starlight Proxy Server (v0.2)
• Kubernetes support (v0.3)
  • Starlight Proxy (v0.2)
    • Helm Chart (v0.2)
    • Starlight Proxy authentication (v0.2)
  • New Starlight Snapshotter / Content Plugin for containerd (v0.2)
  • initContainer tool (v0.3)
• OCI container registry support (v0.5)
  • Goharbor support (v0.2)
  • Multiple platforms image support (v0.2)
  • Jointly optimizing multiple containers deployments (v0.4)
• Argo CI/CD support (v0.6)
  • Hook/ Scanner for automatic image conversion (v0.5)
  • Converting containers that have already been fully retrieved using Starlight to use OverlayFS. (v0.5)
• Starlight new features (v0.6)
  • Resume interrupted pull connection (v0.5)
  • Garbage Collection (v0.5)