Version: 2.1.4

定义实验范围

本篇文档描述如何为单个混沌实验定义实验范围，帮助你准确地控制故障爆炸半径。

简介

在 Chaos Mesh 中，你可以通过指定选择器 (Selectors) 的方式定义单个混沌实验的作用范围。

不同类型的 Selector 对应着不同的过滤规则。你可以在一个混沌实验中指定一个或多个 Selector 来定义你的实验范围。如果同时指定多个 Selector，代表当前实验目标需要同时满足所有指定的 Selectors 的规则。

在创建混沌实验时，Chaos Mesh 支持以下两种定义混沌实验范围的方式。你可以按需选择以下任一方式：

  • 在 YAML 配置文件中定义实验范围
  • 在 Dashboard 上定义实验范围

在 YAML 配置文件中定义实验范围

本小节提供了不同类型的 Selectors 的含义、用法、在 YAML 文件中的配置示例。在 YAML 配置文件中定义实验范围时，你可以按照实验范围的过滤需求指定一个或多个 Selectors。

Namespace Selectors

  • 指定实验目标 Pod 所属的命名空间。
  • 数据类型：字符串数组类型。
  • 如果此 Selector 为空或者不指定此 Selector，Chaos Mesh 会将其设置为当前混沌实验所属的命名空间。

当使用 YAML 文件创建实验时，示例配置如下：

  1. spec:
  2.   selector:
  3.     namespaces:
  4.       - 'app-ns'

Label Selector

  • 指定实验目标 Pod 需要带有的 Labels。
  • 数据类型：键值对类型。
  • 如果指定了多个 Labels，代表实验目标需要带有此 Selector 指定的所有 Labels。

当使用 YAML 文件创建实验时，示例配置如下：

  1. spec:
  2.   selector:
  3.     labelSelectors:
  4.       'app.kubernetes.io/component': 'tikv'

Expression Selector

  • 指定一组定义 Label 规则的表达式用来限定实验目标 Pod。
  • 你可以通过此 Selector 设置不满足某些 Labels 的实验目标 Pod。

当使用 YAML 文件创建实验时，示例配置如下：

  1. spec:
  2.   selector:
  3.     expressionSelectors:
  4.       - { key: tier, operator: In, values: [cache] }
  5.       - { key: environment, operator: NotIn, values: [dev] }

Annotation Selector

  • 指定实验目标 Pod 需要带有的 Annotations。
  • 数据类型：键值对类型。
  • 如果指定了多个 Annotations，代表实验目标需要带有此 Selector 指定的所有 Annotations。

当使用 YAML 文件创建实验时，示例配置如下：

  1. spec:
  2.   selector:
  3.     annotationSelectors:
  4.       'example-annotation': 'group-a'

Field Selector

  • 指定实验目标 Pod 的 Fields。
  • 数据类型：键值对类型。
  • 如果指定了多个 Fields 字段，代表实验目标需要带有此 Selector 设置的所有 Fields。

当使用 YAML 文件创建实验时，示例配置如下：

  1. spec:
  2.   selector:
  3.     fieldSelectors:
  4.       'metadata.name': 'my-pod'

PodPhase Selector

  • 指定实验目标 Pod 的 Phase。
  • 数据类型：字符串数组类型。
  • 支持的 Phase 有：Pending、Running、Succeeded、Failed、Unknown。
  • 此选项默认为空，意味不限制目标 Pod 的 Phase。

当使用 YAML 文件创建实验时，示例配置如下：

  1. spec:
  2.   selector:
  3.     podPhaseSelectors:
  4.       - 'Running'

Node Selector

  • 指定实验目标 Pod 所属的 Node 的 Labels。
  • 数据类型：键值对类型。
  • 如果指定了多个 Node Labels，代表实验目标 Pod 所属的 Node 需要带有此 Selector 指定的所有 Labels。

当用户通过 YAML 文件创建实验，配置如下：

  1. spec:
  2.   selector:
  3.     nodeSelectors:
  4.       'node-label': 'label-one'

Node List

  • 指定实验目标 Pod 所属的 Node。
  • 数据类型： 字符串数组。
  • 目标 Pod 只需属于配置的 Node 列表中的其中一个 Node 即可。

当使用 YAML 文件创建实验时，示例配置如下：

  1. spec:
  2.   selector:
  3.     nodes:
  4.       - node1
  5.       - node2

Pod List

  • 指定实验目标 Pod 命名空间和 Pod 列表。
  • 数据类型：键值对类型。”键”为目标 Pod 所属的 Namespace, “值”为目标 Pod 列表。
  • 只要指定了此 Selector，Chaos Mesh 就会忽略其他配置的 Selectors。

当使用 YAML 文件创建实验时，示例配置如下：

  1. spec:
  2.   selector:
  3.     pods:
  4.       tidb-cluster: # namespace of the target pods
  5.         - basic-tidb-0
  6.         - basic-pd-0
  7.         - basic-tikv-0
  8.         - basic-tikv-1

在 Dashboard 上定义实验范围

如果使用 Chaos Dashboard 创建混沌实验，你可以在填写实验信息时配置混沌实验范围。

目前 Chaos Dashboard 上提供了以下 Selectors。可以按照实验范围的过滤需求指定一个或多个 Selectors：

  • 命名空间选择器 (Namespace Selectors)
  • 标签选择器 (Label Selectors)
  • 注解选择器 (Annotation Selectors)
  • 阶段选择器 (Phase Selectors)。

在设置 Selectors 的同时，你也可以在 Dashboard 中实时预览实验目标的实际范围，并且可以直接修改 Selectors 过滤出的目标 Pod 范围。

Dashboard Selectors