Что понадобится и как устроена схема Ansible в Astra Linux
Ansible в Astra Linux 1.7 и 1.8 ставится на управляющий узел из репозитория дистрибутива или через pip в виртуальном окружении. Целевым хостам нужны Python 3, работающий SSH и пользователь с правом sudo. Связь проверяется inventory и модулем ping: ответ SUCCESS на команду ansible all -m ping означает, что схема собрана. Версия пакета ansible зависит от подключённых репозиториев, поэтому после установки смотрите вывод ansible --version, а не ориентируйтесь на номер из чужой инструкции.
Схема минимальна. Управляющий узел (control node) хранит inventory, ansible.cfg и playbook. Подключение к целевым хостам (managed nodes) идёт по SSH, модули выполняются интерпретатором Python на самой целевой машине. Агент не нужен, поэтому вся подготовка сводится к трём пунктам: SSH-доступ по ключу, Python 3 и права на выполнение задач.
В Astra Linux добавляются ограничения среды. Закрытый контур отрезает внешние репозитории и PyPI. Мандатный доступ и подсистема Parsec задают правила для пользователей и процессов. Механизмы мандатного управления доступом и мандатного контроля целостности реализованы в ядре Astra Linux Special Edition и затрагивают в том числе стек TCP/IP и файловые системы ext2/ext3/ext4/XFS, поэтому отказ может возникнуть не только на уровне файловых прав. Обход этих механизмов не решение задачи: правила согласовывают с администратором информационной безопасности, а Ansible настраивают так, чтобы он работал в разрешённых рамках. Ключи, SSH и sudo вы проверяете сами, вопросы мандатных правил и политик закрывает ИБ.
| Компонент | Требование | Как проверить |
|---|---|---|
| Ansible на управляющем узле | пакет из репозитория Astra Linux или установка в venv | ansible --version |
| Python 3 на управляющем узле | интерпретатор, который поддерживает выбранная версия Ansible | python3 --version |
| Python 3 на целевых хостах | нужен для выполнения модулей | ssh ansible@web1 "command -v python3" |
| SSH | sshd запущен, вход по ключу без пароля | ssh -i ~/.ssh/id_ed25519_ansible ansible@web1 true |
| sudo и become | у пользователя подключения есть право на нужные команды | ssh ansible@web1 "sudo -n true" |
| Сеть | порт 22 доступен с управляющего узла | ssh -o ConnectTimeout=5 ansible@web1 true |
| Мандатный доступ, Parsec | политики разрешают действия задачи | согласование с администратором ИБ, журналы аудита |
Чем Astra Linux отличается для Ansible: закрытый контур, мандатный доступ, Parsec
Закрытый контур. У управляющего узла нет выхода в интернет, поэтому пакет из репозитория дистрибутива удобнее pip: зависимости приходят из локального зеркала Astra Linux. Для pip понадобится внутреннее зеркало PyPI или заранее скачанные пакеты, собранные под тот же релиз и ту же версию Python. Проверка простая: apt-cache policy ansible показывает, откуда придёт пакет и какая версия доступна, а python -m pip download ansible на машине с доступом к зеркалу даёт набор файлов для офлайн-установки.
Мандатный доступ и Parsec. Мандатные атрибуты субъекта и объекта объединяются в мандатный контекст, а защита строится на уровнях и категориях конфиденциальности. Пользователь, от которого Ansible подключается к хосту, и повышение привилегий через become должны быть согласованы с этой политикой. become даёт полномочия sudo, но не расширяет мандатные права: задача может упасть с отказом доступа, хотя ssh и sudo работают. Отключать Parsec или мандатный контроль ради прохождения playbook нельзя. Согласуйте с администратором ИБ уровень доступа пользователя, перечень объектов, с которыми работают задачи, и учётную запись для become.
Ограничения подсистемы защиты. Мандатный контроль целостности и мандатное управление доступом в Astra Linux Special Edition — это не SELinux и не AppArmor, а собственная подсистема в ядре. При ошибках доступа смотрите журналы аудита и действующие политики, а не снимайте ограничения. Практическая граница: связь по SSH, наличие Python и работу sudo вы диагностируете сами, а расширение политик и мандатных правил обсуждаете с ИБ и фиксируете в заявке.
Установка управляющего узла Ansible в Astra Linux 1.7/1.8
Есть два рабочих пути: пакет из репозитория дистрибутива и pip в отдельном venv. Первый предпочтителен на боевом узле в закрытом контуре, второй даёт более свежую версию и изоляцию от системного Python.
Установка из репозитория Astra Linux
Пакет ansible доступен в репозитории Astra Linux и устанавливается штатным пакетным менеджером. Инструкция применима к Astra Linux Special Edition 1.7 и 1.8.
sudo apt update
apt-cache policy ansible
sudo apt install ansible
ansible --version
apt-cache policy показывает доступную версию и репозиторий, из которого придёт пакет. Если версия не устраивает или в вашем срезе репозитория пакета нет, обсудите с ИБ подключение репозитория обновлений Astra Linux вместо скачивания deb-файлов из интернета. В закрытом контуре нужен локальный репозиторий или офлайн-набор пакетов с зависимостями, собранный на машине с тем же релизом Astra Linux.
Учтите разницу между обновлениями: в Astra Linux Special Edition 1.8 при установке пакета конфигурационные файлы не создаются, и список хостов с настройками нужно подготовить вручную. В более ранних обновлениях, включая 1.7, при установке создаётся каталог /etc/ansible с файлами hosts (inventory) и ansible.cfg. Проверьте, что именно появилось у вас, до первого запуска.
Ожидаемый результат: ansible --version печатает версию ansible, версию ansible-core, путь к конфигурации и путь к python (например /usr/bin/python3). Если команда не найдена, пакет не установился: читайте вывод apt и список подключённых репозиториев.
Установка через pip в виртуальном окружении
python3 -m venv ~/venv-ansible
source ~/venv-ansible/bin/activate
python -m pip install --upgrade pip
python -m pip install ansible
ansible --version
Ansible ставится на управляющий узел с почти любой UNIX-подобной ОС при наличии Python, а для установки через pip нужно определить и запомнить путь к используемому интерпретатору. Управляемым хостам сам Ansible не нужен, но нужен Python для выполнения генерируемого кода. Конкретные поддерживаемые версии Python для выбранной версии ansible-core сверяйте в официальной документации Ansible: матрица поддержки меняется от релиза к релизу, и подставлять версию из чужой инструкции нельзя.
В закрытом контуре направьте pip на локальное зеркало: python -m pip install --index-url <URL локального зеркала> ansible. Адрес берите из документации вашего зеркала. Доступ к внутреннему индексу оформляйте отдельным конфигурационным файлом с ограниченными правами, реальные токены и пароли в общие конфиги не пишите.
Активацию venv повторяйте в каждой новой сессии, иначе оболочка возьмёт системный ansible или не найдёт его вовсе. В cron и systemd-юнитах вызывайте бинарник по полному пути, например /home/ansible/venv-ansible/bin/ansible-playbook. Ставить pip-пакеты в системный Python Astra Linux без необходимости не стоит: это меняет окружение системных утилит дистрибутива.
| Критерий | apt из репозитория | pip в venv |
|---|---|---|
| Закрытый контур | работает при наличии локального зеркала репозитория Astra | нужно локальное зеркало PyPI или заранее скачанные пакеты |
| Версия Ansible | определяется репозиторием дистрибутива | выбираете сами и обновляете независимо от ОС |
| Изоляция | пакет живёт в системе вместе с зависимостями | venv не затрагивает системный Python |
| Обновления | через apt вместе с остальной системой | через pip внутри окружения |
| Когда выбирать | типовой боевой узел в контуре | нужна конкретная версия ansible-core |
Подготовка целевых хостов: Python, SSH и sudo
На целевой машине с Astra Linux 1.7 или 1.8 нужны три вещи: Python 3, sshd с входом по ключу и пользователь, которому разрешён sudo на требуемые команды. Ansible сам находит интерпретатор, если python3 лежит в стандартном месте. Когда путь нестандартный или модуль не находится, путь задают явно переменной ansible_python_interpreter.
Учётные записи, ключи ed25519, ограничения по адресам и аккуратный sudoers разобраны в статье про управление пользователями и доступом на сервере. Перед первым запуском проверьте права каждого пользователя через sudo -l: если задача требует root, а sudo в неинтерактивном режиме не срабатывает, задачи с become упадут.
Как указать интерпретатор Python в inventory
Переменную задают на уровне группы или отдельного хоста. Пример для группы:
[astra:vars]
ansible_python_interpreter=/usr/bin/python3
Значение должно совпадать с реальным путём на целевом хосте. Проверьте его до запуска: ssh ansible@web1 "command -v python3". Если команда вернула /usr/bin/python3, пример подходит. Если путь другой, подставьте фактический. Когда на хостах уживаются несколько версий Python, путь лучше зафиксировать в inventory, чтобы результат не зависел от переменных окружения конкретной сессии.
Права и sudo: как работает become
become включает повышение привилегий на время задачи. Ansible использует существующие системы повышения привилегий, чтобы выполнять задачи с правами root или другого пользователя. По умолчанию используется sudo и пользователь root. Права берутся не из Ansible, а из политики sudo на целевом хосте.
- name: Установить nginx
ansible.builtin.apt:
name: nginx
state: present
update_cache: true
become: true
Если sudo требует пароль, запускайте playbook с ключом -K и вводите пароль интерактивно. Пароль в открытом виде в inventory не храните: для секретов есть Ansible Vault, практика работы с ним описана в руководстве по Ansible для управления конфигурациями.
В Astra Linux с включённым мандатным доступом become не отменяет мандатные правила: пользователь получает полномочия root и всё равно может не пройти проверку политики. Такие случаи разбирают с администратором ИБ и правят правила доступа к объекту, а не снимают защиту. Права 777 и отключение проверки ключей хоста проблему не решают и создают новую.
Inventory и ansible.cfg: готовый минимум для проверки связи
Ниже рабочий минимум для группы из двух хостов. Адреса взяты из диапазона документации 192.0.2.0/24, имя пользователя и путь к ключу подставьте свои.
[astra]
web1 ansible_host=192.0.2.10 ansible_user=ansible ansible_ssh_private_key_file=~/.ssh/id_ed25519_ansible
db1 ansible_host=192.0.2.11 ansible_user=ansible ansible_ssh_private_key_file=~/.ssh/id_ed25519_ansible
[astra:vars]
ansible_python_interpreter=/usr/bin/python3
Параметры читаются так. ansible_host задаёт адрес, если имя в inventory не совпадает с DNS-именем. ansible_user определяет пользователя SSH. ansible_ssh_private_key_file указывает на приватный ключ, публичная часть которого лежит в authorized_keys целевого хоста. ansible_python_interpreter фиксирует интерпретатор, если автоматическое определение даёт не тот путь.
Файл ansible.cfg в каталоге проекта перекрывает системный конфиг и читается первым, если переменная ANSIBLE_CONFIG не задаёт другой путь:
[defaults]
inventory = ./inventory
remote_user = ansible
host_key_checking = True
timeout = 30
[privilege_escalation]
become_method = sudo
inventory привязывает файл хостов к проекту, поэтому команды работают из любого подкаталога. remote_user задаёт SSH-пользователя по умолчанию. host_key_checking = True оставляет проверку ключа хоста включённой, это безопасное значение по умолчанию. timeout ограничивает ожидание подключения. become_method = sudo выбирает способ повышения привилегий, сам become включайте на уровне play или задачи, чтобы не выдавать лишние права всем действиям подряд.
Проверка SSH вручную до запуска Ansible
Отделите транспорт от Ansible. Подключитесь тем же пользователем и тем же ключом, что указаны в inventory: ssh -i ~/.ssh/id_ed25519_ansible ansible@192.0.2.10 true. Ожидаемый результат: команда завершается с кодом 0 и не спрашивает пароль. При первом подключении добавьте ключ хоста в known_hosts: ssh-keyscan 192.0.2.10 >> ~/.ssh/known_hosts, предварительно сверив отпечаток с администратором хоста. Если ssh не работает, Ansible не заработает тоже, и дальше диагностировать playbook бессмысленно.
Проверка связи через Ansible: ansible all -m ping. Ожидаемый вывод для каждого хоста содержит SUCCESS, строку "ping": "pong" и "changed": false. Если хост отвечает UNREACHABLE или задача падает, повторите с детализацией: ansible web1 -m ping -vvv. В логе видно, какой пользователь, какой ключ и какая команда Python использовались.
Типовые ошибки при подключении и выполнении задач: таблица симптомов и решений
Большая часть сбоев сводится к нескольким сообщениям: нет ключа, нет Python, не хватает прав, занят пакетный менеджер. Публичные разборы этих ошибок собраны на примерах Debian- и RHEL-подобных систем, поэтому команды установки пакетов и имена пакетов сверяйте с репозиториями Astra Linux. Сводный справочник сообщений и их причин приведён в разборе типовых ошибок Ansible, ниже адаптация под Astra Linux.
| Симптом | Причина | Действие | Проверка |
|---|---|---|---|
| UNREACHABLE, Failed to connect to the host via ssh | нет ключа, неверный пользователь, sshd недоступен | проверить ssh вручную, указать ключ и пользователя в inventory | ansible web1 -m ping -vvv |
| Host Key Verification Failed | ключ хоста отсутствует в known_hosts | добавить ключ через ssh-keyscan, сверить отпечаток | ssh ansible@web1 true |
| MODULE FAILURE, /usr/bin/python: not found | на целевом хосте нет Python | установить python3 из локального репозитория, при необходимости через модуль raw | ansible web1 -m ping |
| Failed to set permissions on the temporary files, Permission denied | пользователь подключения без sudo или задача без become | добавить become и проверить политику sudo | ssh ansible@web1 "sudo -n true" |
| No package matching 'X' found | устаревший кэш пакетов или неверное имя пакета | обновить кэш перед установкой, сверить имя в репозитории Astra | повторный запуск задачи |
| Failed to lock apt, Could not get lock /var/lib/dpkg/lock-frontend | параллельно работает apt, unattended-upgrades или другой playbook | дождаться освобождения блокировки, не удалять lock-файлы вслепую | pgrep -a apt |
| Undefined variable | переменная не задана в play, group_vars или аргументах | задать значение по умолчанию фильтром default или передать через -e | ansible-playbook --syntax-check |
| Handler not found | имя в notify не совпадает с именем handler | сверить строки посимвольно | повторный запуск playbook |
Ошибки SSH: UNREACHABLE и Host Key Verification Failed
Сообщение Failed to connect to the host via ssh и статус UNREACHABLE означают, что Ansible не смог установить сессию. Частые причины: ключ не скопирован на целевой хост, в inventory указан другой пользователь, sshd слушает не тот интерфейс или доступ закрыт фильтром. Порядок действий: проверить ssh вручную с теми же параметрами, затем указать ключ через ansible_ssh_private_key_file и повторить ansible web1 -m ping -vvv. Host Key Verification Failed лечится не отключением проверки, а добавлением ключа хоста в known_hosts после сверки отпечатка.
Ошибки Python и модулей: MODULE FAILURE и python not found
SSH работает, а задача падает с module_stderr "/bin/sh: 1: /usr/bin/python: not found". Значит, на целевом хосте нет интерпретатора, которым Ansible выполняет модули. Установите python3 из подключённого репозитория Astra Linux. Когда пакетного менеджера через обычные модули ещё нет, используют модуль raw: он выполняет команду напрямую через удалённую оболочку, не проходит через подсистему модулей и не требует Python на удалённой системе. Типичный случай его применения — как раз установка Python на машине, где его нет по умолчанию.
Пример с повышением привилегий: ansible web1 -m raw -a "apt install python3 -y" -b. Команда рассчитана на систему с apt и на имя пакета python3 в подключённом репозитории; в официальной документации raw пример приведён для dnf, поэтому перед запуском сверьте имя пакета с индексом репозитория Astra Linux. Если имя или менеджер пакетов отличаются, команда не сработает. После установки повторите ansible web1 -m ping и убедитесь в SUCCESS.
Ошибки прав и пакетного менеджера: Permission denied, lock apt, пакет не найден
Permission denied при установке прав на временные файлы означает, что у пользователя подключения нет нужных полномочий. Решение: become: true на задаче и проверка политики sudo через sudo -l. Права 777 как обходной путь не применяйте.
Failed to lock apt возникает, когда /var/lib/dpkg/lock-frontend занят другим процессом. Дождитесь завершения текущей операции, проверьте pgrep -a apt и только после этого повторяйте задачу. Удаление lock-файлов вручную может повредить базу dpkg, поэтому сначала убедитесь, что процессов apt нет, а на боевом хосте сделайте резервную копию состояния пакетов.
No package matching 'X' found появляется при устаревшем кэше или опечатке в имени. Включите update_cache: true у задачи apt и сверьте имя пакета с индексом репозитория Astra Linux. Проверка результата одна: повторный запуск задачи завершается статусом ok или changed без ошибки.
Ошибки playbook: Undefined variable и Handler not found
Undefined variable значит, что переменная не определена ни в play, ни в group_vars, ни в аргументах запуска. Задайте безопасное значение по умолчанию фильтром default или передайте параметр через -e. В примерах держите заглушки, а реальные секреты храните в Vault. Handler not found появляется, когда имя в notify не совпадает с именем handler: сверьте строки посимвольно, включая регистр и пробелы. Проверка: ansible-playbook --syntax-check перед запуском и точечный запуск задачи с тегом. Логика идемпотентных playbook и переход с bash-скриптов разобраны в материале про автоматизацию развёртывания с Ansible.
Чек-лист: от установки до рабочей схемы
- Способ установки выбран: пакет из репозитория Astra Linux или venv с pip. Проверка: ansible --version печатает версию и путь к python.
- На управляющем узле доступен Python 3, который поддерживает выбранная версия Ansible. Проверка: python3 --version.
- На каждом целевом хосте есть Python 3, sshd и пользователь с правом sudo. Проверка: ssh ansible@web1 "command -v python3" и ssh ansible@web1 "sudo -n true".
- Inventory заполнен: ansible_host, ansible_user, ansible_ssh_private_key_file. При нестандартном пути к интерпретатору задан ansible_python_interpreter.
- ansible.cfg минимален: inventory, remote_user, host_key_checking = True, timeout. become включается на уровне play или задачи.
- Ключ хоста добавлен в known_hosts через ssh-keyscan после сверки отпечатка.
- ansible all -m ping возвращает SUCCESS и "ping": "pong" для всех хостов группы.
- Ошибки из таблицы выше проверены по симптому, причина устранена, повторный запуск чистый.
- Деструктивные задачи, правки прав и изменения в пакетах сначала прогоняются на тестовой среде с резервной копией конфигов.
- Parsec, мандатный доступ и мандатный контроль целостности не отключены, спорные случаи согласованы с администратором ИБ.
Финальная проверка схемы занимает две команды: ansible --version и ansible all -m ping. Первая подтверждает версию и интерпретатор, вторая показывает, что все целевые хосты отвечают. После ввода узла в эксплуатацию пройдите чек-лист аудита безопасности Linux-сервера, чтобы проверить SSH, sudo и обновления до того, как playbook начнёт менять прод.