Если 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Все, кроме canaryShell интерпретирует ! без кавычек
web:&prod:!drainProd 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 отдельно.

Безопасный повтор делаем узким и наблюдаемым

  1. Зафиксировать исходную команду CI и commit inventory.
  2. Получить ожидаемый список через --list-hosts.
  3. Исправить hosts pattern или источник membership, а не маскировать ошибку постоянным limit.
  4. Повторить --list-hosts и сохранить diff списков.
  5. Запустить --check --diff только для модулей, которые поддерживают check mode.
  6. Сделать canary на одном ожидаемом alias и затем расширить запуск.
  7. Проверить 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 — до и после.

Проверенные источники