Коротко о главном
Ansible позволяет описывать состояние серверов в YAML и применять его повторно. Не нужен агент: достаточно SSH и Python на целевой машине. Это снижает порог входа, но требует дисциплины в организации инвентаря и ролей.
Ручные правки на нескольких серверах быстро расходятся. Ansible делает конфигурацию воспроизводимой, документирует изменения и позволяет проверять результат.
Ansible — инструмент, который стоит освоить, если вы регулярно работаете в Linux. Ниже — путь от установки до уверенной повседневной работы: без предположений, что всё уже настроено само.
Зачем нужен Ansible
Ansible решает вполне конкретные задачи: Агентless-автоматизация настройки серверов через SSH и декларативные плейбуки. Важно не превращать инструмент в самоцель — если задача проще решается штатными средствами системы, начните с них.
Установка
В Debian, Ubuntu и Linux Mint используется пакетный менеджер APT:
sudo apt install ansible
В Fedora и RHEL-совместимых системах пакет ставится через DNF:
sudo dnf install ansible
В Arch Linux и производных пакет доступен в официальных репозиториях:
sudo pacman -S ansible
Пошаговая настройка
После установки переходите к базовому сценарию. Команды ниже выполняйте от пользователя с достаточными правами, но не запускайте всё под root без необходимости.
1. Создайте инвентарь
Начните с простого INI-файла. Группы помогают применять разные роли к веб-серверам и базам.
[web]
web1 ansible_host=203.0.113.10
[db]
db1 ansible_host=203.0.113.20
2. Проверьте подключение
Модуль ping проверяет SSH и Python, а не ICMP.
ansible all -i inventory.ini -m ping
3. Напишите первый плейбук
Плейбук описывает задачи декларативно. Указывайте state: present и не используйте shell без необходимости.
- hosts: web
become: true
tasks:
- name: Install nginx
apt:
name: nginx
state: present
4. Запустите с проверкой
Сначала —check, затем обычный запуск. Для отладки используйте -vvv, но не оставляйте высокий уровень в логах.
ansible-playbook -i inventory.ini site.yml --check
ansible-playbook -i inventory.ini site.yml
5. Секреты и роли
Пароли храните в ansible-vault, а повторяемые задачи выносите в роли. Не коммитьте расшифрованные секреты.
ansible-vault create secrets.yml
ansible-galaxy init roles/nginx
Базовая конфигурация
Начните с минимального рабочего варианта. Не копируйте большой конфиг целиком: добавляйте параметры по одному и проверяйте результат после каждого изменения.
[defaults]
inventory = ./inventory.ini
host_key_checking = True
Практические советы
Эти рекомендации проверены на повседневных задачах. Начните с тех, которые закрывают вашу текущую боль, а не со всего списка сразу.
Совет 1. Идемпотентность важнее скорости первого запуска.
Идемпотентность важнее скорости первого запуска.
Совет 2. Не храните SSH-пароли в инвентаре.
Не храните SSH-пароли в инвентаре.
Совет 3. Используйте отдельного пользователя для автоматизации.
Используйте отдельного пользователя для автоматизации.
Совет 4. Проверяйте плейбуки на тестовом стенде.
Проверяйте плейбуки на тестовом стенде.
Совет 5. Логируйте изменения и храните конфигурацию в Git.
Логируйте изменения и храните конфигурацию в Git.
Практический сценарий
Представьте типовую задачу: нужно развернуть Ansible на одной машине, проверить работу и передать доступ коллеге. Начните с чистой системы или снапшота, чтобы результат был воспроизводим. Запишите все команды в отдельный файл — это одновременно шпаргалка и черновик будущей автоматизации.
Дальше действуйте короткими шагами: установка, минимальная конфигурация, проверка, затем расширение. После каждого шага фиксируйте, что именно изменилось и как это проверить. Такой журнал экономит время, когда через месяц понадобится повторить настройку на другом сервере или объяснить её коллеге.
Порядок работ для этого сценария выглядит так:
- Создайте инвентарь
- Проверьте подключение
- Напишите первый плейбук
- Запустите с проверкой
- Секреты и роли
Отдельно продумайте, что произойдёт при сбое. Для Ansible важно заранее знать, где хранятся данные, как их скопировать и сколько времени займёт восстановление. Если ответа нет, не двигайтесь дальше: сначала закройте этот пробел, потом добавляйте новые возможности.
Типичные ошибки
Ниже — сбои, которые встречаются чаще всего. Перед исправлением сохраните текущие конфиги и запишите, какие изменения вносите: так проще откатиться.
1. UNREACHABLE
Проверьте SSH-ключи, адрес, пользователя и файрвол. Запустите ssh вручную с теми же параметрами.
2. Модуль не найден
Проверьте коллекцию и версию Ansible. Установите нужную коллекцию через ansible-galaxy.
3. Плейбук меняет всё при каждом запуске
Ищите shell/command без changed_when и задачи, не описывающие целевое состояние.
Что проверить перед вводом в работу
Перед тем как считать настройку завершённой, пройдитесь по короткому списку. Он не заменяет полноценный аудит, но отсекает большинство очевидных проблем.
Чек-лист
- Версия Ansible зафиксирована, а обновления не применяются вслепую.
- Есть резервная копия конфигурации и данных, восстановление проверено.
- Доступ ограничен нужными пользователями и сетями, лишние порты закрыты.
- Логи и метрики собираются, понятно, куда смотреть при сбое.
- Изменения описаны в документации и могут быть повторены на другой машине.
- Есть план отката и понятный критерий, по которому вы решите его применить.
Если какой-то пункт вызывает затруднение, это сигнал вернуться к соответствующему разделу, а не откладывать проверку. Настройка, которую нельзя повторить, плохо работает не только у коллег, но и у вас самих через полгода.
Итог
Ansible — это не «поставил и забыл». Рабочая конфигурация складывается из понимания задачи, аккуратной установки и проверки результата. Начните с базового сценария, затем добавляйте только те возможности, которые действительно используете.