Что получим в итоге и с чего начинаем
Ansible на Ubuntu 24.04 ставится на один управляющий узел (control node). Агент на управляемые серверы не нужен: Ansible подключается по SSH, а модули выполняет через Python на целевом хосте. От управляемых машин нужны SSH-доступ, интерпретатор Python 3 и учётная запись с подходящими правами.
Цель руководства - предсказуемая рабочая среда, а не одна команда установки. К концу у вас будет установленный Ansible, каталог проекта с inventory, ansible.cfg и group_vars, вход по ключу под пользователем deploy и две проверки: ansible --version и ansible all -m ping.
План работ:
- Обновить систему и подготовить пользователя с sudo.
- Настроить SSH-ключи для входа без пароля.
- Установить Ansible через apt или pipx.
- Создать структуру проекта: inventory, ansible.cfg, group_vars.
- Разобрать параметры ansible.cfg и роль переменной ANSIBLE_CONFIG.
- Проверить среду и пройти чек-лист ошибок подключения.
Команды даны для Ubuntu 24.04 и Debian-семейства, где используется apt. На AlmaLinux и Rocky вместо apt работает dnf, а вместо ufw - firewalld; базовый порядок подготовки сервера с такой оговоркой приведён в чек-листе по настройке VPS. Все адреса и имена в примерах - заглушки: 192.0.2.10, 192.0.2.11 и 192.0.2.12 из документационного диапазона, пользователь deploy. Приватные ключи и пароли в конфиги не попадают.
Подготовка сервера Ubuntu 24.04 перед установкой Ansible
Начните с обновления индексов и пакетов: образ мог лежать неделями, и установка из устаревших индексов даёт неожиданные версии зависимостей.
apt update && apt upgrade -y
Если обновилось ядро, появится файл /var/run/reboot-required, и перезагрузку лучше не откладывать.
Постоянная работа под root не нужна. Создайте обычного пользователя и выдайте ему права администратора:
adduser deploy usermod -aG sudo deploy
Членство в группе применяется после повторного входа в систему. Обновление системы и отдельный пользователь в группе sudo - базовая последовательность первичной настройки сервера.
Проверка: команда id deploy показывает группу sudo, а sudo -v под deploy проходит без ошибок.
Затем проверьте Python на управляемых узлах: python3 --version. В Ubuntu 24.04 он есть по умолчанию, но минимальные образы и контейнеры иногда идут без него. Без Python модули Ansible на хосте не выполнятся, и ping вернёт ошибку интерпретатора.
Правки sshd и файрвола на удалённом сервере могут отрезать доступ. Держите открытую сессию, проверяйте вход в новом окне, а на продакшене сначала прогоняйте изменения на тестовом хосте.
Установка Ansible на Ubuntu 24.04: apt или pipx
Рабочих путей два: пакет из репозитория Ubuntu и изолированная установка через pipx. Разница в контроле версии и в схеме обновлений.
| Критерий | apt | pipx |
|---|---|---|
| Источник | репозиторий Ubuntu | PyPI |
| Обновление | вместе с системой, apt upgrade | pipx upgrade ansible |
| Контроль версии | ограничен релизом дистрибутива | можно зафиксировать нужную версию |
| Изоляция | системные пакеты | отдельное venv-окружение |
| Когда выбирать | нужен минимум действий, версия не критична | нужна конкретная версия или несколько окружений |
Установка через apt
Пакет ansible входит в репозиторий Ubuntu 24.04 (noble/universe) и ставится одной командой. Версия в репозитории может отставать от upstream: на момент подготовки материала самой свежей в стандартных репозиториях Ubuntu 24.04 была v9.4.0, но актуальный номер проверяйте на своей системе.
apt update apt install ansible ansible --version
Пакет подтягивает зависимости Python сам. Обновление системы обновит и Ansible. Посмотреть, какие версии пакета доступны в подключённых репозиториях, можно командой:
apt-cache policy ansible
Если нужна более новая версия, чем в репозитории, используйте pipx.
Установка через pipx
pipx ставит Python-приложения в отдельное окружение, поэтому Ansible не смешивается с системными пакетами Python. Точный набор команд pipx сверяйте с документацией pipx для вашей версии Ubuntu: в материалах, на которые опирается статья, команды pipx не подтверждены, поэтому ниже приведён только общий порядок без гарантии конкретного синтаксиса.
- Установите pipx штатным пакетным менеджером Ubuntu.
- Убедитесь, что каталог с исполняемыми файлами pipx есть в PATH (обычно это настраивается при первом запуске pipx).
- Установите ansible через pipx и проверьте ansible --version.
Обновление в этом случае выполняется средствами pipx, а не apt. Нужна конкретная версия - фиксируйте её при установке, подставив номер.
Не устанавливайте Ansible через pip install в системный Python: современные версии pip не рекомендуют глобальную установку пакетов и предлагают виртуальное окружение (python3 -m venv). Нужен pip - работайте внутри venv или через pipx.
Не держите apt-версию и pipx-версию одновременно: какая запустится, решит PATH. Проверьте which -a ansible. При переходе сначала удалите пакет: apt remove ansible.
Структура проекта Ansible: inventory, ansible.cfg, group_vars
Ansible ищет конфиг и inventory относительно текущего каталога, поэтому проект держите в отдельной папке, а команды запускайте из неё.
ansible-lab/
├── ansible.cfg
├── inventory
└── group_vars/
├── all.yml
└── web.yml
Файл inventory: пример и группировка хостов
[web] web1 ansible_host=192.0.2.10 web2 ansible_host=192.0.2.11 [db] db1 ansible_host=192.0.2.12 [all:vars] ansible_user=deploy
Группа all существует всегда и включает все хосты файла, поэтому ansible all -m ping проверяет весь список сразу. Для старта достаточно одного тестового хоста: остальные добавляйте, когда ping проходит.
Пароли в inventory не пишем: аутентификация идёт по ключу. Параметр ansible_user задаёт пользователя SSH по умолчанию.
Проверка из каталога проекта: ansible-inventory --graph показывает дерево групп и хостов, ansible all --list-hosts - плоский список.
Каталог group_vars: зачем он нужен с первого дня
# group_vars/all.yml common_timezone: Europe/Moscow # group_vars/web.yml web_packages: - nginx
Файл all.yml применяется ко всем хостам, web.yml - только к группе web. Значения выше - примеры собственных переменных, подставьте свои. На старте каталог может быть почти пустым: структуру закладывают до первых плейбуков, иначе переменные расползаются по задачам и теряется единая точка правды.
Настройка SSH-ключей для беспарольного подключения
Ключ создаётся на управляющей машине, а не на сервере. Приватная часть остаётся у вас, открытая (.pub) копируется на управляемые узлы; об этом же говорит чек-лист по SSH-ключам.
ssh-keygen -t ed25519 -C "ansible-control" ssh-copy-id deploy@192.0.2.10
Парольную фразу задавать можно: ssh-agent избавит от ввода при каждом запуске. Приватный ключ из каталога ~/.ssh не копируйте на серверы.
Права на стороне хоста важны: если authorized_keys доступен группе и остальным шире, чем 600, OpenSSH проигнорирует ключи из этого файла. Владельцем домашнего каталога, ~/.ssh и authorized_keys должен быть сам пользователь. Стандартные значения - 700 для каталога и 600 для файла:
chmod 700 ~/.ssh chmod 600 ~/.ssh/authorized_keys
Проверить права можно командой stat -c "%a %n" ~/.ssh/authorized_keys: в выводе должно быть 600. В Debian и Ubuntu при включённой настройке StrictModes sshd дополнительно проверяет владельца и права доступа к критичным путям и отклоняет вход при подозрительной конфигурации.
Проверка без запроса пароля: подключитесь к хосту в новом окне и убедитесь, что вход по ключу проходит без пароля. Отключать парольную аутентификацию до этой проверки нельзя: в /etc/ssh/sshd_config.d/99-hardening.conf добавьте PasswordAuthentication no, затем выполните sshd -t и systemctl reload ssh. При ошибке в конфиге и закрытой второй сессии доступ теряется, поэтому держите резервный вход через консоль провайдера.
Пользователь в параметре remote_user должен совпадать с владельцем настроенного authorized_keys. Иначе Ansible ходит под другим пользователем и получает Permission denied (publickey).
Разбор ansible.cfg: inventory, remote_user, host_key_checking, forks
[defaults] inventory = ./inventory remote_user = deploy host_key_checking = True forks = 10
| Параметр | Что делает | Значение для старта | Чем рискуете |
|---|---|---|---|
| inventory | путь к файлу инвентаря относительно каталога проекта | ./inventory | неверный путь даёт ошибку парсинга или пустой список хостов |
| remote_user | пользователь SSH по умолчанию для управляемых узлов | deploy | несовпадение с настроенным ключом даёт Permission denied |
| host_key_checking | сверка ключа хоста с known_hosts | True | False снимает защиту от подмены хоста |
| forks | число параллельных процессов | 10 при небольшом списке | завышение нагружает control node и сеть |
Параметр forks: сколько параллельных подключений разумно
forks задаёт, сколько хостов Ansible обрабатывает одновременно. Поднимайте ступенями: 10, 20, 50, наблюдая за load average на управляющем узле, числом SSH-сессий и лимитами файловых дескрипторов. Универсального оптимума нет: значение зависит от мощности control node, сети и задержек до хостов. Значение по умолчанию сверяйте в ansible-config dump для своей версии Ansible.
host_key_checking: почему не стоит отключать навсегда
Проверка ключа хоста защищает от подмены сервера в сети. Значение False удобно в одноразовой лаборатории и опасно в продакшене: атака через подмену хоста на первом подключении останется незамеченной. Рабочий путь - один раз подключиться к хосту вручную, сверить отпечаток ключа, после чего запись останется в known_hosts и Ansible работает без запросов.
Если хост пересоздан и его ключ изменился, удалите устаревшую запись: ssh-keygen -R 192.0.2.10. Отключение проверки навсегда ради удобства не оправдано.
Проверка применённых настроек: ansible all --list-hosts из каталога проекта и ansible-config dump --only-changed, где видны параметры, отличающиеся от значений по умолчанию.
ANSIBLE_CONFIG: какой конфиг реально применяется
Переменная окружения ANSIBLE_CONFIG позволяет указать путь к конкретному файлу конфигурации. Это удобно в CI, где конфиг лежит вне рабочего каталога, и мешает при отладке: переменная, выставленная в старой сессии или в юните systemd, тихо подменяет проектный конфиг.
Полный порядок поиска конфигурации и приоритет источников сверяйте с официальной документацией Ansible для вашей версии: в материалах, на которые опирается статья, этот порядок не подтверждён, поэтому здесь он не приводится как точная последовательность.
echo $ANSIBLE_CONFIG ansible --version
В выводе ansible --version есть строка config file с путём к используемому файлу. Начните диагностику с неё, если настройки будто не применяются.
Проверка результата: ansible --version и ansible all -m ping
ansible --version
ansible [core 2.x] config file = /home/deploy/ansible-lab/ansible.cfg executable location = /usr/bin/ansible python version = 3.12.x
Номера версий зависят от способа установки, сверять нужно путь к config file: он должен указывать на конфиг проекта. Строка python version показывает интерпретатор управляющего узла.
ansible all -m ping
192.0.2.10 | SUCCESS => {
"changed": false,
"ping": "pong"
}
192.0.2.11 | UNREACHABLE! => {
"changed": false,
"msg": "Failed to connect to the host via ssh",
"unreachable": true
}
Модуль ping проверяет SSH-подключение и доступность Python на хосте, ICMP он не использует: сервер с закрытым ICMP может ответить pong. Строка SUCCESS с ping: pong означает готовность хоста, UNREACHABLE - проблему соединения или недоступный интерпретатор.
Если inventory вызывает сомнения, выполните ansible all --list-hosts. Пустой список говорит об ошибке в файле или пути, а не в SSH.
Чек-лист типичных ошибок подключения Ansible
| Симптом | Причина | Действие |
|---|---|---|
| Permission denied (publickey) | ключа нет в authorized_keys, неверные права ~/.ssh или другой remote_user | проверить права 700 и 600, сверить пользователя, повторить ssh-copy-id |
| UNREACHABLE, Failed to connect via ssh | неверный адрес или порт, sshd не слушает, блокирует файрвол | проверить ssh вручную, статус ufw на Ubuntu и Debian или firewalld на AlmaLinux и Rocky |
| Host key verification failed | ключа хоста нет в known_hosts или он изменился | подключиться вручную и сверить отпечаток, устаревшую запись удалить через ssh-keygen -R |
| Unable to parse inventory | синтаксическая ошибка или неверный путь в ansible.cfg | проверить путь и формат файла, прогнать ansible-inventory --graph |
| No hosts matched | группа или хост не описаны в inventory | добавить хост в нужную группу, проверить имя группы в команде |
| Применяется не тот конфиг | задана переменная ANSIBLE_CONFIG или команда запущена из другого каталога | сверить echo $ANSIBLE_CONFIG и строку config file в ansible --version |
| Python not found на управляемом узле | на хосте нет python3 | установить Python штатным пакетным менеджером, проверить python3 --version |
Перед правкой sshd и правил файрвола на удалённом сервере сохраните резервный доступ: вторая сессия, консоль провайдера или тестовый хост. После каждого исправления повторяйте ansible all -m ping до устойчивого SUCCESS по всем хостам.
Что дальше: от проверки к первым плейбукам
Среда готова: Ansible установлен, inventory и group_vars на месте, конфиг проверен. Первый плейбук кладите в тот же каталог и запускайте из него, чтобы подхватывался проектный ansible.cfg. Роли добавляйте в roles/, дополнительные inventory - рядом с основным файлом.
Перед каждым изменением инфраструктуры повторяйте smoke-тест: ansible --version и ansible all -m ping. Две команды занимают секунды и отделяют проблему конфигурации от проблемы доступа.
- Руководство по Ansible для управления конфигурациями: структура инвентаря и ролей, первый плейбук, идемпотентность и Ansible Vault.
- Плейбуки вместо bash-скриптов: идемпотентный сценарий для Nginx и прокси, проверки и откат перед выкаткой.
- Ansible и Terraform: какой инструмент закрывает provisioning, а какой - управление конфигурациями.