k3d-go

k3s in docker

k3s is the lightweight Kubernetes distribution by Rancher: rancher/k3s

This repository is basically zeerorg/k3s-in-docker reimplemented in Golang with some different/new functionality... just because I didn't have time to learn Rust.

Thanks to @zeerorg for the original work!

Requirements

docker

Install

Grab a release from the release tab.

or...

Build

Clone this repo, e.g. via go get -u github.com/iwilltry42/k3d-go/releases
Inside the repo run
- make bootstrap to install build tools and then make build to build for your current system
- go install to install it to your GOPATH
- make build-cross to build for all systems

Usage

Check out what you can do via k3d help

Example Workflow: Create a new cluster and use it with kubectl

k3d create to create a new single-node cluster (docker container)
export KUBECONFIG=$(k3d get-kubeconfig) to make kubectl to use the kubeconfig for that cluster
execute some commands like kubectl get pods --all-namespaces
k3d delete to delete the default cluster

TODO

Use the docker client library instead of commands
Test the docker version
Improve cluster state management