Зарегистрируйтесь для доступа к 15+ бесплатным курсам по программированию с тренажером

Обработчики (Handlers) Основы автоматизации в Ansible

При выполнении задач в плейбуках периодически возникает необходимость перезапускать какой-либо сервис. Например, при обновлении конфигурационного файла. Простое решение - написать две обычные задачи. Одна из них будет обновлять конфиг, а вторая делать рестарт. И это будет работать, но есть одна проблема: рестарт произойдет в любом случае, даже если конфиг не изменится. В некоторых случаях такое поведение нежелательно, и в принципе это не очень красиво.

Чтобы этого избежать, в Ansible существует механизм, который называется handlers. Воспользуемся им:

  1. На верхнем уровне, где определены хосты и список задач, добавляем ещё один ключ с именем handlers и внутри него описываем набор задач. Причём в данном случае обязательно, чтобы задачи содержали имя.

  2. Связываем таски, которые могут порождать изменения, с задачами из секции handlers. Для этого с помощью ключа notify обращаемся к хендлерам по их именам:

- hosts: webservers
  tasks:
    - name: install nginx
      ansible.builtin.apt:
        name: nginx
        state: latest
      become: yes

    - name: update nginx config
      ansible.builtin.copy:
        src: files/nginx.conf
        dest: /etc/nginx/nginx.conf
      notify:
        - restart nginx
      become: yes

  handlers:
    - name: restart nginx
      ansible.builtin.service:
        name: nginx
        state: reloaded
      become: yes

Теперь если задача по обновлению конфига произведёт изменения, то будет вызван связанный с ней handler, который перезапустит nginx. Важно помнить, что он будет отработан не сразу, а только когда завершится весь сценарий. Это имеет значение. Ведь плейбук может содержать много задач, которые потребуют рестарта nginx. И делать это каждый раз не нужно. Достаточно будет одного перезапуска в самом конце.

Запустим наш плейбук и посмотрим, как это работает:

ansible-playbook playbook.yml -i inventory.ini

Как видим после изменения конфига был вызван handler:

RUNNING HANDLER [restart nginx] *****************************
changed: [ec2-18-216-178-214.us-east-2.compute.amazonaws.com]

Если же запустить сценарий повторно, то конфиг не поменяется и nginx не будет перезапущен.


Самостоятельная работа

Создайте новый плейбук, опишите в нём установку и настройку Nginx для отображения HTML странички. Для этого реализуйте следующие задачи:

  1. Установка nginx
  2. Копирование файла по пути /usr/share/nginx/html/index.html со следующим содержимым:

    <!DOCTYPE html>
    <html lang="en">
    <head>
      <meta charset="UTF-8">
      <meta http-equiv="X-UA-Compatible" content="IE=edge">
      <meta name="viewport" content="width=device-width, initial-scale=1.0">
      <title>Hello World!</title>
    </head>
    <body>
      <h1>Hello World!</h1>
    </body>
    </html>
    

    Содержимое этого файла будет выводиться Nginx.

  3. Копирование файла конфигурации по адресу /etc/nginx/nginx.conf:

    events {
    
    }
    
    http {
      server {
        listen 80 default_server;
      }
    }
    
  4. Обработчик перезапуска сервиса Nginx, если изменился конфигурационный файл.

    Файлы для копирования должны находиться в директории files/

На этом основная настройка завершена. Можно попробовать открыть нашу страницу.

  1. Выполните плейбук. Если всё выполнилось успешно, по адресу http://SERVER_IP должна быть доступна страница с текстом Hello, World!. Выполните плейбук повторно, без изменений.
  2. Измените конфигурационный файл Nginx, измените listen 80 на listen 8080. Выполните плейбук и откройте страницу по адресу http://SERVER_IP:8080 (с указанием порта)
  3. Залейте изменения на Github

Дополнительные материалы

  1. Handlers / Документация Ansible

Аватары экспертов Хекслета

Остались вопросы? Задайте их в разделе «Обсуждение»

Вам ответят команда поддержки Хекслета или другие студенты.

Ошибки, сложный материал, вопросы >
Нашли опечатку или неточность?

Выделите текст, нажмите ctrl + enter и отправьте его нам. В течение нескольких дней мы исправим ошибку или улучшим формулировку.

Что-то не получается или материал кажется сложным?

Загляните в раздел «Обсуждение»:

  • задайте вопрос. Вы быстрее справитесь с трудностями и прокачаете навык постановки правильных вопросов, что пригодится и в учёбе, и в работе программистом;
  • расскажите о своих впечатлениях. Если курс слишком сложный, подробный отзыв поможет нам сделать его лучше;
  • изучите вопросы других учеников и ответы на них. Это база знаний, которой можно и нужно пользоваться.

Об обучении на Хекслете

Для полного доступа к курсу нужен базовый план

Базовый план откроет полный доступ ко всем курсам, упражнениям и урокам Хекслета, проектам и пожизненный доступ к теории пройденных уроков. Подписку можно отменить в любой момент.

Получить доступ
900
упражнений
2000+
часов теории
3200
тестов

Открыть доступ

Курсы программирования для новичков и опытных разработчиков. Начните обучение бесплатно.

  • 130 курсов, 2000+ часов теории
  • 900 практических заданий в браузере
  • 360 000 студентов
Даю согласие на обработку персональных данных, соглашаюсь с «Политикой конфиденциальности» и «Условиями оказания услуг»

Наши выпускники работают в компаниях:

Логотип компании Альфа Банк
Логотип компании Aviasales
Логотип компании Yandex
Логотип компании Tinkoff

Используйте Хекслет по максимуму!

  • Задавайте вопросы по уроку
  • Проверяйте знания в квизах
  • Проходите практику прямо в браузере
  • Отслеживайте свой прогресс

Зарегистрируйтесь или войдите в свой аккаунт

Даю согласие на обработку персональных данных, соглашаюсь с «Политикой конфиденциальности» и «Условиями оказания услуг»