Install Chaos Mesh Offline
This document describes how to install Chaos Mesh offline.
Prerequisites
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:
Prepare installation files
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.
Specify version number
Set the Chaos Mesh and DNS image versions as environment variables on the machine with external network connection:
The DNS image uses its own version. CHAOS_DNS_VERSION matches the image tag configured in dnsServer.image in this version of the Helm chart.
Download Chaos Mesh images
On the machine connected to the external network, pull images using the version number that has been set:
docker pull ghcr.io/chaos-mesh/chaos-mesh:${CHAOS_MESH_VERSION}
docker pull ghcr.io/chaos-mesh/chaos-daemon:${CHAOS_MESH_VERSION}
docker pull ghcr.io/chaos-mesh/chaos-dashboard:${CHAOS_MESH_VERSION}
docker pull ghcr.io/chaos-mesh/chaos-coredns:${CHAOS_DNS_VERSION}
Save images as the tar packages:
docker save ghcr.io/chaos-mesh/chaos-mesh:${CHAOS_MESH_VERSION} > image-chaos-mesh.tar
docker save ghcr.io/chaos-mesh/chaos-daemon:${CHAOS_MESH_VERSION} > image-chaos-daemon.tar
docker save ghcr.io/chaos-mesh/chaos-dashboard:${CHAOS_MESH_VERSION} > image-chaos-dashboard.tar
docker save ghcr.io/chaos-mesh/chaos-coredns:${CHAOS_DNS_VERSION} > image-chaos-coredns.tar
The Helm chart enables the DNS server by default. Include the chaos-mesh/chaos-coredns image in the offline files, even if you do not plan to run DNSChaos. If you explicitly set dnsServer.create=false, you can omit this image.
Download the repository compression package of Chaos Mesh
On the machine connected to the external network, download the zip package of Chaos Mesh:
Copy files
After downloading all the files required for installation, you need to copy these files to the offline environment:
image-chaos-mesh.tarimage-chaos-daemon.tarimage-chaos-dashboard.tarimage-chaos-coredns.tarchaos-mesh.zip
Install Chaos Mesh
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.
Step 1. Load Chaos Mesh images
Load images from the tar package:
docker load < image-chaos-mesh.tar
docker load < image-chaos-daemon.tar
docker load < image-chaos-dashboard.tar
docker load < image-chaos-coredns.tar
Step 2. Push images to Registry
Before pushing images to Registry, make sure that Registry has been deployed in the offline environment. If Registry is not deployed, refer to Docker Registry for the deployment method.
Set the image versions and the Registry address as environment variables:
Mark the images so that they point to the Registry:
export CHAOS_MESH_IMAGE=$DOCKER_REGISTRY/chaos-mesh/chaos-mesh:${CHAOS_MESH_VERSION}
export CHAOS_DAEMON_IMAGE=$DOCKER_REGISTRY/chaos-mesh/chaos-daemon:${CHAOS_MESH_VERSION}
export CHAOS_DASHBOARD_IMAGE=$DOCKER_REGISTRY/chaos-mesh/chaos-dashboard:${CHAOS_MESH_VERSION}
export CHAOS_DNS_IMAGE=$DOCKER_REGISTRY/chaos-mesh/chaos-coredns:${CHAOS_DNS_VERSION}
docker image tag ghcr.io/chaos-mesh/chaos-mesh:${CHAOS_MESH_VERSION} $CHAOS_MESH_IMAGE
docker image tag ghcr.io/chaos-mesh/chaos-daemon:${CHAOS_MESH_VERSION} $CHAOS_DAEMON_IMAGE
docker image tag ghcr.io/chaos-mesh/chaos-dashboard:${CHAOS_MESH_VERSION} $CHAOS_DASHBOARD_IMAGE
docker image tag ghcr.io/chaos-mesh/chaos-coredns:${CHAOS_DNS_VERSION} $CHAOS_DNS_IMAGE
Push images to Registry:
docker push $CHAOS_MESH_IMAGE
docker push $CHAOS_DAEMON_IMAGE
docker push $CHAOS_DASHBOARD_IMAGE
docker push $CHAOS_DNS_IMAGE
Step 3. Install Chaos Mesh using Helm
Unpack the zip package of Chaos Mesh:
unzip chaos-mesh.zip -d chaos-mesh
cd chaos-mesh/chaos-mesh-*/
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 FAQ.
Create the namespace:
kubectl create ns chaos-mesh
Execute the installation command. When executing the installation command, you need to specify the namespace of Chaos Mesh and the image values of each component:
helm install chaos-mesh helm/chaos-mesh -n=chaos-mesh --set images.registry=$DOCKER_REGISTRY --set-string dnsServer.image="$CHAOS_DNS_IMAGE"
Verify the installation
To check the running status of Chaos Mesh, execute the following command:
kubectl get pods -n chaos-mesh -l app.kubernetes.io/instance=chaos-mesh
The expected output is as follows:
NAME READY STATUS RESTARTS AGE
chaos-controller-manager-7b8c86cc9-44dzf 1/1 Running 0 17m
chaos-controller-manager-7b8c86cc9-mxw99 1/1 Running 0 17m
chaos-controller-manager-7b8c86cc9-xmc5v 1/1 Running 0 17m
chaos-daemon-sg2k2 1/1 Running 0 17m
chaos-dashboard-b9dbc6b68-hln25 1/1 Running 0 17m
chaos-dns-server-546675d89d-qkjqq 1/1 Running 0 17m
If your actual output is similar to the expected output, then Chaos Mesh has been successfully installed.
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.
# Take the chaos-controller as an example
kubectl describe po -n chaos-mesh chaos-controller-manager-7b8c86cc9-44dzf
If leader election is turned off, chaos-controller-manager should only have 1 replication.
NAME READY STATUS RESTARTS AGE
chaos-controller-manager-676d8567c7-ndr5j 1/1 Running 0 24m
chaos-daemon-6l55b 1/1 Running 0 24m
chaos-dashboard-b9dbc6b68-hln25 1/1 Running 0 44m
chaos-dns-server-546675d89d-qkjqq 1/1 Running 0 44m
Run Chaos experiments
After verifying that the installation is complete, you can run a Chaos experiment to experience the features of Chaos Mesh.
For the method to run the experiment, it is recommended to refer to Run a Chaos experiment. After successfully creating the experiment, you can observe the running status of the experiment on the Chaos Dashboard.