⚙️ Паровой сервер ROADIT

Ansible: Паровой двигатель автоматизации и его внутреннее устройство

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

В этой статье мы разберём архитектуру Ansible до последнего винтика, поймём, как устроен его «котёл», и научимся запускать первые плейбуки.

⚡ Важно

Состояние котла на октябрь 2026. Актуальная ветка движка — ansible-core 2.21: релиз в конце мая 2026, поддержка до 30 ноября 2027. Вокруг него собирается «большой» пакет ansible: текущая линейка сообщества — 14.x, зависящая от ядра 2.21. Все примеры в статье проверены на этой связке и написаны так, чтобы не ломаться при переходе на новые релизы.



Что такое Ansible?

Ansible — это инструмент управления конфигурациями и оркестрации с открытым исходным кодом, созданный Майклом ДеХааном (автором Cobbler и Func) и ныне развиваемый компанией Red Hat.

Главная философия Ansible — простота и отсутствие агентов. В отличие от Puppet или Chef, вам не нужно устанавливать демон на каждый управляемый сервер. Ansible работает поверх стандартного SSH (на Linux) или WinRM (на Windows), используя Python как «топливо» для выполнения задач.

Ключевые принципы:

  • Agentless — никаких демонов на клиентах.
  • Idempotent — многократное применение плейбука не ломает систему, если она уже в нужном состоянии.
  • Declarative (по модулям) — вы описываете желаемое состояние (state: present), а модуль сам решает, что нужно сделать. Но сам плейбук исполняется сверху вниз, так что это скорее «декларативные шестерёнки в императивном корпусе».
  • Push-based — управляющий сервер сам «толкает» конфигурации к узлам.
  • ansible-core — сам движок: CLI-утилиты (ansible, ansible-playbook, ansible-doc, ansible-vault и др.) и встроенные модули из пространства ansible.builtin.*.
  • ansible — «пакет с батарейками»: ядро плюс курируемый набор коллекций (community.general, ansible.posix, community.docker и сотни других).

Архитектура Ansible: из чего состоит паровая машина

Ansible — это не монолит, а набор взаимосвязанных компонентов. Разберём каждый «цилиндр» этого двигателя.

Control Node (Управляющий узел)

Это «кабина машиниста» — сервер или рабочая станция, с которой вы запускаете Ansible. Здесь хранятся:

  • Инвентаризационные файлы
  • Плейбуки
  • Роли
  • Шаблоны
  • Переменные

Требования:

  • ОС: любой Linux (RHEL-семейство, Ubuntu, Debian и т. д.) или macOS
  • Python: 3.12–3.14 на управляющем узле (в старых релизах планка была ниже: 3.8 для 2.12–2.13, 3.9 для 2.14–2.15, 3.10 для 2.16–2.17, 3.11 для 2.18–2.19, 3.12 для 2.20+)
  • Установленный Ansible

Windows не может быть Control Node нативно. Выход — WSL2: поставьте там Ubuntu и запускайте Ansible оттуда. Как управляемый узел Windows работает без проблем (WinRM или SSH).

⚡ Важно

Если ваш дистрибутив поставляется со «старым» Python (классика RHEL 8/9), ansible-core придётся ставить через pipx или ставить отдельный python3.12. Системный Python при этом не трогайте: на нём сидят dnf и сам дистрибутив.

Managed Nodes (Управляемые узлы)

Это «вагоны», которыми вы управляете. На них должен быть:

  • SSH-сервер (Linux/Unix) или WinRM/SSH (Windows)
  • Для Windows: PowerShell 5.1–7
  • Python для Linux/Unix: 3.9–3.14 для ansible-core 2.21

⚡ Важно

Ansible не требует установки специального ПО на managed nodes — достаточно стандартного SSH и Python.

А если на узле Python нет вообще (минималистичный контейнер, старый роутер)? Тогда в ход идёт модуль ansible.builtin.raw: он просто гонит команду по SSH без Python. Хватит, чтобы поставить Python и вернуться к нормальному режиму. Сетевое оборудование (Cisco, Juniper и т. п.) управляется другими connection-плагинами и на целевой стороне Python не требует.

