本篇文档描述如何离线安装 Chaos Mesh。

环境准备

在安装前,请先确保离线环境中已经安装 Docker 并部署了 Kubernetes 集群。如果环境尚未准备好,请参考以下链接安装 Docker 并部署 Kubernetes 集群:

准备安装文件

在离线安装 Chaos Mesh 前,你需要从有外网连接的机器上下载所有 Chaos Mesh 镜像和仓库压缩包,然后将下载的文件拷贝到离线环境中。

指定版本号

在有外网连接的机器上,设置 Chaos Mesh 的版本号为环境变量:

export CHAOS_MESH_VERSION=latest

下载 Chaos Mesh 镜像

在有外网连接的机器上,通过已经设置的版本号拉取镜像:

  1. docker pull pingcap/chaos-mesh:${CHAOS_MESH_VERSION}
  2. docker pull pingcap/chaos-daemon:${CHAOS_MESH_VERSION}
  3. docker pull pingcap/chaos-dashboard:${CHAOS_MESH_VERSION}

保存镜像为 tar 包:

  1. docker save pingcap/chaos-mesh:${CHAOS_MESH_VERSION} > image-chaos-mesh.tar
  2. docker save pingcap/chaos-daemon:${CHAOS_MESH_VERSION} > image-chaos-daemon.tar
  3. docker save pingcap/chaos-dashboard:${CHAOS_MESH_VERSION} > image-chaos-dashboard.tar

:::note 注意

如需模拟 DNS 故障(例如,使 DNS 响应返回随机的错误 IP 地址),请额外拉取 pingcap/coredns 镜像。

:::

下载 Chaos Mesh 仓库压缩包

在有外网连接的机器上,下载 Chaos Mesh 的 zip 包:

  1. curl https://github.com/chaos-mesh/chaos-mesh/archive/refs/heads/${CHAOS_MESH_VERSION}.zip -o chaos-mesh.zip

:::note 注意

latest 版本对应 Chaos Mesh 仓库的 master 分支,链接为:

https://github.com/chaos-mesh/chaos-mesh/archive/refs/heads/master.zip

:::

拷贝文件

所有安装所需的文件下载完成后,请将这些文件拷贝到离线环境中:

  • image-chaos-mesh.tar
  • image-chaos-daemon.tar
  • image-chaos-dashboard.tar
  • chaos-mesh.zip

安装

将 Chaos Mesh 镜像的 tar 包和仓库的 zip 包拷贝到你的离线环境后,就可以按照以下步骤进行安装。

第 1 步:加载 Chaos Mesh 镜像

从 tar 包中加载镜像:

  1. docker load < image-chaos-mesh.tar
  2. docker load < image-chaos-daemon.tar
  3. docker load < image-chaos-dashboard.tar

第 2 步:推送镜像至 Registry

:::note 注意

在推送镜像前,请确保离线环境中已经部署 Registry。如果尚未部署,请参考 Docker Registry 进行部署。

:::

设置 Chaos Mesh 版本和 Registry 地址为环境变量:

export CHAOS_MESH_VERSION=latest; export DOCKER_REGISTRY=localhost:5000

标记镜像使其指向 Registry:

  1. export CHAOS_MESH_IMAGE=$DOCKER_REGISTRY/pingcap/chaos-mesh:${CHAOS_MESH_VERSION}
  2. export CHAOS_DAEMON_IMAGE=$DOCKER_REGISTRY/pingcap/chaos-daemon:${CHAOS_MESH_VERSION}
  3. export CHAOS_DASHBOARD_IMAGE=$DOCKER_REGISTRY/pingcap/chaos-dashboard:${CHAOS_MESH_VERSION}
  4. docker image tag pingcap/chaos-mesh:${CHAOS_MESH_VERSION} $CHAOS_MESH_IMAGE
  5. docker image tag pingcap/chaos-daemon:${CHAOS_MESH_VERSION} $CHAOS_DAEMON_IMAGE
  6. docker image tag pingcap/chaos-dashboard:${CHAOS_MESH_VERSION} $CHAOS_DASHBOARD_IMAGE

推送镜像至 Registry:

  1. docker push $CHAOS_MESH_IMAGE
  2. docker push $CHAOS_DAEMON_IMAGE
  3. docker push $CHAOS_DASHBOARD_IMAGE

第 3 步:使用 Helm 安装

解压 Chaos Mesh 的 zip 包:

  1. unzip chaos-mesh.zip -d chaos-mesh && cd chaos-mesh

创建命名空间:

  1. kubectl create ns chaos-testing

执行 Chaos Mesh 安装命令。在安装命令中,你需要指定 Chaos Mesh 的命名空间和各组件的镜像值:

  1. helm install chaos-mesh helm/chaos-mesh -n=chaos-testing \
  2. --set chaosDaemon.image=$CHAOS_DAEMON_IMAGE \
  3. --set controllerManager.image=$CHAOS_MESH_IMAGE \
  4. --set dashboard.image=$CHAOS_DASHBOARD_IMAGE

验证安装

运行 Chaos 实验