Skip to main content
Account

Sonobuoy

Sonobuoy is a diagnostic tool that runs conformance and custom test plugins in a Kubernetes cluster. Learn to run tests and read the results.

Status
Stable
Category
Provisioning
Subcategory
Security & Compliance
License
Apache-2.0

Sonobuoy is a diagnostic tool for Kubernetes clusters that runs conformance and custom test suites inside the cluster and reports back on the results. It is the reference tool used by the CNCF Kubernetes Conformance Program: if a vendor wants to earn the “Certified Kubernetes” mark, they must pass the upstream end-to-end tests via Sonobuoy and submit the tarball.

Architecturally, sonobuoy run deploys an aggregator pod and a set of plugin pods into the target cluster. The default plugins execute the upstream Kubernetes e2e conformance tests and the systemd-logs gatherer, but any container that writes results to a known path can be a plugin, so teams can run custom compliance, security, or smoke-test suites the same way. Results are streamed back to the aggregator, bundled into a tarball, and inspectable via sonobuoy results.

Sonobuoy was created at Heptio (now VMware/Broadcom) and is the canonical way to validate that a new or upgraded cluster actually behaves like Kubernetes before handing it to application teams.

Sonobuoy recordings

1 recording, newest first

Security & Compliance

Email signup loads here. You can also manage email preferences in account settings.

Build Sonobuoy? I'll show you where engineers get stuck with it → Back free content for the community →