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

Модули (также называемые «плагинами задач» или «плагинами библиотек») — это дискретные единицы кода, которые могут использоваться из командной строки или в задаче плейбука. Ansible выполняет каждый модуль, обычно на удалённом управляемом узле, и собирает значения возврата. В Ansible 2.10 и более поздних версиях большинство модулей размещаются в коллекциях.

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

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

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

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

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

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

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

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

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

ansible-doc yum

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

ansible-doc -l