
Инструмент для хаос-тестирования, эмуляции сети и стресс-тестирования контейнеров
Инструмент chaos-тестирования для Docker, containerd и Podman
Быстрый старт · Руководство пользователя · Сетевой хаос · Развёртывание · Участие в разработке
Pumba — это инструмент chaos-тестирования и сетевой эмуляции для контейнеров Docker, containerd и Podman. Вдохновлённый Netflix Chaos Monkey, Pumba привносит chaos-инженерию на уровень контейнеров — убивает, останавливает, приостанавливает и удаляет контейнеры, внедряет сетевые задержки и потери пакетов или проводит стресс-тестирование ресурсов контейнеров.
graph LR
A[Pumba CLI] -->|Docker API / containerd API / Podman compat API| B[Container Runtime]
B -->|List & Filter| C[Target Containers]
A -->|kill / stop / pause / rm| C
A -->|netem / iptables| D[Helper Container / Direct Exec]
D -->|Shares network namespace| C
D -->|Runs tc / iptables| E[Network Chaos]
| Среда выполнения | Сокет (по умолчанию) | netem / iptables / stress | Примечания |
|---|---|---|---|
| Docker | /var/run/docker.sock | Работает от root или при наличии доступа к сокету | Среда выполнения по умолчанию. |
| containerd | /run/containerd/containerd.sock | Требуется root (монтирование overlayfs для sidecar) | Пространства имён: k8s.io (Kubernetes), moby (управляемые Docker), default (чистый containerd). |
| Podman | /run/podman/podman.sock (rootful) | Требуется rootful Podman (иначе немедленный отказ) | Использует Docker-совместимый API Podman; на macOS pumba работает внутри podman machine (см. ниже). |
Pumba ориентирована на контейнеры Linux — каждое chaos-действие зависит от примитивов Linux (netns, cgroups v2, iptables, tc qdiscs, сокеты сред выполнения контейнеров). Выпускаемые бинарные файлы:
| ОС | amd64 | arm64 | Примечания |
|---|---|---|---|
| Linux | ✅ | ✅ | Основная цель. Запускайте pumba на том же ядре, что и целевые контейнеры. |
| macOS | ✅ | ✅ | Только для удобства разработчиков. Используйте для управления удалённой ВМ Docker/Podman/containerd (например, Colima, podman machine). |
| Windows | ❌ | ❌ | Не поддерживается и не планируется. См. ниже. |
Windows намеренно не собирается. Примитивы chaos — записи в Linux netns/cgroup, инъекция sidecar tc/iptables, пересылка POSIX-сигналов (SIGCONT/SIGSTOP/SIGUSR1/SIGUSR2, используемых средой выполнения containerd) — не имеют эквивалента в Windows. Нет правдоподобного сценария использования Windows даже с бэкендом WSL2 в Docker Desktop, поэтому бинарный файл для Windows не публикуется. PR, добавляющие поддержку Windows, не будут приняты; пожалуйста, запускайте pumba на Linux (нативно, в контейнере или в ВМ).
| Категория | Команды | Описание |
|---|---|---|
| Container Chaos | kill, stop, pause, rm, restart | Нарушение жизненного цикла контейнера |
| Execute | exec | Запуск команд внутри контейнеров |
| Network Delay | netem delay | Добавление задержки к исходящему трафику |
| Packet Loss | netem loss, iptables loss | Отбрасывание пакетов (исходящих и входящих) |
| Network Effects | netem duplicate, corrupt, rate | Дублирование, искажение или ограничение скорости пакетов |
| Combined Effects | netem combine | Применение нескольких эффектов в одном собственном netem qdisc |
| Stress Testing | stress | Нагрузка на CPU, память, I/O через stress-ng (дочерняя cgroup или инъекция в ту же cgroup) |
| Targeting | имена, regex (re2:), метки, --random | Гибкий выбор контейнеров; netem/iptables также предлагают опциональный --match-all |
| Scheduling | --interval | Повторяющийся chaos с фиксированными интервалами |
| Agents | schema, --output ndjson | Описание CLI в формате JSON; события результатов в stdout |
| Leftover check | status [--check], revert --run-id | Проверка сбоев и восстановление подходящих правил/sidecar-компонентов, помеченных run-id |
Скачайте последний релиз для вашей платформы или используйте Docker:
# Binary
curl -sL https://github.com/alexei-led/pumba/releases/latest/download/pumba_linux_amd64 -o pumba
chmod +x pumba
# Docker (recommended)
docker pull ghcr.io/alexei-led/pumba:latest
# Kill a random container matching "test" every 30 seconds
pumba --interval=30s --random kill "re2:^test"
# Add 3 seconds network delay to mydb for 5 minutes
pumba netem --duration 5m delay --time 3000 mydb
# Combine 100ms delay and 20% packet loss in one qdisc
pumba netem --duration 5m combine --delay --delay-time 100 --loss --loss-percent 20 -- mydb