离线安装
本篇文档描述如何离线安装 Chaos Mesh。
环境准备
在安装前,请先确保离线环境中已经安装 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 po -n chaos-mesh
以下是预期输出:
NAME READY STATUS RESTARTS AGE
chaos-controller-manager-69fd5c46c8-xlqpc 3/3 Running 0 2d5h
chaos-daemon-jb8xh 1/1 Running 0 2d5h
chaos-dashboard-98c4c5f97-tx5ds 1/1 Running 0 2d5h
如果你的实际输出与预期输出相符,表示 Chaos Mesh 已经成功安装。
如果实际输出的 STATUS
状态不是 Running
,则需要运行以下命令查看 Pod 的详细信息,然后依据错误提示排查并解决问题。
# 以 chaos-controller 为例
kubectl describe po -n chaos-mesh chaos-controller-manager-69fd5c46c8-xlqpc
如果手动关闭了 leader-election
,chaos-controller-manager
应该只有 1 个实例。
NAME READY STATUS RESTARTS AGE
chaos-controller-manager-69fd5c46c8-xlqpc 1/1 Running 0 2d5h
chaos-daemon-jb8xh 1/1 Running 0 2d5h
chaos-dashboard-98c4c5f97-tx5ds 1/1 Running 0 2d5h
运行 Chaos 实验
验证安装完成后,你可以运行一个 Chaos 实验来体验 Chaos Mesh 的功能。
请参考运行试验进行创建。成功创建实验后,你可以通过 Chaos Dashboard 观察实验的运行状态。