{"canonical_url":"https://engineer.company/uk/glossary/yaml/","content_markdown":"# YAML\n\n## Що це таке\n\nYAML — це текстовий формат даних, у якому структуру задають відступи, двокрапки\nй дефіси замість дужок і лапок; саме тому його зазвичай обирають для\nконфігурації, яку люди пишуть і переглядають вручну. Назва — рекурсивний акронім\n«YAML Ain't Markup Language». Файли мають розширення `.yaml` або `.yml`, а RFC\n9512, опублікований у лютому 2024 року, зареєстрував тип медіа\n`application/yaml` і назвав `.yaml` бажаним розширенням.\n\nПід скупою пунктуацією лежить невелика модель даних. Є відображення (mappings),\nщо пов'язують ключі зі значеннями, послідовності, тобто впорядковані списки, і\nскаляри: рядки, числа, булеві значення та null. Навколо цієї моделі мова додає\nте, що потрібно людині з файлом у редакторі: коментарі, які починаються з `#`,\nблокові скаляри, що зберігають розриви рядків через `|` або згортають їх через\n`\u003e`, кілька документів в одному файлі, розділених `---`, якорі й псевдоніми\n(`\u0026name` і `*name`), завдяки яким одне значення можна використати ще раз деінде,\nі теги, що прямо називають тип.\n\nПерший фреймворк для YAML написали на Perl у 2001 році. Версія 1.1 специфікації\nвийшла 2005-го, версія 1.2 — 2009-го; головною її метою було зробити YAML\nстрогою надмножиною JSON, і з неї прибрали чимало старих правил неявної\nтипізації. Редакція 1.2.2, оприлюднена в жовтні 2021 року, виправила помилки й\nуточнила формулювання, не змінивши саму мову. Утім, багато програм досі читає\nфайли за старими правилами: документація Ansible зазначає, що PyYAML і libyaml\nреалізують YAML 1.1.\n\nОтже, YAML стоїть між двома сусідами. JSON — його строга підмножина, лаконічна й\nоднозначна, створена для обміну даними між програмами. TOML — пласкіший формат\nконфігурації, де кожен рядок береться в лапки, тож тип значення ніколи не\nдоводиться вгадувати. YAML уміє більше за обидва, і саме ця додаткова свобода\nпороджує його проблеми.\n\n## Чому це важливо\n\nСправжній вибір стосується формату для файлу, який люди підтримуватимуть роками:\nописів розгортань, визначень конвеєрів, конфігурації серверів. Плейбуки Ansible\nпишуть на YAML, як і конфігураційні файли багатьох інших інфраструктурних\nінструментів, тож у такій роботі рішення часто ухвалено заздалегідь. Залишається\nвирішити, наскільки суворо писати ці файли.\n\nГоловний аргумент на користь YAML — читабельність. Рецензент читає diff, не\nрахуючи дужок, коментар пояснює, чому значення саме таке, а багаторядковий\nскрипт чи сертифікат уміщується в блоковий скаляр без екранування. З іншого\nбоку, пробіли мають значення: ключ, зсунутий на два пробіли далі, може опинитися\nв іншому відображенні, а файл і далі розбирається. Табуляцію для відступів\nзаборонено зовсім. Значення без лапок отримують тип за написанням, і правила\nнаписання в 1.1 та 1.2 різняться. Шаблони додають згори ще один синтаксис: в\nAnsible значення, що починається з `{{`, треба брати в лапки, інакше парсер\nсприйме його як відображення.\n\nВирішальне питання — як перевірятимуть файл. YAML з лінтером і звичкою брати\nрядки в лапки — зручний формат для конфігурації, яку команда редагує спільно.\nYAML, який ніхто не перевіряє, — формат, у якому коректний файл може казати щось\nінше, ніж мав на увазі автор. Для даних, що передаються між програмами,\nнадійніший вибір — JSON, а для короткого файлу налаштувань із кількома рівнями\nвкладеності простіший TOML.\n\n## Як це виглядає на практиці\n\nІнфраструктурний репозиторій компанії охоплює розгорнуті публічні сервіси та конфігурацію інших компонентів, зокрема ролі бази даних, резервного копіювання, поштового транспорту й DNS. Зафіксована реалізація налічувала [19 плейбуків Ansible і 34 ролі, загалом 12 065 рядків](/uk/portfolio/servers-you-can-rebuild-from-scratch/) — це історичний підрахунок, а не поточний розмір репозиторію. Автоматизація резервного копіювання й пошти має окремий від конфігурації крок введення в дію. Склад компонентів задається даними, а не прапорцями. Кожен хост належить до групи рівня, YAML-змінні якої перелічують ролі для нього, тож запуску розгортання не потрібні аргументи, щоб привести всі хости до стану, оголошеного їхніми групами. Тут YAML слугує мовою оголошеного стану, а успіх перевіряють, а не припускають, бо хост, уже приведений до заданого стану, має звітувати про нуль змін. Використання YAML уповільнює внесення змін: кожна зміна займає більше часу, ніж редагування файла на сервері, а оскільки часткове застосування змін гірше за відмову від виконання, перед приведенням до заданого стану тепер виконується попередній перевірочний сценарій.\n\nДванадцять тисяч рядків YAML мусить прочитати машина, перш ніж їх побачить\nлюдина.\nНа задокументованому етапі реалізації в серпні 2026 року\n[YAML була однією з мов, які перевіряли ворота коміту з 22 лінтерів](/uk/portfolio/built-a-22-linter-commit-gate/),\nразом із HTML, CSS, JavaScript, Python, Markdown і shell. Кожна діагностика там\nзупиняє коміт, бо рівня попереджень у цих воротах немає, а вбудовані придушення\nзаборонено цілком: коментар ігнорування чи директива вимкнення у файлі перевірку\nне обходять. Для YAML це важливо, бо більшість пасток нижче — цілком коректний\nсинтаксис, і зловити їх до того, як вони потраплять на хост, може лише правило,\nяке їх відхиляє.\n\n## Де виникають проблеми\n\nПастки нижче мають спільну рису: файл розбирається без помилок, але означає щось\nінше.\n\n**Код країни перетворюється на false.** За правилами YAML 1.1 значення `yes`,\n`no`, `on`, `off`, `y` і `n` без лапок є булевими, причому в кількох варіантах\nрегістру. Базова схема (core schema) YAML 1.2 залишає тільки `true` і `false` у\nтрьох написаннях, а RFC 9512 попереджає, що парсер за старим синтаксисом може\nпрочитати `{insecure: n}` як false, а не як літеру n. Список північних країн\nпоказує проблему:\n\n```yaml\nкраїни:\n    - DK\n    - SE\n    - NO # YAML 1.1 читає це як false\n```\n\nБеріть у лапки кожен рядок, який можна прочитати як щось інше, записуйте булеві\nзначення лише як `true` і `false` і доручіть лінтеру стежити за обома правилами.\n\n**Номер версії втрачає цифру.** Числа без лапок перетворюються, тож\n`version: 1.10` надходить як число з рухомою комою 1.1, а за правилами 1.1\nпочатковий нуль позначає вісімкове число, і код `010` стає вісімкою.\nДокументація Ansible саме тому радить брати версію на кшталт `\"1.0\"` у лапки.\nБеріть у лапки ідентифікатори, коди й версії: це рядки, у яких просто\nтрапляються цифри.\n\n**Ключ опиняється під чужим батьком.** Відступ визначає, якому відображенню\nналежить ключ, тож рядок, зсунутий на два пробіли, переносить налаштування в\nінше місце без жодного повідомлення про помилку. Специфікація також вимагає, щоб\nкожен ключ у відображенні був унікальним, а повторений ключ глибоко в довгому\nблоці легко проґавити під час рецензії, тому yamllint має окреме правило для\nкожної з цих двох помилок. Запускайте його до того, як файл піде в роботу.\n\n**Завантаження файлу запускає код.** Теги можуть називати типи конкретної мови\nпрограмування, і завантажувач, який їх виконує, збудує будь-який об'єкт, що його\nзамовить файл. Документація PyYAML порівнює використання `yaml.load` (з небезпечним\nзавантажувачем) із `pickle.load`: такий виклик може створювати об'єкти й викликати функції\nPython. Вибір завантажувача важливий; у поточних версіях його треба вказувати\nявно. `yaml.safe_load` розпізнає лише базові теги YAML. RFC 9512 просить, щоб\nвиконання коду під час десеріалізації було типово вимкнене. Використовуйте\nбезпечний завантажувач для звичайних конфігураційних файлів.\n\n**Короткий файл заповнює пам'ять.** Якорі й псевдоніми роблять документ YAML\nграфом, а не деревом. Коли кожен якір двічі повторює попередній, кожен новий\nрядок подвоює розмір, і тридцять коротких рядків описують понад мільярд\nтекстових значень, щойно програма обходить результат як звичайне дерево. RFC\n9512 називає це експоненційним розростанням даних, атакою billion laughs, і\nвідповідає на неї процесорами, що обмежують глибину рекурсії якорів. Приймайте\nYAML ззовні лише через такий процесор і перевіряйте це обмеження на тому\nпарсері, який справді використовуєте.\n\n## Що почитати далі\n\n- [YAML 1.2.2 specification](https://yaml.org/spec/1.2.2/) — сама мова,\n  зокрема базова схема, яка визначає типи значень без лапок.\n- [RFC 9512: YAML Media Type](https://www.rfc-editor.org/rfc/rfc9512) —\n  реєстрація `application/yaml` із нотатками з безпеки про булеві значення,\n  виконання коду й розгортання псевдонімів.\n- [YAML specification changes](https://yaml.org/spec/1.2.2/ext/changes/) —\n  що змінила кожна редакція, від 1.2.1 до 1.2.2.\n- [Ansible: YAML Syntax](https://docs.ansible.com/ansible/latest/reference_appendices/YAMLSyntax.html)\n  — підмножина, якою користується Ansible, і її пастки з лапками.\n- [yamllint rules](https://yamllint.readthedocs.io/en/stable/rules.html) —\n  правила для булевих значень, дубльованих ключів, вісімкових чисел і відступів.\n- [PyYAML documentation](https://pyyaml.org/wiki/PyYAMLDocumentation) —\n  різниця між `load` і `safe_load` словами самої бібліотеки.\n\n\u003chttps://engineer.company/uk/glossary/yaml/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Що таке YAML, коли файл, який редагують руками, варто писати ним, а не JSON чи TOML, і які пастки з булевими значеннями, відступами й завантажувачами в ньому є.","formats":{"gemtext":"https://engineer.company/uk/glossary/yaml/index.gmi","gopher":"https://engineer.company/uk/glossary/yaml/gophermap","html":"https://engineer.company/uk/glossary/yaml/","json":"https://engineer.company/uk/glossary/yaml/index.json","markdown":"https://engineer.company/uk/glossary/yaml/index.md","pdf":"https://engineer.company/uk/glossary/yaml/index.pdf"},"kind":"page","language":"uk","title":"Що таке YAML?","url":"https://engineer.company/uk/glossary/yaml/","version":1}