离线安装

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

环境准备

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

• Docker
• Kubernetes

准备安装文件

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

指定版本号

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

下载 Chaos Mesh 镜像

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

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}

保存镜像为 tar 包：

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

注意

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

下载 Chaos Mesh 仓库压缩包

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

拷贝文件

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

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

安装

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

第 1 步：加载 Chaos Mesh 镜像

从 tar 包中加载镜像：

docker load < image-chaos-mesh.tar
docker load < image-chaos-daemon.tar
docker load < image-chaos-dashboard.tar

第 2 步：推送镜像至 Registry

注意

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

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

标记镜像使其指向 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}
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

推送镜像至 Registry：

docker push $CHAOS_MESH_IMAGE
docker push $CHAOS_DAEMON_IMAGE
docker push $CHAOS_DASHBOARD_IMAGE

第 3 步：使用 Helm 安装

解压 Chaos Mesh 的 zip 包：

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

注意

如果你正在安装在 Kubernetes v1.15（或更低版本）中安装 Chaos Mesh，请通过 kubectl create -f manifests/crd-v1beta1.yaml 手动安装 CRD。 具体细节，请参考 FAQ。

创建命名空间：

kubectl create ns chaos-mesh

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

helm install chaos-mesh helm/chaos-mesh -n=chaos-mesh --set images.registry=$DOCKER_REGISTRY

验证安装

要检查 Chaos Mesh 的运行情况，请执行以下命令：

kubectl get pods -n chaos-mesh -l app.kubernetes.io/instance=chaos-mesh

以下是预期输出：

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 Mesh 已经成功安装。

注意

如果实际输出的 STATUS 状态不是 Running，则可以运行以下命令查看 Pod 的详细信息，然后依据错误提示排查并解决问题。

# 以 chaos-controller 为例
kubectl describe po -n chaos-mesh chaos-controller-manager-7b8c86cc9-44dzf

注意

如果 leader election 是关闭的，chaos-controller-manager 应只有 1 个实例。

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 实验

验证安装完成后，你可以运行一个 Chaos 实验来体验 Chaos Mesh 的功能。

请参考运行试验进行创建。成功创建实验后，你可以通过 Chaos Dashboard 观察实验的运行状态。