Первое, что должен знать Ansible перед любой работой, — куда идти. Адреса машин, порты SSH, пользователь и ключ: всё это ты держал в ~/.ssh/config и в голове. Ansible хранит это в отдельном файле, и с него начинается каждый проект. В этом уроке ты разберёшь этот файл, узнаешь, чем Ansible действует на машинах, и выполнишь первую команду сразу на всей группе.
Этот файл называется инвентарь — записная книжка Ansible: какие машины есть, по каким адресам, как к ним подключаться и в какие группы они входят. Простейший инвентарь — текстовый файл в формате INI: группа пишется в квадратных скобках, а под ней — машины. Что делать с этими машинами, инвентарь не говорит, — это задают модуль с параметрами или целый плейбук.
Инвентарь вместе с модулями решает первую практическую задачу: выполнить одно и то же действие на всех нужных машинах одной командой, не заходя на каждую по SSH. Такие одноразовые команды называют ad-hoc.
Инвентарь
Посмотрим на инвентарь из будущей практики. Машина одна, но записана так же, как записывают двадцать.
[lab] target ansible_host=127.0.0.1 ansible_port=2222 [lab:vars] ansible_user=ansible ansible_ssh_private_key_file=~/.ssh/ansible_lab
[lab] — группа. target — имя машины для Ansible, оно может не совпадать с настоящим. ansible_host и ansible_port — куда подключаться по SSH. Секция [lab:vars] задаёт переменные всей группе: каким пользователем входить и каким ключом. Всё это то же, что ты писал в ~/.ssh/config в разделе 03.
Чтобы не указывать файл инвентаря в каждой команде, рядом кладут ansible.cfg — файл настроек. Ansible ищет его в текущем каталоге, поэтому все команды запускают из каталога проекта. Запустил из другого — Ansible не нашёл настроек и ругнулся, что машин нет.
Только список адресов сам ничего на машинах не меняет. Менять будут маленькие программы, которые Ansible приносит с собой.
Модули
Модуль — маленькая программа, которая делает одно дело и знает, каким должен быть результат. Модуль apt знает про пакеты, user — про пользователей, copy — про файлы. Главное его отличие от команды: модуль сначала проверяет, что уже есть, и меняет только то, что не совпадает.
Полное имя модуля пишется с коллекцией — набором модулей: ansible.builtin.apt. Короткое apt тоже работает, но в плейбуках пишут полное, чтобы не перепутать с одноимённым модулем из чужой коллекции.
Писать файл ради проверки, что модуль вообще работает, незачем: для разовых действий Ansible хватает одной строки в терминале.
Ad-hoc команды
Ad-hoc команда — это вызов одного модуля на группе машин прямо из терминала. Её формат стоит запомнить: кому, каким модулем, с какими параметрами.
ansible all -m pingtarget | SUCCESS => { "changed": false, "ping": "pong" }
all — все машины инвентаря, -m — модуль. В ответе имя машины, итог SUCCESS и "changed": false — модуль ничего не менял. pong значит, что вся цепочка работает: SSH пустил, Python на той стороне запустился.
Параметры модулю передают флагом -a, а права root — флагом -b (become, «стать» root через sudo). Вот как поставить пакет:
ansible all -b -m apt -a 'name=curl state=present'target | CHANGED => { "changed": true, ... }
CHANGED — пакета не было, модуль его поставил. Запусти то же второй раз — ответ будет SUCCESS и "changed": false: пакет уже стоит, делать нечего. Это и есть главное свойство Ansible, о нём весь следующий урок.
Перед каждым запуском Ansible собирает факты — что он узнал о машине: дистрибутив, память, адреса. Их видно модулем setup, и на них можно опираться в условиях.
Словарь урока
Что спросят на собеседовании
- Как быстро проверить, что Ansible достучится до всех серверов?ansible all -m ping. Ответ pong значит, что работает SSH и запускается Python на той стороне.
- Когда уместны модули command и shell?Когда для действия нет модуля. Они не знают состояния и выполняются каждый раз, поэтому их ограничивают условиями creates или changed_when.
Что дальше
Дальше — поднять машину для опытов и выполнить на ней первые ad-hoc команды.