On this page
Playground
With Docker running, create the cluster:
GOWORK=off devbox run -- task playgroundGOWORK=off builds against the published Capsule version in go.mod, without a
local Capsule checkout. The controller runs without Capsule’s APIs or configuration;
the playground installs the addon directly, along with cert-manager for serving
certificates. Its Helm values explicitly select non-tenant namespaces for admission.
The task builds Resource Permits with ko and the current Headlamp plugin. The addon
is installed in resource-permits-system with its own ServiceAccount. Kind
configuration is in playground/kind.config.yaml; installations live under
playground/installation/, including a Flux HelmRelease for Headlamp. The plugin
is stored in a Kubernetes ConfigMap, independently of temporary host files.
Setup finishes after installation. The cluster has no expiry timer and remains
running after the task exits, fails, or is interrupted. Its private kubeconfig is
saved under artifacts/playground/resource-permits-playground/kubeconfig.
Open Headlamp
Start a local port forward separately:
devbox run -- task playground:headlampHeadlamp is available at http://127.0.0.1:18081 and uses normal Kubernetes
authentication. Supply a credential for the identity you want to exercise.
No shared administrator login is created. Ctrl+C stops only the port forward;
run the same command to reconnect later.
Override PLAYGROUND_CLUSTER when creating or accessing a different cluster, and
PLAYGROUND_PORT to change the local port. Existing clusters are preserved;
use dev:deploy with the saved kubeconfig and explicit context to update the
controller. Examples remain opt-in under playground/manifests/.
Delete the playground
Deletion is always explicit:
devbox run -- kind delete cluster --name resource-permits-playground