Inventory (Инвентаризация)

Это «расписание движения поездов» — файл, в котором описаны все ваши серверы и их группировка.

Простой инвентарь (/etc/ansible/hosts или inventory.ini):

# Простой список хостов
web1.example.com
web2.example.com
db1.example.com

# Группировка по функциям
[webservers]
web1.example.com
web2.example.com

[dbservers]
db1.example.com

# Группировка по регионам
[moscow]
web1.example.com
db1.example.com

[piter]
web2.example.com

# Вложенные группы
[russia:children]
moscow
piter

# Переменные для группы
[webservers:vars]
http_port=80
max_requests=200

Динамический инвентарь строится на плагинах (amazon.aws.aws_ec2, azure.azcollection.azure_rm, community.vmware.vmware_vm_inventory и др.): вы описываете источник в небольшом YAML-файле, а Ansible сам получает список серверов. Самописные скрипты на Python/Bash тоже работают, но это уже путь «ручной сборки котла».

Тот же инвентарь в YAML-формате: он нагляднее при вложенных группах и переменных:

all:
  children:
    webservers:
      hosts:
        web1.example.com:
        web2.example.com:
      vars:
        http_port: 80
        max_requests: 200
    dbservers:
      hosts:
        db1.example.com:

Проверяем, как Ansible «видит» ваш парк:

ansible-inventory -i inventory.ini --graph
ansible-inventory -i inventory.ini --list

💡 Совет

Переменные групп и хостов выносите в каталоги group_vars/ и host_vars/ рядом с инвентарём, а не в [group:vars]. Файл инвентаря должен быть расписанием, а не склада запчастей.

Playbooks (Плейбуки)

Это «инструкция по эксплуатации» — YAML-файлы, описывающие желаемое состояние системы.

Пример простого плейбука (deploy_web.yml):

---
- name: Установка и настройка веб-сервера
  hosts: webservers
  become: true
  vars:
    http_port: 80
    document_root: /var/www/html
    web_stack:
      Debian: { package: nginx, service: nginx, user: www-data }
      RedHat: { package: httpd, service: httpd, user: apache }
    stack: "{{ web_stack[ansible_facts['os_family']] }}"

  tasks:
    - name: Обновить индекс пакетов (Debian)
      ansible.builtin.apt:
        update_cache: true
        cache_valid_time: 3600
      when: ansible_facts['os_family'] == "Debian"

    - name: Установить веб-сервер
      ansible.builtin.package:
        name: "{{ stack.package }}"
        state: present

    - name: Создать директорию для сайта
      ansible.builtin.file:
        path: "{{ document_root }}"
        state: directory
        owner: "{{ stack.user }}"
        group: "{{ stack.user }}"
        mode: "0755"

    - name: Развернуть индексную страницу
      ansible.builtin.copy:
        content: |
          <html>
          <head><title>RoadIT Steam Engine</title></head>
          <body><h1>Работает на Ansible!</h1></body>
          </html>
        dest: "{{ document_root }}/index.html"
        mode: "0644"

    - name: Запустить и включить сервис
      ansible.builtin.service:
        name: "{{ stack.service }}"
        state: started
        enabled: true

    - name: Открыть порт (firewalld, RHEL-семейство)
      ansible.posix.firewalld:
        port: "{{ http_port }}/tcp"
        permanent: true
        immediate: true
        state: enabled
      when: ansible_facts['os_family'] == "RedHat"

    - name: Открыть порт (ufw, Debian/Ubuntu)
      community.general.ufw:
        rule: allow
        port: "{{ http_port }}"
        proto: tcp
      when: ansible_facts['os_family'] == "Debian"
  • Различия между дистрибутивами вынесены в словарь web_stack: одна точка правки вместо россыпи when.
  • Установка идёт через универсальный ansible.builtin.package: он сам выберет apt/dnf. Отдельный apt остался только для обновления кэша.
  • Все обращения к фактам идут через ansible_facts[...] (подробности в разделе «Facts»).
  • Модули ansible.posix.firewalld и community.general.ufw лежат не в ansible-core, а в коллекциях. Если вы ставили пакет ansible, они уже есть. Если только ядро, доставьте: ansible-galaxy collection install ansible.posix community.general.
  • Если ufw у вас не используется, просто удалите последнюю задачу. Не надо включать файрвол ради красивого плейбука.

