Go to file

Andy Zhou aa6e142b81 Log more information when the docker-machine command fails

Currently, when the 'docker-machine' command fails, we only logs

   "exit status 1'

Which is not very helpful in root cause analysis.

With this patch, the 'docker-machine' command's stderr output is also
logged.

  # To cause docker-machine command fail
  $ export DOCKER_MACHINE_NAME=xx
  $ k3d create
2019/06/13 16:45:31 Created cluster network with ID 6fc91e0e5e912443e6b847f113a6a0bb85ccd610e5232592296d4b199f0347cf
2019/06/13 16:45:31 Error executing 'docker-machine ip'
2019/06/13 16:45:31 Docker machine "xx" does not exist. Use "docker-machine ls" to list machines. Use "docker-machine create" to add a new one.
exit status 1

2019-06-13 16:47:27 -07:00

.github/ISSUE_TEMPLATE

add docker version

2019-05-21 23:04:12 +02:00

cli

Log more information when the docker-machine command fails

2019-06-13 16:47:27 -07:00

docs

refactor documentation

2019-05-21 16:16:33 +02:00

vendor

connect workers and server via own docker network

2019-04-18 16:08:15 +02:00

version

update default K3sVersion to use latest tag

2019-05-03 22:04:39 -04:00

.gitignore

exclude binary folders

2019-04-03 09:59:23 +02:00

.travis.yml

rename and add authors

2019-04-12 07:36:59 +02:00

go.mod

use docker sdk wherever possible

2019-04-15 15:48:43 +02:00

go.sum

enhanced list

2019-04-04 09:19:26 +02:00

install.sh

rename and add authors

2019-04-12 07:36:59 +02:00

LICENSE

update README

2019-04-03 10:27:09 +02:00

main.go

Deprecate --timeout, shift shot hand options around

2019-06-06 12:26:26 -07:00

Makefile

Makefile: Add lint target and factor the check target

2019-05-16 23:37:46 -07:00

README.md

clarification

2019-05-22 00:28:23 +02:00

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

docker

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
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 one of the following commands
- make build to build for your current system
- go install to install it to your GOPATH (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 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

What now?

Find more details under the following Links:

Connect

Join the Rancher community on slack via slack.rancher.io
Go to rancher-users.slack.com and join our channel #k3d
Start chatting