chaosbladeio/chaosblade-tool

chaosblade镜像文档

镜像概述

chaosblade镜像基于chaosblade混沌工程工具构建，专为Kubernetes和Docker环境设计，提供便捷的故障注入能力。该镜像可帮助用户模拟各类系统异常（如容器故障、网络延迟、资源负载等），验证目标系统在异常场景下的稳定性与弹性，是混沌工程实践的核心工具载体。

核心功能与特性

• 多环境支持：原生兼容Kubernetes集群与Docker容器环境，无需额外适配
• 丰富故障类型：支持容器生命周期（停止/重启）、网络（延迟/丢包/分区）、资源（CPU/内存负载）、应用层（方法调用异常/返回值篡改）等多维度故障注入
• 完整命令体系：提供chaosblade命令行工具，支持故障定义、执行、状态查询、撤销等全生命周期管理
• 精细控制能力：支持设置故障持续时间、影响范围（如指定容器/ Pod标签）、触发条件等参数，实现精准故障模拟
• 安全可控：故障注入过程可追溯，支持一键撤销，避免对生产环境造成持久影响

使用场景与适用范围

• 微服务弹性测试：验证服务在依赖组件故障（如数据库不可用、消息队列延迟）时的容错与降级能力
• 容器编排稳定性验证：测试Kubernetes/Docker Swarm在节点故障、容器异常退出时的自愈与调度能力
• 故障演练：模拟生产环境常见故障（如网络分区、资源耗尽），验证监控告警有效性与故障恢复流程
• 系统极限测试：通过资源负载故障（如CPU 100%占用、内存溢出），验证系统在高压力下的性能表现与稳定性边界

使用方法与配置说明

1. 镜像拉取

bash
docker pull chaosblade/chaosblade

2. 基本使用格式

bash
docker run --rm [挂载参数] chaosblade/chaosblade <command> [参数]

说明：--rm参数用于实验结束后自动清理容器；根据目标环境需挂载对应资源（如Docker socket、Kubernetes配置文件）

3. Docker环境使用示例

3.1 停止指定容器（持续30秒）

bash
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock \
  chaosblade/chaosblade create docker container stop \
  --container-name=my-app-container \
  --duration=30s

3.2 注入网络延迟（300ms延迟，波动100ms）

bash
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock \
  chaosblade/chaosblade create docker network delay \
  --container-name=my-app-container \
  --time=300 \
  --offset=100

3.3 增加CPU负载（80%使用率，持续2分钟）

bash
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock \
  chaosblade/chaosblade create docker cpu load \
  --container-name=my-app-container \
  --cpu-percent=80 \
  --duration=2m

4. Kubernetes环境使用示例

前提：需先在Kubernetes集群中部署ChaosBlade Operator（参考官方文档）

4.1 删除指定标签的Pod（持续60秒）

bash
kubectl exec -it chaosblade-tool -n chaosblade -- \
  chaosblade create k8s pod delete \
  --namespace=default \
  --label=app=my-app \
  --duration=60s

4.2 注入Pod网络丢包（丢包率30%）

bash
kubectl exec -it chaosblade-tool -n chaosblade -- \
  chaosblade create k8s network loss \
  --namespace=default \
  --label=app=my-app \
  --percent=30

5. 实验管理命令

• 查询实验状态：

  bash
  docker run --rm chaosblade/chaosblade status
  

• 撤销指定实验：

  bash
  docker run --rm -v /var/run/docker.sock:/var/run/docker.sock \
    chaosblade/chaosblade destroy <实验ID>
  

• 查看帮助文档：

  bash
  docker run --rm chaosblade/chaosblade -h
  

6. 核心配置参数说明

注意事项

• 生产环境使用前需进行充分测试，建议在隔离环境中验证故障注入方案
• Kubernetes环境需确保ChaosBlade Operator具备足够权限（如Pod/Service操作权限）
• 故障注入可能影响业务可用性，建议在低峰期执行并提前准备回滚方案
• 详细命令与参数可参考chaosblade官方文档