Настройка Ansible в Astra Linux 1.7 и 1.8: управляющий узел, целевые хосты и типовые ошибки | AdminWiki

Настройка Ansible в Astra Linux 1.7 и 1.8: управляющий узел, целевые хосты и типовые ошибки

19 ноября 2026 13 мин. чтения

Что понадобится и как устроена схема 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 или установка в venvansible --version
Python 3 на управляющем узлеинтерпретатор, который поддерживает выбранная версия Ansiblepython3 --version
Python 3 на целевых хостахнужен для выполнения модулейssh ansible@web1 "command -v python3"
SSHsshd запущен, вход по ключу без пароля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 вручную, указать ключ и пользователя в inventoryansible 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 из локального репозитория, при необходимости через модуль rawansible web1 -m ping
Failed to set permissions on the temporary files, Permission deniedпользователь подключения без sudo или задача без becomeдобавить become и проверить политику sudossh 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 или передать через -eansible-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.

Чек-лист: от установки до рабочей схемы

  1. Способ установки выбран: пакет из репозитория Astra Linux или venv с pip. Проверка: ansible --version печатает версию и путь к python.
  2. На управляющем узле доступен Python 3, который поддерживает выбранная версия Ansible. Проверка: python3 --version.
  3. На каждом целевом хосте есть Python 3, sshd и пользователь с правом sudo. Проверка: ssh ansible@web1 "command -v python3" и ssh ansible@web1 "sudo -n true".
  4. Inventory заполнен: ansible_host, ansible_user, ansible_ssh_private_key_file. При нестандартном пути к интерпретатору задан ansible_python_interpreter.
  5. ansible.cfg минимален: inventory, remote_user, host_key_checking = True, timeout. become включается на уровне play или задачи.
  6. Ключ хоста добавлен в known_hosts через ssh-keyscan после сверки отпечатка.
  7. ansible all -m ping возвращает SUCCESS и "ping": "pong" для всех хостов группы.
  8. Ошибки из таблицы выше проверены по симптому, причина устранена, повторный запуск чистый.
  9. Деструктивные задачи, правки прав и изменения в пакетах сначала прогоняются на тестовой среде с резервной копией конфигов.
  10. Parsec, мандатный доступ и мандатный контроль целостности не отключены, спорные случаи согласованы с администратором ИБ.

Финальная проверка схемы занимает две команды: ansible --version и ansible all -m ping. Первая подтверждает версию и интерпретатор, вторая показывает, что все целевые хосты отвечают. После ввода узла в эксплуатацию пройдите чек-лист аудита безопасности Linux-сервера, чтобы проверить SSH, sudo и обновления до того, как playbook начнёт менять прод.

Поделиться: