{"canonical_url":"https://engineer.company/uk/glossary/ansible/","content_markdown":"# Ansible\n\n## Що це таке\n\nAnsible — це програмне забезпечення з відкритим кодом для автоматизації, яке\nпід'єднується до машин через SSH і налаштовує кожну так, як описано в наборі\nYAML-файлів: які пакети встановлено, які користувачі й файли існують, які служби\nпрацюють і як вони налаштовані. Машину, з якої запускають Ansible, називають\nкерівним вузлом; машини, які він налаштовує, — керованими вузлами, і жодного\nагента на них ставити не треба, бо Ansible входить із власними обліковими даними\nопераційної системи й робить усю роботу через це з'єднання. Файли задають\nрезультат, а Ansible сам з'ясовує на кожному хості, чи цей результат уже\nдосягнуто.\n\nСкладники мають прості назви. Інвентар (inventory) перелічує керовані вузли й розкладає їх\nна групи на кшталт `web` чи `db`, зі змінними, що діють на всю групу або на один\nхост. Плейбук містить один чи кілька плеїв (plays), і кожен плей зіставляє групу хостів\nзі списком завдань. Кожне завдання викликає модуль — невелику програму, яка\nзнає, як керувати однією річчю: пакетом, файлом, службою, користувачем, правилом\nбрандмауера. Власна документація проєкту описує плейбуки як повторювану,\nпридатну до повторного використання й просту систему керування конфігурацією та\nрозгортання на багатьох машинах. Роль збирає завдання, шаблони, типові змінні й\nобробники під одним ім'ям, тож «сервер PostgreSQL» чи «захищений демон SSH»\nпишуть один раз і застосовують до будь-якого хоста, якому це потрібно.\n\nКороткий плей показує структуру:\n\n```text\n- name: Вебсервери обслуговують сайт\n  hosts: web\n  become: true\n  tasks:\n    - name: nginx установлено\n      ansible.builtin.package:\n        name: nginx\n        state: present\n\n    - name: nginx працює зараз і запускається після перезавантаження\n      ansible.builtin.service:\n        name: nginx\n        state: started\n        enabled: true\n```\n\nКожне завдання називає стан, а не дію. Більшість модулів спершу перевіряє, чи\nцей стан уже є, і завершується без жодних дій, якщо так, тож другий прогін цього\nплея на налаштованому хості нічого не змінює й прямо про це повідомляє. Ця\nвластивість, ідемпотентність, і робить безпечним запуск того самого плейбука\nпроти всього парку щоразу, замість того щоб вести облік, який хост отримав який\nскрипт.\n\nХто зважує Ansible, зазвичай порівнює його з трьома сусідами. Порівняно зі\nshell-скриптом різниця в тому, що скрипт перелічує кроки й виконує їх знову,\nпотрібні вони чи ні, а модуль спершу перевіряє, а тоді діє. Порівняно з\nTerraform чи Bicep різниця в рівні: ці інструменти створюють хмарні ресурси —\nмережі, бази даних, віртуальні машини, — а Ansible налаштовує те, що працює\nвсередині машини, коли вона вже існує. Багато команд користуються і тим, і тим.\nПорівняно з Puppet і Chef різниця в моделі: там зазвичай на кожній машині працює\nагент, що забирає конфігурацію з центрального сервера, а Ansible надсилає зміни\nзвідти, де його запустили, і з іншого боку потребує лише SSH.\n\n## Чому це важливо\n\nСервер, налаштований вручну, відтворюваний рівно настільки, наскільки добре\nпам'ятає людина, яка його налаштовувала. За пів року вже ніхто напевно не скаже,\nчому параметр ядра має саме таке значення, яку версію пакета зафіксували й\nнавіщо або що треба зробити першим, коли машину відбудовують. Коли налаштування\nзаписане у вигляді плейбуків, ця пам'ять стає файлами, які можна прочитати,\nпереглянути в pull request і знову запустити на новій машині з тим самим\nрезультатом.\n\nЗаписана форма змінює й те, що означає дрейф. Коли плейбук є описом хоста,\nпрогін у режимі перевірки проти живої машини показує кожне місце, де вони\nрозходяться. З прапорцем `--diff` звіт показує рядки в кожному файлі, які було б\nзмінено. Парк, який регулярно зводять до описаного стану, тримається близько до\nсвого опису, а хост, який редагували вручну, виринає як зміна під час наступного\nпрогону плейбука.\n\nМодель має свою ціну. Ansible діє лише тоді, коли його запускають, тож дрейф між\nдвома прогонами лишається до наступного. Завдання виконуються по черзі, по\nодному на всіх відповідних хостах, і великий плейбук проти багатьох машин\nповільніший за скрипт, який робить одну річ. Логіку, записану в YAML і шаблонах\nJinja2, стає важко відстежувати, коли роль обростає умовами. А прогін, що\nзупинився посередині, залишає хости частково зміненими, бо в Ansible немає\nтранзакції, яку можна відкотити.\n\n## Як це виглядає на практиці\n\nКілька проєктів на цьому сайті показують, як записана інфраструктура виглядає з\nчасом і чого коштує тримати її чесною.\n\nІнфраструктура компанії як код охоплює розгорнуті публічні сервіси та конфігурацію інших\nкомпонентів, зокрема автоматизацію резервного копіювання й пошти, активація яких є окремим кроком.\n[Зафіксована реалізація складається з 19 плейбуків і 34 ролей](/uk/portfolio/servers-you-can-rebuild-from-scratch/)\nта 12 065 рядків YAML; ці цифри описують той етап, а не нинішній розмір репозиторію.\nХост належить до групи рівня, змінні якої визначають його ролі, тому підготовка без аргументів\nприводить кожен хост до оголошеного стану. Ідемпотентність вважається контрактом: хост,\nприведений до потрібного стану, повідомляє про нуль змін, а плей, який не може цього сказати,\nще не завершений. Чотири простори імен команд розділяють обіцянки — від контролю якості,\nщо не торкається жодного хоста, до перевірки, яка навмисно змінює хост і видає висновок.\nСторінка чесно називає ціну: кожна зміна займає більше часу, ніж пряме редагування файла на\nсервері, а застосування, що зупинилося на півдорозі, гірше за те, яке відмовилося починати.\n\nКонтроль доступу — ще одна сфера, де письмовий опис окупається.\n[1 000 правил RBAC налаштовано за допомогою Ansible](/uk/portfolio/wrote-1000-rbac-rules-to-secure-linux-servers/)\nу середовищах розробників, примірниках застосунків, PostgreSQL, MS SQL і на серверах Linux,\nпричому кожне правило пов'язане з конкретною роллю та системою. Зафіксований результат —\nдокументований набір рольових правил і відтворюваний спосіб їх застосовувати та перевіряти.\nСаме це підтверджує запис; він не дає кількісної оцінки зниження ризику безпеки чи економії\nчасу на налаштування.\n\nЩоб пробний прогін казав правду, знадобилася окрема робота.\n[Check mode змусили казати правду на всій платформі](/uk/portfolio/made-ansible-check-mode-tell-the-truth/)\nпісля того, як у вересні 2026 року пробний прогін зупинився на твердженні, що\nхибно описувало хост, і порадив встановити прапорець, який послабив би пісочницю\nбезпеки. Обхід виявив шість зондів, що ухвалювали рішення за значеннями, яких\nхост ніколи не давав. Зонди, які читають стан, не зачеплений прогоном, тепер\nвиконуються навіть у режимі перевірки; решту пропускають із повідомленням, що\nсаме лишилося неперевіреним, а правило потрапило до посібника з розробки.\n\n## Де виникають проблеми\n\nБільшість клопоту з Ansible походить від того, що звіту довіряють більше, ніж\nмеханізму за ним.\n\n**Пробний прогін показує чистий результат для команд, яких він не виконував.**\nРежим перевірки — це симуляція. Модулі, що його підтримують, передбачають свою\nзміну; документація каже, що модулі без такої підтримки нічого не звітують і\nнічого не роблять. Модулі `command` і `shell` підтримують його лише частково:\nякщо не вказано `creates` чи `removes`, вони пропускають команду й реєструють\nрезультат із порожнім виводом. Будь-яка подальша умова `when:`, що читає цей\nрезультат, ухвалює рішення за значенням, якого ніхто не вимірював. Зонду, який\nлише читає хост, можна наказати виконуватися попри режим перевірки, а той, що\nвиконатися не може, має про це сказати:\n\n```text\n- name: Прочитати стан брандмауера навіть у режимі перевірки\n  ansible.builtin.command: ufw status\n  register: fw\n  check_mode: false\n  changed_when: false\n\n- name: Повідомити, що пробний прогін не перевірив\n  ansible.builtin.debug:\n    msg: \"режим перевірки: перезапуск служби не перевірено\"\n  when: ansible_check_mode\n```\n\n**Прогін зупиняється на дев'ятому завданні, а перші вісім уже застосовано.**\nКоли завдання на хості падає, Ansible виключає цей хост із решти прогону й\nзалишає все, що вже змінив. Перевірки, які можна виконати до того, як щось\nторкнеться хоста, мають стояти перед застосуванням конфігурації. Саме так сталося після зміни\nсекретів у власному господарстві компанії:\n[попередній перевірочний плей тепер спершу перевіряє сховище локально](/uk/portfolio/added-a-one-second-preflight-for-secrets/)\nі виконує ті самі файли завдань, що й справжнє застосування конфігурації, приблизно за секунду,\nтож секрет, значення якого не вдається визначити, коштує двосекундної відмови на ноутбуці\nзамість частково застосованої зміни на живому сервері. Та сама сторінка описує\nпастку: факти, встановлені під час одного плея, діють і після нього, тож перевірка\nй застосування конфігурації, зчеплені в один виклик, можуть поділити значення, яке перевірка мала\nб прочитати наново.\n\n**Хост, якого ніхто не чіпав, звітує про зміни на кожному прогоні.** Модулі\n`command` і `shell` повідомляють про зміну щоразу, коли виконуються, бо не\nможуть знати, що зробила команда. Плейбук, повний таких завдань, ніколи не\nсходиться до нуля, і справжні зміни тонуть у шумі. Віддавайте перевагу модулю,\nякий керує річчю напряму, додайте `creates` чи `removes` або скажіть Ansible\nчерез `changed_when`, коли вивід означає зміну.\n\n**Пароль з'являється в журналі чи в репозиторії.** Змінні зберігаються відкритим\nтекстом, якщо їх ніщо не шифрує. Ansible Vault шифрує файли змінних або окремі\nзначення, щоб вони могли лежати в репозиторії, а `no_log: true` на завданні\nтримає його аргументи й результати поза виводом. Запустіть плейбук один раз із\nвисокою детальністю в тестовому середовищі й прочитайте, що він друкує, перш ніж\nпокладатися на будь-що з цього.\n\n## Що почитати далі\n\n- [Ansible Community Documentation](https://docs.ansible.com/ansible/latest/index.html)\n  — власна точка входу проєкту до встановлення, понять і всіх посібників.\n- [Ansible playbooks](https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_intro.html)\n  — плеї, завдання, модулі, порядок виконання й що ідемпотентність означає на\n  практиці.\n- [Validating tasks: check mode and diff mode](https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_checkmode.html)\n  — що пробний прогін бачить і чого не бачить, і перемикачі для окремих завдань.\n- [How to build your inventory](https://docs.ansible.com/ansible/latest/inventory_guide/intro_inventory.html)\n  — хости, групи й прив'язані до них змінні.\n- [Protecting sensitive data with Ansible Vault](https://docs.ansible.com/ansible/latest/vault_guide/index.html)\n  — шифрування файлів і окремих значень, що лежать поруч із плейбуками.\n- [ansible.builtin.command](https://docs.ansible.com/ansible/latest/collections/ansible/builtin/command_module.html)\n  — довідка модуля, зокрема про його часткову підтримку режиму перевірки.\n\n\u003chttps://engineer.company/uk/glossary/ansible/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Що таке Ansible, як поєднуються плейбуки, ролі й інвентар, чим він відрізняється від Terraform і Puppet і де пробні прогони вводять в оману.","formats":{"gemtext":"https://engineer.company/uk/glossary/ansible/index.gmi","gopher":"https://engineer.company/uk/glossary/ansible/gophermap","html":"https://engineer.company/uk/glossary/ansible/","json":"https://engineer.company/uk/glossary/ansible/index.json","markdown":"https://engineer.company/uk/glossary/ansible/index.md","pdf":"https://engineer.company/uk/glossary/ansible/index.pdf"},"kind":"page","language":"uk","title":"Що таке Ansible?","url":"https://engineer.company/uk/glossary/ansible/","version":1}