No results for

Powered byAlgolia

xk6-disruptor is a k6 extension. You have to run a k6 version built with the disruptor extension to use the disruptor APIs in your k6 tests.

The following sections explain the different options to get this custom binary.

Download a release binary

The quickest way to get started is to download a release binary from GitHub.

Build from source

You can also use xk6 to build a k6 binary.

To find out more about how to use xk6 or what it is, check out this guide - Build a k6 binary with extensions.

To build the k6 binary with the xk6-disruptor extension:

  1. Ensure you have Go 1.18 and Git installed.
  2. Run the following commands in a terminal:
Linux/MacOS
# Install xk6
go install go.k6.io/xk6/cmd/xk6@latest
# Clone the xk6-disruptor code
git clone https://github.com/grafana/xk6-disruptor.git
cd xk6-disruptor
# Build the custom binary
xk6 build --output xk6-disruptor --with github.com/grafana/xk6-disruptor=. --with github.com/grafana/xk6-kubernetes

Notice that the build command includes both the xk6-disruptor and the xk6-kubernetes extension. This is because many example scripts use the xk6-kubernetes extension to create the Kubernetes resources they need, such as Pods and Services. If you don't use this extension in your tests, you can build the custom k6 binary with only the xk6-disruptor extension using the following command instead:

Linux/MacOS
xk6 build --output xk6-disruptor --with github.com/grafana/xk6-disruptor=.

xk6 will create the xk6-disruptor binary in the current working directory.