Если Ansible показал лишний сервер, остановите playbook до первой изменяющей task. Роль обычно не решает, на каких managed nodes работать: target задаёт строка hosts у текущего play, а inventory раскрывает имена групп. Параметр --limit только сужает уже выбранное множество и не исправляет слишком широкий hosts pattern.
Первый безопасный результат — список matching hosts без подключения к ним. Выполните --list-hosts в том же каталоге и под тем же пользователем, что и CI, с теми же -i, ansible.cfg, extra vars, tags и --limit. Иначе вы проверите другой inventory и получите успокаивающий, но бесполезный ответ.
Сначала распечатываем итоговый target
ansible-playbook -i inventories/prod site.yml --list-hosts
ansible-playbook -i inventories/prod site.yml --limit "web:&prod:!canary" --list-hosts
ansible-inventory -i inventories/prod --graph
ansible-inventory -i inventories/prod --host web-07Команды чтения используют условные пути и имена. --list-hosts выводит совпавшие узлы и не выполняет задачи; --graph показывает членство в группах; --host раскрывает переменные конкретного alias. Сохраните также вывод ansible-playbook --version: там видны версия, config file и module paths, которые помогают воспроизвести запуск.
Pattern читается как операция над группами
| Pattern | Кого выбирает | Частая ошибка |
|---|---|---|
| web:api | Объединение двух групп | Двоеточие принимают за AND |
| web:&prod | Только web, входящие в prod | Забывают амперсанд |
| all:!canary | Все, кроме canary | Shell интерпретирует ! без кавычек |
| web:&prod:!drain | Prod web без drain | Проверяют группы в другом inventory |
| --limit web-07 | Пересечение play target с одним alias | Ожидают, что limit расширит hosts |
Документация Ansible описывает : и запятую как объединение, & как пересечение, а ! как исключение. Поэтому hosts: web:prod выбирает обе группы, а не только production web. Alias тоже важен: если inventory называет узел web-07 и хранит IP в ansible_host, pattern должен совпадать с alias, а не обязательно с IP.
Лишний узел ищем в источнике членства
- Убедиться, что CI не передаёт несколько -i и не задаёт ANSIBLE_INVENTORY.
- Проверить children: родительская группа включает всех участников дочерней.
- Найти dynamic inventory plugin, который повторно добавил узел по tag или label.
- Сравнить alias, ansible_host и фактический hostname внутри системы.
- Проверить, нет ли второго play с более широким hosts: all.
- Отделить include_role/import_role от выбора target: включение роли наследует hosts текущего play.
Не удаляйте сервер из первой найденной группы, пока не понятен источник. Один host может законно состоять в web, prod и monitoring; исправление membership наугад изменит переменные и другие playbooks. Сначала отметьте, какой inventory source создал membership и какое правило должно было его исключить.
Tags меняют задачи, но не аудиторию play
--tags выбирает tasks, а не hosts. delegate_to выполняет отдельную task на делегированном узле, но переменная inventory_hostname продолжает относиться к исходному host. run_once берёт один узел из текущего batch. Эти механизмы могут создать впечатление неправильной группы, поэтому в callback log нужны play name, task name, inventory_hostname и delegated host отдельно.
Безопасный повтор делаем узким и наблюдаемым
- Зафиксировать исходную команду CI и commit inventory.
- Получить ожидаемый список через --list-hosts.
- Исправить hosts pattern или источник membership, а не маскировать ошибку постоянным limit.
- Повторить --list-hosts и сохранить diff списков.
- Запустить --check --diff только для модулей, которые поддерживают check mode.
- Сделать canary на одном ожидаемом alias и затем расширить запуск.
- Проверить recap: лишних и unreachable hosts нет.
Check mode пытается предсказать изменения, но не гарантирует отсутствие side effects у каждого модуля и не заменяет --list-hosts. Для production сначала нужен точный target, потом dry run и только затем ограниченный настоящий запуск. Постоянный --limit в scheduler хрупок: ручной запуск без него вернёт старую проблему.
Критерий исправления и откат
Исправление принято, когда одна и та же команда на зафиксированном inventory стабильно показывает только ожидаемые aliases, а CI сохраняет этот preflight как artifact. Если после изменения пропали нужные узлы, верните commit inventory или playbook, не запускайте роль частично и сравните membership через --graph. Для разбора подготовьте обезличенные inventory graph, play hosts, полную команду без секретов, config path и два списка hosts — до и после.