Введение в модули

Модули (также называемые «задачи-плагины» или «плагины-библиотеки») представляют собой дискретные блоки кода, которые можно использовать из командной строки или в задаче playbook. Ansible выполняет каждый модуль, обычно на удалённом целевом узле, и собирает значения возврата.

Вы можете выполнить модули из командной строки:

ansible webservers -m service -a "name=httpd state=started"
ansible webservers -m ping
ansible webservers -m command -a "/sbin/reboot -t now"

Каждый модуль поддерживает передачу аргументов. Почти все модули принимают key=value аргументы, разделенные пробелами. Некоторые модули не принимают аргументы, а модули команд/оболочки просто принимают строку с командой, которую вы хотите выполнить.

Из playbook Ansible модули выполняются очень похожим образом:

- name: reboot the servers
  action: command /sbin/reboot -t now

Что можно сократить до:

- name: reboot the servers
  command: /sbin/reboot -t now

Другой способ передачи аргументов модулю — использование синтаксиса YAML, также называемого «сложные аргументы»

- name: restart webserver
  service:
    name: httpd
    state: restarted

Все модули возвращают данные в формате JSON. Это означает, что модули могут быть написаны на любом языке программирования. Модули должны быть идемпотентными и должны избегать внесения изменений, если они обнаруживают, что текущее состояние соответствует желаемому конечному состоянию. При использовании в playbook Ansible, модули могут вызывать «события изменения» в виде уведомления «обработчиков» для выполнения дополнительных задач.

Документацию по каждому модулю можно получить из командной строки с помощью инструмента ansible-doc:

ansible-doc yum

Список всех доступных модулей см. в Документации модулей, или выполните следующую команду в командной строке:

ansible-doc -l