isabella232 / k6-chaos

Repository of helpers to run chaos experiments with k6

⚠️ This is a proof of concept

As this is a proof of concept, the API may break in the future. USE AT YOUR OWN RISK!

k6-chaos

Do you want to unleash some chaos? You are in the right place!

This repo contains a collection of JavaScript helpers to run chaos experiments effortlessly on top of k6.

Getting started

The first thing you need is a custom k6 binary with the extensions required to use this library: xk6-kubernetes.

You can also download the required k6 binary from the releases page.

Example

import { KubernetesClient } from './src/chaos.js';

export default function () {
  // We instantiate a new *chaotic* Kubernetes client.
  const kubernetes = new KubernetesClient()

  // We run KillRandomPod to randomly kill a pod in the specified namespace.
  const killed = kubernetes.killRandomPod('operations')
  console.log(`Killed pod: ${killed}`);

  // And then, we run DeleteRandomNamespace to delete a random namespace.
  const deleted = kubernetes.deleteRandomNamespace()
  console.log(`Deleted namespace: ${deleted}`);
}

APIs

Kubernetes

Method	Description
killRandomPod	kill a pod randomly in the specified namespace
killRandomJob	kill a job randomly in the specified namespace
deleteRandomNamespace	delete a random namespace

WIP

Method	Description
exhaustCPU	stress CPU in one pod
exhaustMemory	stress memory in one pod