Что на самом деле представляет собой модуль

Каждое действие Ansible выполняется через модуль — небольшую программу, которая умеет устанавливать пакет, копировать файл или перезапускать службу.

Каждый модуль обрабатывает один вид задач. Модуль copy копирует файлы, а модуль user управляет учётными записями. Объединяя их, вы выполняете более крупные задачи.

Ansible отправляет модуль на целевой узел, запускает его там, а затем получает результат. Управляющий узел не взаимодействует с управляемой системой напрямую.

Вы сообщаете модулю желаемое состояние, например present или started. Модуль сам определяет шаги, необходимые для его достижения.

Вы передаёте модулю аргументы в формате ключ-значение, описывающие желаемый результат. Каждый модуль точно документирует принимаемые ключи.

Запустите хороший модуль дважды — во второй раз он ничего не изменит. Сначала он проверяет текущее состояние, поэтому является идемпотентным и безопасен для повторного запуска.

Каждый модуль возвращает JSON, сообщая Ansible, были ли внесены изменения, выполнена ли операция успешно или произошла ошибка. Так в выводе появляются статусы ok, changed или failed.

Ansible поставляется с сотнями встроенных модулей в пространстве имён ansible.builtin: из коробки доступны средства для работы с файлами, пакетами, службами и многим другим.

Любой модуль можно вызвать из командной строки с помощью -m, без плейбука. Это удобно для быстрых разовых задач.

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

Современный стиль — использовать полное имя, например ansible.builtin.copy. Так сразу понятно, из какой коллекции происходит модуль.

Подумайте, благодаря чему модули Ansible безопасно запускать повторно.

Модуль — это небольшая программа, которая выполняет одну задачу на удалённом хосте, принимает аргументы, описывает желаемое состояние и возвращает надёжный результат. 🧩