Version: 1.1.4

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#

curl -sSL https://mirrors.chaos-mesh.org/latest/install.sh | bash

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.

curl -sSL https://mirrors.chaos-mesh.org/latest/install.sh | bash -s -- --template | kubectl delete -f -

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.