Provision
—— XP

Инструменты: отладка Ansible и шпаргалка

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

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

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

Быстрая отладка: что сломалось

Упавший прогон почти всегда упирается в одно из трёх: не подключился, не разобрал файл, задача сделала не то. Эти пять команд проходят их по порядку.

из каталога ~/infra/ansible
ansible all --list-hosts          # какие машины он вообще видит
ansible all -m ping               # SSH и Python на месте?
ansible-playbook site.yml --syntax-check   # файл разбирается?
ansible-playbook site.yml --check --diff   # что изменится, не меняя
ansible-playbook site.yml -vvv    # подробно: SSH, параметры, ответы

--list-hosts пустой — ты не в том каталоге, и ansible.cfg не нашёлся. UNREACHABLE у ping — адрес, порт, ключ или пользователь. Ошибка YAML ловится --syntax-check с номером строки. А флаг -vvv — три уровня подробности — показывает, как именно шло подключение и что модуль получил на вход.

Ещё одна частая: прогон падает на середине длинного плейбука. Чтобы не ждать всё сначала, есть --start-at-task "имя задачи".

Шпаргалка раздела

Команды на каждый день.

на каждый день
ansible all -b -m apt -a 'name=htop'     # разово на всех машинах
ansible-playbook site.yml                 # применить описание
ansible-playbook site.yml --limit target2 # только одна машина
ansible-galaxy role init roles/имя        # скелет новой роли
ansible-vault encrypt_string -p --name pass # спросить и зашифровать
ansible lab -m setup -a 'filter=ansible_m*'  # факты о машинах

Флаги знакомы по практикам: -b — от root, -m — модуль, -a — его параметры, --limit — часть машин, --name — имя переменной для шифра, -p (prompt) — спросить значение, не показывая его: оно не попадёт ни в историю шелла, ни в файл. Без -p программа молча ждёт значение со входа, и лишний Enter перед Ctrl+D станет частью пароля. Последняя команда показывает факты, начинающиеся на ansible_m, — среди них объём памяти ansible_memtotal_mb.

И правило, которое важнее любой команды: после каждой правки — два прогона подряд, во втором changed=0.

Вокруг Ansible

Есть ещё несколько инструментов, которые встретишь в первые месяцы. Здесь достаточно знать, что такое есть.

ansible-lint проверяет плейбуки на типичные ошибки и плохие привычки: shell вместо модуля, задача без имени, права файла без кавычек. Его ставят задачей в конвейер раздела 12 — так же, как yamllint.

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

Ansible управляет не только Linux. Windows-серверами он командует по WinRM или по OpenSSH, для них есть свои модули с приставкой win_ (win_package, win_service); понадобятся, если в компании живут Windows Server и 1С.

AWX (бесплатная версия Ansible Automation Platform) и Semaphore — веб-интерфейсы, из которых плейбуки запускают кнопкой, с журналом и правами. А можно и без них: задача конвейера GitLab с образом, где стоит Ansible, ключом SSH в переменной типа File и паролем Vault в другой, — тот же выкат из раздела 12, только для настройки серверов.

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

-vvv
Подробный вывод: подключение, параметры модуля и его ответ.
--limit
Выполнить прогон только на части машин или групп.
ansible-lint
Проверка плейбуков на типичные ошибки. Ставится в конвейер. ↩ к тексту
Molecule
Тестирование роли на чистой машине в контейнере: прогон, повтор, проверка. ↩ к тексту

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

  • Как запускать Ansible из CI?
    Задачей в образе с Ansible: ключ SSH и пароль Vault — в защищённых переменных типа File, в merge request — только --check --diff, применение — из основной ветки по кнопке.
  • Как протестировать роль?
    Molecule: поднять чистую машину в контейнере, применить роль, применить второй раз и убедиться, что изменений нет, затем проверить результат.

Что дальше

Раздел закончен. Дальше — облако: где берутся сами машины, которые ты здесь настраивал.

Проверь себя+220 XPдве попытки
1
Быстрая отладка
Прогон пишет UNREACHABLE. Что проверить первым?
2
Быстрая отладка
Задача падает с непонятной ошибкой. Как увидеть подробности?
3
Вокруг Ansible
Что делает ansible-lint?
ответь на все вопросы, чтобы проверить

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