Введение

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

Давайте рассмотрим, как выполнить три различных модуля из командной строки:

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

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

Из playbooks модули 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, хотя если вы используете командную строку или playbooks, вам особо не нужно знать об этом. Если вы пишете свой собственный модуль, это важно, и это означает, что вам не нужно писать модули на каком-либо конкретном языке — вы можете выбрать любой.

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

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

ansible-doc yum

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

ansible-doc -l