K
k3d-io/k3d
K3d
k3d is a containerized Kubernetes orchestrator and wrapper that manages the lifecycle of k3s nodes and servers within container runtimes. It serves as a tool for deploying and destroying multi-node Kubernetes environments on a single machine for local development and testing.
The project distinguishes itself by wrapping k3s to provide integrated networking, resource limit control, and local registry orchestration. It enables multi-node cluster simulation by wrapping nodes as isolated containers and using host-entry injection and port proxying to route host TCP and UDP traffic into the cluster.
Broad capabilities include node lifecycle management, kubeconfig access and context switching, and container image importing. The tool also supports schema-validated infrastructure configuration and can be used for integration tests within automated CI pipelines.
The system integrates with container engines via SSH and API contexts to manage the cluster node containers.
Features
- Container-Based Node Emulation - Simulates a multi-node Kubernetes cluster by wrapping each node as an isolated container on a single host.
- Local Kubernetes Clusters - Provides tools for provisioning and managing lightweight Kubernetes clusters in containers for local development and testing.
- Containerized Clusters - Deploys complete Kubernetes clusters within container runtimes for local development and CI use.
- Docker Container Orchestrators - Interfaces with container engines via SSH and API contexts to orchestrate the lifecycle of cluster node containers.
- Containerized Cluster Wrappers - Wraps k3s to provide integrated networking, registry orchestration, and resource limits specifically within Docker.
- Multi-Node Topology Emulation - Emulates multi-node cluster topologies and high availability configurations on a single host using containers.
- Local Cluster Lifecycle Management - Manages the complete lifecycle of k3s nodes and servers running within container runtimes.
- Kubernetes Node Lifecycle Management - Manages the full lifespan of Kubernetes worker nodes, including adding, editing, and removing them from the cluster.
- Node Network Configuration - Dynamically modifies node network configurations to ensure seamless communication between containers acting as cluster nodes.
- Container Port Mapping - Maps internal Kubernetes service ports to the host machine to expose the cluster to external traffic.
- Container Image Management - Streams container images directly into node containers to make local images available without a remote registry.
- Container Image Registries - Orchestrates local container registries to provide image caching and proxying for internal cluster networks.
- Kubeconfig Management Tools - Manages the generation and merging of kubeconfig files for cluster access via command-line tools.
- CI Cluster Automation - Automates the creation and destruction of ephemeral Kubernetes clusters for integration testing in CI pipelines.
- Cluster Resource Management - Provides administrative control to remove containerized clusters and their associated system resources.
- Kubeconfig Generation - Writes cluster configurations to streams or files to enable external client access.
- Local Kubernetes Orchestration - Provides a utility to quickly deploy and destroy isolated Kubernetes clusters for development and integration testing.
- Network Traffic Routing - Proxies TCP and UDP ports from the host machine into the containerized cluster using a load balancer.
- Client Context Switching - Provides mechanisms to switch active configuration profiles and namespaces within local client tools.
- Infrastructură și containere - Helper to run k3s in Docker.
