mirror of https://github.com/k3d-io/k3d
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2.0 KiB
2.0 KiB
k3d
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
Install
You have several options there:
- use the install script to grab the latest release:
- wget:
wget -q -O - https://raw.githubusercontent.com/iwilltry42/k3d/master/install.sh | bash
- curl:
curl -s https://raw.githubusercontent.com/iwilltry42/k3d/master/install.sh | bash
- wget:
- Grab a release from the release tab and install it yourself.
- Via go:
go install github.com/iwilltry42/k3d
or...
Build
- Clone this repo, e.g. via
go get -u github.com/iwilltry42/k3d/releases
- Inside the repo run
make
to build for your current systemgo install
to install it to yourGOPATH
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 makekubectl
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
- Use sirupsen/logrus for prettier logs
- Add install script