overlock

Overlock

Simplify Crossplane development and testing with a powerful CLI toolkit.

Overlock handles the complexity of setting up Crossplane environments, making it easy for developers to build, test, and deploy infrastructure-as-code solutions. Get a fully configured Crossplane environment running in minutes, not hours.

Table of Contents

• Features
• Quick Start
• Installation
• Documentation
• Architecture Overview
• Ecosystem Comparison
• Community
• Contributing
• License

Features

• ⚡ Quick Environment Setup - Create fully configured Crossplane environments with a single command
• 🎯 Multi-Engine Support - Works seamlessly with KinD, K3s, K3d, and K3s-Docker Kubernetes distributions
• 🖥️ Multi-Node & Remote Nodes - Add remote Linux machines as worker nodes via SSH to distribute Crossplane workloads across multiple hosts
• 🔋 CPU Limits - Cap CPU usage per container node to keep your machine responsive during complex control plane development
• 📦 Package Management - Install and manage Crossplane configurations, providers, and functions
• 🔄 Live Development - Hot-reload support for local package development
• 🏗️ Registry Integration - Support for both local and remote package registries
• 🔌 Plugin System - Extensible architecture for custom functionality

Quick Start

# Create a new Crossplane environment
overlock environment create my-dev-env

# Install a cloud provider (GCP example)
overlock provider install xpkg.upbound.io/crossplane-contrib/provider-gcp:v0.22.0

# Apply a configuration
overlock configuration apply xpkg.upbound.io/devops-toolkit/dot-application:v3.0.31

# List your environments
overlock environment list

That's it! You now have a fully functional Crossplane environment ready for development.

Installation

Prerequisites

• Docker (required for creating Kubernetes clusters)
• One of: KinD, K3s, or K3d (choose based on your preference)

Install Overlock

Latest version:

curl -sL "https://raw.githubusercontent.com/web-seven/overlock/refs/heads/main/scripts/install.sh" | sh
sudo mv overlock /usr/local/bin/

Specific version:

curl -sL "https://raw.githubusercontent.com/web-seven/overlock/refs/heads/main/scripts/install.sh" | sh -s -- -v 0.11.0-beta.11
sudo mv overlock /usr/local/bin/

Verify installation:

overlock --version

Building from Source

git clone https://github.com/web-seven/overlock.git
cd overlock
go build -o overlock ./cmd/overlock

See the Development Guide for detailed build instructions.

Documentation

User Guides

• Feature Overview - Multi-node environments, CPU limits, and more
• Command Reference - Complete CLI command documentation
• Configuration Guide - Environment variables and configuration options
• Usage Examples - Common workflows and practical examples
• Troubleshooting - Solutions to common issues

Developer Resources

• Development Guide - Building from source, testing, and contributing
• CONTRIBUTING.md - Contribution guidelines and code of conduct

Command Overview

Overlock organizes functionality into intuitive command groups:

Use overlock <command> --help for detailed information on any command.

Architecture Overview

Overlock is built with a modular architecture designed for extensibility and maintainability:

┌─────────────────────────────────────────────────────┐
│                  Overlock CLI                       │
├─────────────────────────────────────────────────────┤
│  Environment Manager  │  Package Manager            │
│  - KinD               │  - Configurations           │
│  - K3s / K3d          │  - Providers                │
│  - K3s-Docker         │  - Functions                │
├─────────────────────────────────────────────────────┤
│  Engine Manager       │  Registry Manager           │
│  - Crossplane Install │  - Local Registries         │
│  - Helm Integration   │  - Remote Registries        │
├─────────────────────────────────────────────────────┤
│  Resource Manager     │  Plugin System              │
│  - Custom Resources   │  - Dynamic Loading          │
│  - YAML Processing    │  - Extensibility            │
└─────────────────────────────────────────────────────┘
                          │
                          ▼
        ┌─────────────────────────────────────┐
        │         Kubernetes Cluster          │
        │  (KinD / K3s / K3d / K3s-Docker)    │
        │         + Crossplane                │
        └─────────────────────────────────────┘

Key Components

• CLI Framework: Kong-based command parsing with intuitive subcommands
• Engine Management: Helm-based Crossplane installation and lifecycle
• Environment Management: Multi-engine Kubernetes cluster operations
• Package Management: Crossplane configurations, providers, and functions
• Plugin System: Extensible architecture for custom functionality

For detailed architecture information, see the Development Guide.

Ecosystem Comparison

Why Overlock?

Overlock bridges the gap between simple kubectl/helm workflows and full-featured cloud platforms. It provides:

• Faster setup than manual kubectl/helm configurations
• More development-focused features than standard Crossplane CLI
• Better local development experience than cloud-based solutions
• Complete control over your development environment

Community

Get Help & Connect

• 💬 Discord: Join our Discord for questions and community support
• 🐛 Issues: Report bugs or request features
• 📖 Discussions: Join discussions

Contributing

We welcome contributions from the community! Whether you're fixing bugs, adding features, or improving documentation, your help is appreciated.

• Read our Contributing Guide to get started
• Check out Good First Issues
• Review the Development Guide for technical details

Code of Conduct

We are committed to providing a welcoming and inclusive experience. Please read our Code of Conduct in CONTRIBUTING.md.

Credits

Overlock is built on top of excellent open-source projects:

• Crossplane - The cloud native control plane framework
• Kubernetes - Container orchestration platform
• Helm - The Kubernetes package manager
• KinD, K3s, K3d - Kubernetes engines

License

This project is licensed under the MIT License. See the LICENSE file for details.

Made with ❤️ by the Overlock community