Documentation for version v0.13.0 is no longer actively maintained. The version you are currently viewing is a static snapshot. For up-to-date documentation, see the latest version.
Heptio Sonobuoy is a diagnostic tool that makes it easier to understand the state of a Kubernetes cluster by running a set of Kubernetes conformance tests in an accessible and non-destructive manner. It is a customizable, extendable, and cluster-agnostic way to generate clear, informative reports about your cluster.
Its selective data dumps of Kubernetes resource objects and cluster nodes allow for the following use cases:
Sonobuoy supports Kubernetes versions 1.11, 1.12 and 1.13.
The documentation provides further information about the conformance tests, plugins, etc.
Access to an up-and-running Kubernetes cluster. If you do not have a cluster, we recommend following the AWS Quickstart for Kubernetes instructions.
kubeconfig file, and the KUBECONFIG environment variable set.
The browser-based Sonobuoy Scanner tool is the quickest way to get started with Sonobuoy. Sonobuoy Scanner also provides a user-friendly way of viewing your scan results.
NOTE: Sonobuoy Scanner runs conformance tests only.
Sonobuoy also provides a CLI that lets you run Sonobuoy on your cluster. By default, the CLI records the following results:
Golang installed. We recommend gimme, with golang version 1.10.4.
Your $PATH configured:
$ export PATH=$GOROOT/bin:$GOPATH/bin:$PATH
Download the CLI by running:
$ go get -u -v github.com/heptio/sonobuoy
Deploy a Sonobuoy pod to your cluster with:
$ sonobuoy run
View actively running pods:
$ sonobuoy status
To inspect the logs:
$ sonobuoy logs
To view the output, copy the output directory from the main Sonobuoy pod to somewhere local:
$ sonobuoy retrieve .
This copies a single
.tar.gz snapshot from the Sonobuoy pod into your local
. directory. Extract the contents into
mkdir ./results; tar xzf *.tar.gz -C ./results
For information on the contents of the snapshot, see the snapshot documentation.
To clean up Kubernetes objects created by Sonobuoy, run:
Note that if you run Sonobuoy on a Google Kubernetes Engine (GKE) cluster, you must first create an admin role for the user under which you run Sonobuoy:
kubectl create clusterrolebinding <your-user-cluster-admin-binding> --clusterrole=cluster-admin --user=<firstname.lastname@example.org>
If you encounter any problems that the documentation does not address, file an issue.
Thanks for taking the time to join our community and start contributing! We welcome pull requests. Feel free to dig through the issues and jump in.
See the list of releases to find out about feature changes.