Что такое «YAML»
Название расшифровывается рекурсивно — «YAML Ain't Markup Language», то есть «YAML — не язык разметки». Авторы подчёркивали: это формат для данных, а не для оформления текста. В нём нет фигурных скобок и закрывающих тегов, поэтому конфигурация читается почти как обычный список. YAML 1.2 устроен так, что почти любой корректный JSON одновременно является корректным YAML.
На YAML описывают сервисы Docker Compose, манифесты Kubernetes, сценарии GitHub Actions и GitLab CI, спецификации OpenAPI, настройки многих фреймворков. Если файл заканчивается на .yml или .yaml, это он.
Синтаксис на примере docker-compose
services:
php:
image: php:8.4-fpm
volumes:
- ./www:/var/www/html
environment:
APP_ENV: local
db:
image: mariadb:11.8
restart: unless-stopped
Пара «ключ: значение» задаёт поле, отступ — вложенность, дефис — элемент списка. Здесь описаны два контейнера: PHP с подключённой папкой сайта и база данных. Комментарии начинаются с символа #, длинный текст можно записать блоком после |.
Подводные камни
- Отступы — только пробелами. Табуляция запрещена, а лишний пробел молча переносит ключ на другой уровень.
- Неявные типы. Парсеры по старой спецификации YAML 1.1 читают
no,yes,on,offкак логические значения — код страны НорвегииNOпревращается вfalse. Версия3.10без кавычек станет числом 3.1. - Строки с двоеточием, решёткой или звёздочкой в начале надо брать в кавычки, иначе они будут прочитаны как синтаксис.
Надёжное правило: значения, которые должны остаться строками (версии, коды, пароли), всегда заключать в кавычки, а файл проверять линтером перед коммитом. В конвейерах CI/CD ошибка отступа часто выясняется только при запуске сборки, поэтому проверка синтаксиса — первый шаг пайплайна.
Когда YAML не лучший выбор
Для обмена данными между программами удобнее JSON: он однозначен и быстрее разбирается. YAML хорош там, где файл пишет и читает человек, а машине остаётся только загрузить готовую конфигурацию.
Связанные термины
Обновлено: 10 октября 2026