Modules (Модули)

Это «инструменты в ящике инженера» — готовые функции для выполнения конкретных задач. Ansible поставляется с тысячами модулей:

  • ansible.builtin.package — универсальная установка пакетов (сам выбирает apt/dnf)
  • ansible.builtin.apt / ansible.builtin.dnf — пакетные менеджеры конкретных семейств (yum на современных RHEL-системах всё равно работает через dnf)
  • ansible.builtin.copy / template — работа с файлами и Jinja2-шаблонами
  • ansible.builtin.service / systemd_service — управление сервисами
  • ansible.builtin.user / group — учётные записи
  • ansible.builtin.command / shell — выполнение команд (shell только когда нужны пайпы и редиректы)
  • ansible.builtin.file / lineinfile / blockinfile — файловая система и правка конфигов

Список всех модулей:

ansible-doc -l

Collections: где лежат остальные инструменты

В ansible-core живёт только ansible.builtin.*. Всё прочее (Docker, облака, сетевое железо, ufw, firewalld) поставляется в коллекциях, то есть в «грузовых вагонах» с модулями, плагинами и ролями.

ansible-galaxy collection list                         # что уже стоит
ansible-galaxy collection install community.docker     # поставить коллекцию
ansible-doc ansible.builtin.copy                       # документация модуля
ansible-doc -l | grep -i firewall                      # поиск модуля

Фиксируйте коллекции в requirements.yml, чтобы окружение собиралось одинаково у всей команды:

---
collections:
  - name: ansible.posix
  - name: community.general
ansible-galaxy collection install -r requirements.yml

Facts (Факты)

Это «датчики давления и температуры» — информация о системе, которую Ansible собирает автоматически перед выполнением задач.

Посмотреть факты о хосте:

ansible web1.example.com -m ansible.builtin.setup

Или получить конкретный факт:

ansible web1.example.com -m ansible.builtin.setup -a "filter=ansible_default_ipv4"

Примеры фактов:

  • ansible_facts['default_ipv4']['address'] — IP-адрес
  • ansible_facts['os_family'] — семейство ОС (Debian, RedHat)
  • ansible_facts['memtotal_mb'] — объём RAM в МБ
  • ansible_facts['processor_vcpus'] — количество vCPU

Факты можно использовать в плейбуках:

- name: Вывести информацию о системе
  ansible.builtin.debug:
    msg: >-
      Сервер {{ inventory_hostname }} работает на
      {{ ansible_facts['distribution'] }} {{ ansible_facts['distribution_version'] }}

💡 Совет

Код вида {{ ansible_distribution }} пока работает, но пишет deprecation-предупреждение. Привыкайте к ansible_facts[...] сразу, переучиваться на горячую в 2.24 будет неприятнее.

Сбор фактов занимает время. Если они вам не нужны, пишите gather_facts: false. Если нужны только базовые, то gather_subset: min.

Roles (Роли)

Это «стандартизированные модули паровоза» — способ организации плейбуков для повторного использования.

Структура роли:

roles/
└── nginx/
    ├── defaults/
    │   └── main.yml      # Переменные по умолчанию
    ├── files/            # Статические файлы
    ├── handlers/
    │   └── main.yml      # Обработчики (restart service)
    ├── meta/
    │   └── main.yml      # Метаданные роли
    ├── tasks/
    │   └── main.yml      # Основные задачи
    ├── templates/        # Jinja2-шаблоны
    │   └── nginx.conf.j2
    └── vars/
        └── main.yml      # Переменные роли

Не создавайте каркас вручную, у Ansible есть заготовка:

ansible-galaxy role init roles/nginx

А если роль нужна не всегда, подключайте её в нужном месте задач:

---
- hosts: webservers
  roles:
    - nginx
    - common

Установка Ansible: запускаем паровой двигатель

Есть три пути, от «привычного» к «чистому».

