chaosbladeio/chaosblade-operator

ChaosBlade Operator 镜像文档

镜像概述

ChaosBlade Operator 镜像是 ChaosBlade 混沌工程工具的 Kubernetes 部署组件，基于操作器（Operator）模式实现，用于在 Kubernetes 集群中声明式管理和执行混沌实验。该镜像提供了与 Kubernetes API 深度集成的能力，支持通过自定义资源（CRD）定义混沌实验，帮助用户模拟各类故障场景，验证系统在异常条件下的稳定性和弹性。

核心功能与特性

• 多类型故障注入：支持 Pod 故障（删除、重启）、网络异常（延迟、丢包、分区）、资源压力（CPU/内存占用）、应用层故障（如数据库连接中断）等多种混沌实验类型。
• Kubernetes 原生集成：通过自定义资源定义（CRD）ChaosBlade 声明实验，支持 Kubernetes 标准操作流程（如 kubectl apply 创建实验）。
• 实验生命周期管理：提供实验创建、执行、暂停、恢复、终止全生命周期控制，支持实验结果自动记录与状态追踪。
• 细粒度目标选择：支持通过标签（label）、命名空间（namespace）、资源名称等方式精准定位目标资源，避免影响无关组件。
• 安全性控制：支持实验权限控制、白名单机制，防止未授权故障注入，保障生产环境安全。

使用场景

• 系统弹性测试：验证微服务架构在组件故障时的自我恢复能力。
• 故障演练：模拟生产环境可能出现的异常场景（如节点宕机、网络分区），检验运维应急预案有效性。
• 依赖关系测试：测试服务间依赖中断时的系统表现，优化服务降级与熔断策略。
• 性能极限测试：通过资源压力注入，验证系统在高负载下的稳定性。

使用方法

前提条件

• Kubernetes 集群版本 ≥ 1.16
• 集群已安装 kubectl 命令行工具
• 具备集群管理员权限（用于部署 CRD 和 Operator）

部署步骤

1. 部署 ChaosBlade Operator

通过 kubectl 应用官方部署清单（以 v1.7.1 版本为例）：

bash
kubectl apply -f https://raw.githubusercontent.com/chaosblade-io/chaosblade-operator/v1.7.1/deploy/chaosblade-operator.yaml

验证部署状态：

bash
kubectl get pods -n chaosblade
# 预期输出：chaosblade-operator-xxxx 状态为 Running

2. 创建混沌实验

通过创建 ChaosBlade 自定义资源定义实验，以下为常见场景示例：

示例 1：Pod 故障注入（删除指定命名空间下的随机 Pod）

yaml
apiVersion: chaosblade.io/v1alpha1
kind: ChaosBlade
metadata:
  name: delete-pod-example
  namespace: chaosblade
spec:
  experiments:
  - scope: pod
    target: pod
    action: delete
    desc: "delete pod in default namespace"
    matchers:
    - name: namespace
      value: ["default"]
    - name: label-selector
      value: ["app=demo"]  # 目标 Pod 的标签
    - name: count
      value: ["1"]  # 随机删除 1 个 Pod

应用实验配置：

bash
kubectl apply -f delete-pod-experiment.yaml

示例 2：网络延迟注入（对目标 Pod 增加网络延迟）

yaml
apiVersion: chaosblade.io/v1alpha1
kind: ChaosBlade
metadata:
  name: network-delay-example
  namespace: chaosblade
spec:
  experiments:
  - scope: pod
    target: network
    action: delay
    desc: "add network delay to pod"
    matchers:
    - name: namespace
      value: ["default"]
    - name: label-selector
      value: ["app=demo"]
    - name: duration
      value: ["30s"]  # 延迟持续时间
    - name: latency
      value: ["500ms"]  # 延迟时间
    - name: jitter
      value: ["100ms"]  # 延迟抖动范围

3. 查看实验状态

bash
kubectl get chaosblade -n chaosblade
# 输出示例：
# NAME                  CREATED AT
# delete-pod-example    2024-05-20T08:30:00Z

查看实验详情：

bash
kubectl describe chaosblade delete-pod-example -n chaosblade

4. 停止实验

删除 ChaosBlade 资源即可终止实验：

bash
kubectl delete chaosblade delete-pod-example -n chaosblade

配置参数说明

实验配置核心参数

环境变量配置

ChaosBlade Operator 支持通过环境变量调整行为，部署时可在 Operator Deployment 中配置：

注意事项

• 生产环境建议先在测试集群验证实验效果，避免影响业务可用性。
• 实验前需明确目标资源范围，使用标签、命名空间等匹配器精准定位，减少范围外影响。
• 长时间运行的实验需设置合理的 duration 参数，避免资源持续占用。
• 如需自定义故障类型，可通过 ChaosBlade 自定义插件扩展（需重新构建镜像）。