Kube-burner is a Kubernetes performance and scale test orchestration toolset. It provides multi-faceted functionality, the most important of which are summarized below.

• Create, delete and patch Kubernetes resources at scale.
• Prometheus metric collection and indexing.
• Measurements.
• Alerting.

Kube-burner is a binary application written in golang that makes extensive usage of the official k8s client library, client-go.

Documentation is available here

Install latest stable version with:

curl -Ls https://raw.githubusercontent.com/kube-burner/kube-burner/refs/heads/main/hack/install.sh | sh

In case you want to start tinkering with Kube-burner now:

• You can find the binaries in the releases section of the repository.
• There's also a container image available at quay.

Example configuration files can be found at the examples directory.

Kube-burner provides multiple build options:

• make build - Standard build for development
• make build-release - Optimized release build
• make build-hardened - Security-hardened static binary
• make build-hardened-cgo - Full security hardening with CGO (requires glibc)

The default builds produce static binaries that work across all Linux distributions. The CGO-hardened build offers additional security features but requires glibc to be present on the target system.

Please read the Contributing section before contributing to this project. It provides information on how to contribute, guidelines for setting an environment a CI checks to be done before committing code.

This project utilizes a Continuous Integration (CI) pipeline to ensure code quality and maintain project standards. The CI process automatically builds, tests, and verifies the project on each commit and pull request.

This project is for everyone. We ask that our users and contributors take a few minutes to review our Code of Conduct.