Flox containerd Shim Demo Environment w/ Kind

This repository contains the configuration files needed to create a Kind (Kubernetes in Docker) cluster with Flox runtime support. This cluster can be used to quickly try out the Flox shim locally.

Setup Instructions

Start the Demo Environment

The provided Flox environment provides all the tools needed for the demo (colima, kind, just, k9s, kubectl). To start the demo environment, run:

flox activate
just up

This will:

• Start a Colima VM
• Create a Kind cluster named flox-shim with the provided configuration
• Apply the Flox RuntimeClass configuration
• Deploy the sample application
• Forward port 3000 to the deployed application
• Display helpful next steps

The cluster will have:

• 1 control-plane node using ghcr.io/flox/flox-kind:latest
• 1 worker node using ghcr.io/flox/flox-kind:latest

The deployment creates:

• A redis pod running from flox/redis with a corresponding Service
• A pod running quotes-app that writes some initial quotes to the redis at startup, then uses it to serve quotes

Once just up completes, fetch something from the running application by running:

curl localhost:3000/quotes/0

Cluster Management

Using k9s (Recommended)

Launch k9s for an interactive cluster dashboard:

k9s

With k9s you can:

• Navigate pods, deployments, and services with arrow keys
• View logs by pressing l on a selected pod
• Describe resources by pressing d
• Delete resources by pressing ctrl+d

Using kubectl

Check that your deployment is running:

kubectl get pods
kubectl logs deployment/quotes

Cleanup

To remove the Kind cluster:

just down