Skip to content

kindplane

kindplane logo

Build Release Go Version License Crossplane

kindplane is a CLI tool for local development that helps developers quickly spin up Kind (Kubernetes in Docker) clusters pre-configured with Crossplane, cloud providers, and other essential components.

It automates the tedious process of setting up a local Kubernetes development environment with Crossplane for infrastructure management.

Local Development Only

kindplane is designed for local development and testing only. Do not use it to manage production infrastructure.

Features

  • 🚀 One-command bootstrap - Create fully configured Kind clusters with a single command
  • ⚙ Crossplane integration - Automatic installation and configuration of Crossplane
  • 📦 Provider management - Install and manage Crossplane providers (AWS, Azure, GCP, etc.)
  • 📊 Helm chart support - Install any Helm chart with configurable phases
  • 🐳 Local container registry - Built-in registry for faster image development without remote pushes
  • 🛡 Trusted CA certificates - Configure custom CAs for private registries and workloads
  • 🎨 Beautiful CLI - Rich terminal UI with dashboard mode and progress indicators
  • 🔍 Smart diagnostics - Detailed failure diagnostics with pod logs and conditions
  • 💾 GitOps export - Dump cluster resources in GitOps-friendly format
  • 🩺 Pre-flight checks - Verify system requirements with the doctor command
  • 📄 Log streaming - Stream logs from cluster components
  • 🔧 Apply resources - Apply Crossplane compositions without full bootstrap

Quick Start

Get a local Crossplane development environment running in minutes:

# Install kindplane
curl -fsSL https://raw.githubusercontent.com/kanzifucius/kindplane/main/install.sh | bash

# Initialise configuration
kindplane init

# Create and bootstrap the cluster
kindplane up

# Check status
kindplane status

# Delete the cluster
kindplane down --force

kindplane up demo

How It Works

graph LR
    A[kindplane init] --> B[kindplane.yaml]
    B --> C[kindplane up]
    C --> D[Kind Cluster]
    D --> E[Crossplane]
    E --> F[Providers]
    F --> G[Helm Charts]
    G --> H[Compositions]
  1. Initialise - Generate a configuration file with kindplane init
  2. Configure - Customise your cluster, providers, and charts in kindplane.yaml
  3. Bootstrap - Run kindplane up to create and configure everything
  4. Develop - Use your local Crossplane environment for development
  5. Export - Use kindplane dump to export resources for GitOps

Next Steps