Handler в Ansible запускается не потому, что файл на сервере выглядит новым, а потому, что связанная задача вернула состояние changed и отправила уведомление через notify. Поэтому первый вопрос — не «работает ли systemd», а «увидел ли Ansible изменение и зарегистрировал ли нужный handler».

Начните с одного тестового хоста и подробного вывода. Найдите задачу шаблона или копирования: рядом с ней должно быть changed, а в конце play — выполнение handler. Если задача показывает ok, уведомление не создаётся. Если changed есть, но перезапуска нет, проверяйте имя, область роли и то, не завершился ли play ошибкой раньше очереди handlers.

Три точки, где обычно пропадает перезапуск

Что видно в выводеВероятная причинаСледующая проверка
Задача имеет статус okМодуль не обнаружил измененияСравнить источник шаблона, путь dest и checksum файла
Есть changed, но нет notifiednotify отсутствует или привязан к другой задачеПосмотреть итоговый YAML после include и условия when
Есть notified, но handler не выполненОшибка прервала play или handler затенёнПроверить последующие fatal и совпадающие имена handlers

Не ориентируйтесь только на время изменения файла. Модуль template сравнивает содержимое и может корректно вернуть ok, даже если playbook запускался повторно. Обратная проблема встречается у shell-команд: они часто возвращают changed каждый раз и вызывают лишние рестарты, если для них не задано точное changed_when.

Минимальная связка template и notify

- name: Render application config
  ansible.builtin.template:
    src: app.conf.j2
    dest: /etc/myapp/app.conf
    owner: root
    group: root
    mode: '0644'
  notify: Restart myapp

handlers:
  - name: Restart myapp
    ansible.builtin.service:
      name: myapp
      state: restarted

Строка в notify должна совпасть с именем handler либо с его listen-темой. Регистр, пробелы и фактически загруженные роли имеют значение. В большом проекте безопаснее дать обработчику уникальное имя роли или использовать устойчивую listen-тему, чтобы одинаковые имена из разных ролей не затеняли друг друга.

Почему ошибка после шаблона меняет картину

По умолчанию уведомлённые handlers выполняются после завершения соответствующей секции play. Если следующая задача завершается fatal, до перезапуска дело может не дойти. Не маскируйте это принудительным restart в каждой задаче: сначала исправьте ошибку или явно определите, должен ли handler выполняться при частичном применении конфигурации.

Если новый конфиг требуется уже следующей задаче, поставьте контролируемую точку `meta: flush_handlers` сразу после всех связанных изменений. Это осознанная граница, а не универсальная вставка: слишком ранний restart может поднять сервис с конфигурацией, которую роль ещё не закончила собирать.

- name: Apply pending handlers before health check
  ansible.builtin.meta: flush_handlers

- name: Verify local health endpoint
  ansible.builtin.uri:
    url: http://127.0.0.1:8080/health
    status_code: 200

Отделите «handler сработал» от «сервис принял настройки»

Успешный результат service state=restarted подтверждает выполнение команды управления, но не правильность нового конфига. Добавьте до рестарта проверку синтаксиса через validate, если модуль и сервис это поддерживают, а после — health check и чтение активной конфигурации. Тогда ошибка не превратится в формально зелёный деплой с неработающим приложением.

  • Первый запуск с реальным изменением должен показать changed и один restart.
  • Повтор без изменений должен завершиться без перезапуска.
  • Повреждённый тестовый конфиг должен остановиться до restart.
  • Изменение двух файлов, уведомляющих один handler, должно вызвать его один раз.

Что сохранить для разбора

Для диагностики подготовьте обезличенный фрагмент роли с task и handler, вывод запуска с `-vv`, путь итогового файла, результат `systemctl status` и команду проверки конфигурации сервиса. Секреты из vars и vault в журнал не копируйте. По этим данным можно отличить проблему определения changed от ошибки самого приложения.

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