1. Пакет из репозитория (Ubuntu/Debian) — просто и надёжно, но версия будет немного отставать. Например, Ubuntu 26.04 поставляет community-пакет Ansible 13 с ansible-core 2.20.

sudo apt update
sudo apt install -y ansible
ansible --version

2. RHEL / Rocky / AlmaLinux — в AppStream лежит ansible-core; полный пакет ansible ищите в EPEL (проверьте dnf info ansible). Помните, что для ядра 2.20+ нужен Python 3.12, а на RHEL 9 это отдельный пакет python3.12.

sudo dnf install -y ansible-core
ansible --version

3. pipx — рекомендуемый способ для свежих версий. Ansible живёт в собственном виртуальном окружении и не конфликтует с системным Python:

sudo apt install -y pipx          # или: sudo dnf install -y pipx
pipx ensurepath                   # затем откройте новую сессию shell
pipx install --include-deps ansible

ansible --version                 # версия ansible-core
ansible-community --version       # версия пакета ansible

Флаг --include-deps обязателен: без него pipx не выставит команду ansible (она приходит из зависимости ansible-core). Обновление:

pipx upgrade --include-injected ansible

Настройка SSH-доступа

Ansible требует беспарольного SSH-доступа к управляемым узлам:

# Сгенерировать SSH-ключ (если ещё нет)
ssh-keygen -t rsa -b 4096 -f ~/.ssh/ansible_rsa

# Скопировать ключ на управляемый узел
ssh-copy-id -i ~/.ssh/ansible_rsa.pub admin@web1.example.com

# Проверить доступ
ssh -i ~/.ssh/ansible_rsa admin@web1.example.com

Настроить использование ключа в Ansible через ansible.cfg или inventory:

[all:vars]
ansible_ssh_private_key_file=~/.ssh/ansible_rsa
ansible_user=admin

Первый запуск: Ad-Hoc команды

Прежде чем писать плейбуки, попробуйте Ad-Hoc команды — разовые задачи, выполняемые напрямую из командной строки.

Проверка доступности хостов:

ansible all -m ansible.builtin.ping

Получение информации о системе:

ansible web1.example.com -m ansible.builtin.setup -a "filter=ansible_*_mb"

Выполнение команды:

ansible all -m ansible.builtin.command -a "uptime"

Установка пакета:

ansible webservers -m ansible.builtin.apt -a "name=nginx state=present" --become

Перезапуск сервиса:

ansible webservers -m ansible.builtin.service -a "name=nginx state=restarted" --become

Копирование файла:

ansible all -m ansible.builtin.copy -a "src=/local/file.txt dest=/remote/file.txt mode=0644" --become

Флаги:

  • -m — модуль
  • -a — аргументы модуля
  • --become — выполнить с правами root (sudo)
  • -i inventory.ini — использовать конкретный инвентарь

Запуск плейбука: от теории к практике

Создайте файл test_playbook.yml:

---
- name: Тестовый плейбук
  hosts: all
  gather_facts: yes
  
  tasks:
    - name: Вывести приветствие
      ansible.builtin.debug:
        msg: "Привет от {{ ansible_hostname }}!"
    
    - name: Проверить свободное место
      ansible.builtin.command: df -h /
      register: disk_usage
      changed_when: false
    
    - name: Показать результат
      ansible.builtin.debug:
        var: disk_usage.stdout_lines

Запустите:

ansible-playbook -i inventory.ini test_playbook.yml

С флагами для отладки:

# Подробный вывод
ansible-playbook -i inventory.ini test_playbook.yml -v

# Очень подробный вывод
ansible-playbook -i inventory.ini test_playbook.yml -vvv

# Проверка синтаксиса
ansible-playbook -i inventory.ini test_playbook.yml --syntax-check

# Dry-run (проверка без изменений)
ansible-playbook -i inventory.ini test_playbook.yml --check

# Выполнить только определённые задачи
ansible-playbook -i inventory.ini test_playbook.yml --tags "configuration"

Конфигурация: ansible.cfg

