Skip to main content
Version: 1.0.3

Get started on Minikube

This document describes how to deploy Chaos Mesh in Kubernetes on your laptop (Linux or macOS) using Minikube.

Prerequisites​

Before deployment, make sure Minikube is installed on your local machine.

Step 1: Set up the Kubernetes environment​

Perform the following steps to set up the local Kubernetes environment:

  1. Start a Kubernetes cluster:

    minikube start --kubernetes-version v1.15.0 --cpus 4 --memory "8192mb"

    Note:

    It is recommended to allocate enough RAM (more than 8192 MiB) to the Virtual Machine (VM) using the --cpus and --memory flag.

  2. Install helm:

    Following helm installation steps: https://helm.sh/docs/intro/install

Step 2: Install Chaos Mesh​

The above command installs all the CRDs, required service account configuration, and all components. Before you start running a chaos experiment, verify if Chaos Mesh is installed correctly.

You also can use helm to install Chaos Mesh manually.

Verify your installation​

Verify if Chaos Mesh is running

kubectl get pod -n chaos-testing

Expected output:

NAME                                        READY   STATUS    RESTARTS   AGE
chaos-controller-manager-6d6d95cd94-kl8gs   1/1     Running   0          3m40s
chaos-daemon-5shkv                          1/1     Running   0          3m40s
chaos-dashboard-d998856f6-vgrjs             1/1     Running   0          3m40s

Run Chaos experiment​

Now that you have deployed Chaos Mesh in your environment, it's time to use it for your chaos experiments. Follow the steps in Run chaos experiment to run a Chaos experiment and then observe it on Chaos Mesh Dashboard.

Uninstallation​

You can uninstall Chaos Mesh by deleting the namespace.

Limitations​

There are some known restrictions for Chaos Operator deployed in the Minikube cluster:

  • netem chaos is only supported for Minikube clusters >= version 1.6.

In Minikube, the default virtual machine driver's image does not contain the sch_netem kernel module in earlier versions. You can use none driver (if your host is Linux with the sch_netem kernel module loaded) to try these chaos actions using Minikube or build an image with sch_netem by yourself.