Конвертер YAML ⇄ JSON

Що робить YAML ⇄ JSON

YAML ⇄ JSON перетворює структуровану конфігурацію між YAML, що ґрунтується на відступах, і суворим JSON. Це корисно, коли ви переносите приклади між маніфестами Kubernetes, файлами CI, налаштуваннями статичних сайтів, тестовими даними API, метаданими пакетів, фрагментами документації та конфігурацією застосунків. Напрямок YAML у JSON розбирає YAML і повертає відформатований JSON з відступом у два пробіли. Напрямок JSON у YAML розбирає суворий JSON і записує читабельний YAML, який можна вставити у файли конфігурації чи чернетки документації. Помилки перевірки показуються одразу, тож ви помітите помилки відступів, пропущені двокрапки, недійсні лапки JSON, зайві коми й випадкові символи табуляції, перш ніж скопіюєте непридатний результат.

Інструмент залишає на екрані і вихідні дані, і результат, тому невеликі перетворення легко перевірити. Він створений для щоденної роботи розробників: перевірити приклад конфігурації під час рев'ю, підготувати приклади для документації, перетворити дані між інструментами, що віддають перевагу різним форматам, або привести до ладу тестові дані перед комітом. Він не намагається тлумачити схеми, специфічні для проєкту, і не застосовує прихованих значень за замовчуванням.

Приватний робочий процес у браузері

Уся обробка відбувається у вашому браузері за допомогою клієнтського JavaScript. Інструмент не завантажує на сервер фрагменти, значення конфігурації, згенеровані дані, текст запитів чи скопійовані приклади й не потребує облікового запису. Така суто локальна модель важлива для інструментів розробника, бо вміст, який у них вставляють, часто схожий на реальні дані застосунків: відповіді API, журнали, зразки у вигляді змінних середовища, запити до баз даних, розмітка з чернеток або значення, скопійовані під час налагодження на продакшені. Локальне перетворення знижує ризики й пришвидшує роботу, адже немає обміну даними через мережу.

Інтерфейс навмисно компактний, щоб ви могли вставити вхідні дані, налаштувати параметри, переглянути результат, скопіювати його й повернутися до редактора. Результати все одно слід перевіряти, перш ніж комітити, публікувати чи використовувати у виробничому процесі. Браузерні інструменти чудово підходять для швидкого огляду й підготовки, але не можуть знати всіх угод проєкту, правил класифікації даних чи вимог до перевірки, специфічних для застосунку.

Практичні поради

Перевіряйте складний YAML, перш ніж на нього покладатися, адже YAML підтримує можливості, які не завжди точно відповідають JSON: власні теги, дати, аліаси, ключі злиття та значення, що можуть трактуватися як булеві чи числа. JSON має вужчу модель даних, тому найбезпечніше використовувати його для звичайних об'єктів, масивів, рядків, чисел, булевих значень і null. Перетворюючи конфігурацію для продакшену, перевірте підсумковий файл тим інструментом, який його використовуватиме. Якщо у вхідних даних є секрети, видаліть їх, перш ніж копіювати приклади кудись ще, навіть попри те що ця сторінка виконує перетворення локально.