tiltdev/ctlptl repository overview

⁠What is ctlptl?

ctlptl (pronounced "coddle poodle") is a CLI for declaratively setting up local Kubernetes clusters.

Inspired by kubectl and ClusterAPI's⁠ clusterctl, you declare your local cluster with YAML and use ctlptl to set it up.

This Docker image helps to set up one-time-use Kubernetes clusters in CI.

⁠How do I use it?

ctlptl supports 4 major commands:

• ctlptl get - see all running clusters
• ctlptl create cluster [product] - create a cluster and make it the current kubectl context
• ctlptl apply -f cluster.yaml - ensure a cluster exists, or create one
• ctlptl delete -f cluster.yaml - delete a cluster and its state

⁠KIND: with a built-in registry

Create:

ctlptl create cluster kind --registry=ctlptl-registry

or ensure exists:

cat <<EOF | ctlptl apply -f -
apiVersion: ctlptl.dev/v1alpha1
kind: Cluster
product: kind
registry: ctlptl-registry
EOF