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.
iwilltry42
2640fc13ce
|
5 years ago | |
---|---|---|
cli | 5 years ago | |
vendor | 6 years ago | |
version | 5 years ago | |
.gitignore | 6 years ago | |
.travis.yml | 6 years ago | |
LICENSE | 6 years ago | |
Makefile | 5 years ago | |
README.md | 5 years ago | |
go.mod | 6 years ago | |
go.sum | 6 years ago | |
install.sh | 6 years ago | |
main.go | 5 years ago |
README.md
k3d
k3s in docker
k3s is the lightweight Kubernetes distribution by Rancher: rancher/k3s
This repository is based on @zeerorg's zeerorg/k3s-in-docker, reimplemented in Go by @iwilltry42 in iwilltry42/k3d, which is now rancher/k3d.
Requirements
Get
You have several options there:
- use the install script to grab the latest release:
- wget:
wget -q -O - https://raw.githubusercontent.com/rancher/k3d/master/install.sh | bash
- curl:
curl -s https://raw.githubusercontent.com/rancher/k3d/master/install.sh | bash
- wget:
- Grab a release from the release tab and install it yourself.
- Via go:
go install github.com/rancher/k3d
(Note: this will give you unreleased/bleeding-edge changes)
or...
Build
- Clone this repo, e.g. via
go get -u github.com/rancher/k3d
- Inside the repo run
- 'make install-tools' to make sure required go packages are installed
- Inside the repo run
make build
to build for your current systemgo install
to install it to yourGOPATH
(Note: this will give you unreleased/bleeding-edge changes)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