配置开发环境

本文档介绍如何搭建 Chaos Mesh 的开发环境。

环境要求

安装 Chaos Mesh 所需的开发工具。

• golang 版本不低于 v1.15
• docker
• gcc
• helm 版本不低于 v2.8.2
• kind
• nodejs 和 pnpm (用于开发 Chaos Dashboard)

准备工具链

准备好上述环境后，请按照以下步骤配置用于编译 Chaos Mesh 的工具链。

1. 将 Chaos Mesh 项目克隆至本地。

   git clone https://github.com/chaos-mesh/chaos-mesh.git
   cd chaos-mesh

2. 确保你的环境中已经安装 Docker 并且正在运行 Docker。

3. 确保 Docker Registry 正在运行。将环境变量 DOCKER_REGISTRY 设置为其地址:

   echo 'export DOCKER_REGISTRY=localhost:5000' >> ~/.bash_profile
   source ~/.bash_profile

4. 确保 ${GOPATH}/bin 在你的 PATH 环境变量中。

   echo 'export PATH=$(go env GOPATH)/bin:${PATH}' >> ~/.bash_profile

   source ~/.bash_profile

5. 检查 Nodejs 相关环境。

    node -v
    pnpm -v

6. 尝试编译 Chaos Mesh：

   make

   如果没有报错，那么工具链已经配置完毕。

准备部署环境

在工具链准备完之后，你还需要启动一个本地的 Kubernetes 集群用于部署 Chaos Mesh。由于 kind 已经安装好了，你可以直接使用以下脚本启动一个 Kubernetes 集群：

hack/kind-cluster-build.sh

当你不再需要此集群，希望删除它时，可以使用：

kind delete cluster --name=kind

如需启动 Chaos Dashboard，请运行以下命令：

cd ui && pnpm i
# 启动
pnpm -F @ui/app start:default # cross-env REACT_APP_API_URL=http://localhost:2333 BROWSER=none react-scripts start

下一步

在完成上述 Chaos Mesh 开发的准备工作后，请尝试新增混沌实验类型。