Файл ansible.cfg настраивает поведение Ansible. Приоритет файлов (от высшего к низшему):

  1. Переменная окружения ANSIBLE_CONFIG
  2. ./ansible.cfg в текущей директории
  3. ~/.ansible.cfg в домашней директории
  4. /etc/ansible/ansible.cfg глобальный

Пример конфигурации:

[defaults]
# Путь к инвентарю
inventory = ./inventory.ini

# Отключить проверку хостов (для разработки!)
host_key_checking = False

# Таймаут SSH
timeout = 30

# Количество параллельных хостов
forks = 10

# Логирование
log_path = /var/log/ansible.log

# Формат вывода
stdout_callback = yaml

# Использовать fact caching
fact_caching = jsonfile
fact_caching_connection = /tmp/ansible_facts
fact_caching_timeout = 86400

[privilege_escalation]
become = True
become_method = sudo
become_user = root
become_ask_pass = False

[ssh_connection]
# Ускорить SSH
pipelining = True
control_path = /tmp/ansible-ssh-%%h-%%p-%%r

Best Practices: правила эксплуатации паровоза

Используйте версии модулей

# Хорошо
ansible.builtin.apt:
  name: nginx
  state: present

# Плохо (неявный namespace)
apt:
  name: nginx
  state: present

Всегда указывайте state

# Хорошо
ansible.builtin.package:
  name: nginx
  state: latest

# Плохо (неясно, что произойдёт)
ansible.builtin.package:
  name: nginx

Используйте handlers для перезапуска сервисов

tasks:
  - name: Обновить конфигурацию
    ansible.builtin.template:
      src: nginx.conf.j2
      dest: /etc/nginx/nginx.conf
    notify: restart nginx

handlers:
  - name: restart nginx
    ansible.builtin.service:
      name: nginx
      state: restarted

Применяйте теги для гибкости

tasks:
  - name: Установить пакеты
    ansible.builtin.apt:
      name: "{{ packages }}"
    tags:
      - install
      - packages
  
  - name: Настроить сервис
    ansible.builtin.template:
      src: config.j2
      dest: /etc/service.conf
    tags:
      - configure

Запуск с тегами:

ansible-playbook site.yml --tags "install"
ansible-playbook site.yml --skip-tags "configure"

Храните секреты в Ansible Vault

# Создать зашифрованный файл
ansible-vault create secrets.yml

# Зашифровать существующий
ansible-vault encrypt secrets.yml

# Редактировать
ansible-vault edit secrets.yml

# Посмотреть
ansible-vault view secrets.yml

# Запустить плейбук с vault
ansible-playbook site.yml --ask-vault-pass
# или
ansible-playbook site.yml --vault-password-file ~/.vault_pass

Используйте when для условного выполнения

tasks:
  - name: Установить nginx только на Debian
    ansible.builtin.apt:
      name: nginx
    when: ansible_os_family == "Debian"
  
  - name: Установить httpd только на RedHat
    ansible.builtin.yum:
      name: httpd
    when: ansible_os_family == "RedHat"

Тестируйте с –check и –diff

ansible-playbook site.yml --check --diff

Отладка: когда паровоз буксует

Включите подробное логирование:

export ANSIBLE_DEBUG=1
ansible-playbook site.yml -vvv

Проверьте подключение:

ansible all -m ansible.builtin.ping -vvv

Посмотрите факты:

ansible hostname -m ansible.builtin.setup | less

Используйте ansible-lint:

# Установить
pip install ansible-lint

# Проверить плейбук
ansible-lint site.yml

Проверьте синтаксис YAML:

python -c "import yaml; yaml.safe_load(open('playbook.yml'))"

Заключение

Ansible — это не просто инструмент, а целая философия управления инфраструктурой. Его архитектура проста, но мощна: один управляющий узел, SSH-соединения, модули на Python и декларативные плейбуки в YAML.

Помните: хороший сисадмин — это не тот, кто всё делает руками, а тот, кто построил паровую машину, которая делает это за него.



⚙️ Машинное отделение ROADIT благодарит за прочтение.
Больше команд, шпаргалок и обзоров — на roadit.ru и в нашем Телеграф-канале.
📋 Все команды

Оставьте комментарий