Install Chaos Mesh Offline
This document describes how to install Chaos Mesh offline.
Before installing Chaos Mesh, make sure that Docker is installed and the Kubernetes cluster is deployed in the offline environment. If the environment is not prepared, refer to the following documents to install Docker and deploy the Kubernetes cluster:
Before you install Chaos Mesh offline, you need to download all Chaos Mesh images and repository compression packages from the machines with external network connection, and then copy the downloaded files into your offline environment.
Set the version number of Chaos Mesh as the environment variable on the machine with external network connection:
Download Chaos Mesh images
On the machine connected to external network, pull images using the version number that has been set:
Save images as the tar packages:
docker save pingcap/chaos-daemon:${CHAOS_MESH_VERSION} > image-chaos-daemon.tar
docker save pingcap/chaos-dashboard:${CHAOS_MESH_VERSION} > image-chaos-dashboard.tar
note
To simulate a DNS fault (for example, make the DNS responses return a random wrong IP address), you need to pull the additional images.
Copy files
After downloading all the files required for installation, you need to copy these files to the offline environment:
image-chaos-mesh.tar
image-chaos-daemon.tar
chaos-mesh.zip
After copying the tar package of the Chaos Mesh images and the zip package of the repository to the offline environment, take the following steps to install Chaos Mesh.
Load images from the tar package:
docker load < image-chaos-mesh.tar
docker load < image-chaos-daemon.tar
Step 2: Push images to Registry
note
Before pushing images to Registry, make sure that Registry has been deployed in the offline environment. If Registry is not deployed, refer to for the deployment method.
Set the Chaos Mesh version and the Registry address as the environment variable:
Mark the images so that the images point to the Registry:
Push images to Registry:
docker push $CHAOS_MESH_IMAGE
docker push $CHAOS_DAEMON_IMAGE
docker push $CHAOS_DASHBOARD_IMAGE
unzip chaos-mesh.zip -d chaos-mesh && cd chaos-mesh
note
When installing Chaos Mesh on Kubernetes v1.15(or an earlier version), you need to manually install CRD first by using kubectl create -f manifests/crd-v1beta1.yaml
. For more information, see .
Create the namespace:
Execute the installation command. When executing the installation command, you need to specify the namespace of Chaos Mesh and the image value of each component:
To check the running status of Chaos Mesh, execute the following command:
kubectl get po -n chaos-testing
The expected output is as follows:
NAME READY STATUS RESTARTS AGE
chaos-controller-manager-69fd5c46c8-xlqpc 1/1 Running 0 2d5h
chaos-dashboard-98c4c5f97-tx5ds 1/1 Running 0 2d5h
If your actual output is similar to the expected output with NAME
, READY
, STATUS
, RESTARTS
, and AGE
, it means that Helm is installed successfully.
note
If the STATUS
of your actual output is not Running
, then execute the following command to check the Pod details, and troubleshoot issues according to the error information.
For the method to run the experiment, it is recommended to refer to . After successfully creating the experiment, you can observe the running status of the experiment on the Chaos Dashboard.