Provision
—— XP

Инвентарь, модули и ad-hoc команды

теория~5 минут+220 XP

Первое, что должен знать Ansible перед любой работой, — куда идти. Адреса машин, порты SSH, пользователь и ключ: всё это ты держал в ~/.ssh/config и в голове. Ansible хранит это в отдельном файле, и с него начинается каждый проект. В этом уроке ты разберёшь этот файл, узнаешь, чем Ansible действует на машинах, и выполнишь первую команду сразу на всей группе.

Этот файл называется инвентарь — записная книжка Ansible: какие машины есть, по каким адресам, как к ним подключаться и в какие группы они входят. Простейший инвентарь — текстовый файл в формате INI: группа пишется в квадратных скобках, а под ней — машины. Что делать с этими машинами, инвентарь не говорит, — это задают модуль с параметрами или целый плейбук.

Инвентарь вместе с модулями решает первую практическую задачу: выполнить одно и то же действие на всех нужных машинах одной командой, не заходя на каждую по SSH. Такие одноразовые команды называют ad-hoc.

Инвентарь

Посмотрим на инвентарь из будущей практики. Машина одна, но записана так же, как записывают двадцать.

inventory.ini
[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 — про файлы. Главное его отличие от команды: модуль сначала проверяет, что уже есть, и меняет только то, что не совпадает.

Модули на первый месяц
ping
Проверить подключение: SSH работает, Python запускается.
command и shell
Выполнить произвольную команду. Последнее средство: состояния они не знают.
apt
Поставить или удалить пакет.
copy и template
Положить файл на машину: готовый или собранный из шаблона.
file
Каталог, права, владелец, ссылка.
user
Завести или удалить пользователя.
service
Запустить, остановить, перезапустить службу.
lineinfile
Добавить строку в файл, если её там нет.

Полное имя модуля пишется с коллекцией — набором модулей: ansible.builtin.apt. Короткое apt тоже работает, но в плейбуках пишут полное, чтобы не перепутать с одноимённым модулем из чужой коллекции.

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

Ad-hoc команды

Ad-hoc команда — это вызов одного модуля на группе машин прямо из терминала. Её формат стоит запомнить: кому, каким модулем, с какими параметрами.

ubuntu@stand:~$
ansible all -m ping
ubuntu@stand:~$
target | SUCCESS => {
    "changed": false,
    "ping": "pong"
}

all — все машины инвентаря, -m — модуль. В ответе имя машины, итог SUCCESS и "changed": false — модуль ничего не менял. pong значит, что вся цепочка работает: SSH пустил, Python на той стороне запустился.

Параметры модулю передают флагом -a, а права root — флагом -b (become, «стать» root через sudo). Вот как поставить пакет:

ubuntu@stand:~$
ansible all -b -m apt -a 'name=curl state=present'
ubuntu@stand:~$
target | CHANGED => {
    "changed": true,
    ...
}

CHANGED — пакета не было, модуль его поставил. Запусти то же второй раз — ответ будет SUCCESS и "changed": false: пакет уже стоит, делать нечего. Это и есть главное свойство Ansible, о нём весь следующий урок.

Перед каждым запуском Ansible собирает факты — что он узнал о машине: дистрибутив, память, адреса. Их видно модулем setup, и на них можно опираться в условиях.

Словарь урока

Инвентарь
Список машин с группами и параметрами подключения. ↩ к тексту
ansible.cfg
Файл настроек. Ищется в текущем каталоге — команды запускают из каталога проекта.
Ad-hoc команда
Вызов одного модуля на группе машин прямо из терминала: ansible <кому> -m <модуль> -a <параметры>. ↩ к тексту
become
Выполнить действие от root через sudo. В ad-hoc — флаг -b. ↩ к тексту
Факты
То, что Ansible узнаёт о машине перед работой: система, память, адреса. ↩ к тексту

Что спросят на собеседовании

  • Как быстро проверить, что Ansible достучится до всех серверов?
    ansible all -m ping. Ответ pong значит, что работает SSH и запускается Python на той стороне.
  • Когда уместны модули command и shell?
    Когда для действия нет модуля. Они не знают состояния и выполняются каждый раз, поэтому их ограничивают условиями creates или changed_when.

Что дальше

Дальше — поднять машину для опытов и выполнить на ней первые ad-hoc команды.

Проверь себя+220 XPдве попытки
1
Инвентарь
За что отвечает инвентарь?
2
Ad-hoc команды
Что проверяет ansible all -m ping?
3
Модули
Почему вместо -m command -a 'apt install curl' берут модуль apt?
ответь на все вопросы, чтобы проверить

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.