kuberang is a command-line utility for smoke testing a Kubernetes install.
It scales out a pair of services, checks their connectivity, and then scales back in again. Sort of like a boomerang, you know?
It will tell you if the machine and account from which you run it:
- Has kubectl installed correctly with access controls
- Has available workers
- Has working pod & service networks
- Has working pod <-> pod DNS
- Has working master(s)
- Has the ability to access pods and services from the node you run it on.
It's suggested that you run kuberang from a node OTHER than a worker.
kuberang will exit with a code of 0 even if some of the above are not possible. It's up to the user to parse the output.
Adding -o json will return a parsable json blob instead of a pretty string report.
- A working kubectl (or all you'll get is a message complaining about kubectl)
- Access to a Docker registry with busybox and nginx images
- Go 1.7 installed
We use make to clean, build, and produce our distribution package. Take a look at the Makefile for more details.
In order to build the Go binaries (e.g. Kismatic CLI):
make build
In order to clean:
make clean
In order to produce the distribution package:
make dist
This will produce an ./out directory, which contains the bits, and a tarball.
You may pass build options as necessary:
GOOS=linux make build