Pemformat YAML Playbook Ansible

YAML Ansible yang berantakan adalah salah satu titik gesekan paling umum dalam alur kerja DevOps — playbook sering disalin-tempel antar role, diedit oleh anggota tim yang berbeda dengan pengaturan editor yang berbeda, atau ditempel dari Slack dan pelacak tiket, sehingga akhirnya bercampur indentasi 2 spasi, 3 spasi, dan 4 spasi dalam satu file. Karena struktur YAML adalah spasi kosongnya, indentasi yang tidak konsisten bukan sekadar tidak sedap dipandang — ia bisa diam-diam mengubah tempat sebuah tugas.

Alat ini mengindentasi ulang YAML playbook, role, dan daftar tugas Ansible ke langkah indentasi yang konsisten (2 atau 4 spasi), sehingga struktur visualnya sesuai dengan makna sebenarnya dari dokumen. Alat ini juga merapikan tanda hubung item daftar, mengubah - name: foo atau -name: foo menjadi - name: foo yang konvensional.

Cara menggunakannya

1. Tempel playbook.yml, tasks/main.yml milik role, atau daftar tugas apa pun ke kotak input — atau unggah file .yml/.yaml langsung.
2. Pilih 2 spasi atau 4 spasi sebagai ukuran indentasi Anda (2 adalah konvensi komunitas Ansible).
3. YAML yang diformat muncul seketika di panel keluaran. Salin atau unduh sebagai playbook.yml.

Alat ini memperbarui hasil saat Anda mengetik, jadi Anda bisa menempel YAML kasar hasil salin-tempel dan melihatnya berubah menjadi bentuk yang bersih dan konsisten.

Yang alat ini lakukan — dan yang tidak

Formatter ini bekerja baris demi baris: ia melacak seberapa dalam setiap baris awalnya diindentasi relatif terhadap baris-baris di sekitarnya, lalu mengeluarkan ulang setiap baris pada langkah indentasi yang proporsional dan seragam. Itu sudah cukup untuk memperbaiki sebagian besar YAML berantakan di dunia nyata — spasi yang tidak konsisten, tab yang bercampur dengan spasi, dan penanda daftar yang tidak rapi.

Yang sengaja tidak dilakukannya adalah mengurai YAML menjadi dokumen terstruktur. Ia tidak menyusun ulang kunci tugas Ansible (name → module → when → register, dst.), memvalidasi struktur playbook (hosts: yang hilang, tugas tanpa module), atau menandai masalah gaya ansible-lint seperti nama module pendek yang seharusnya menjadi nama koleksi yang sepenuhnya memenuhi syarat. Semua itu memerlukan parser YAML sungguhan dan pengetahuan skema yang memahami Ansible, yang tidak dicoba oleh formatter ringan tanpa dependensi ini. Jika YAML Anda memakai koleksi gaya alur ({ key: value }, [a, b, c]) atau skalar blok multi-baris (|, >), nilai-nilai itu diteruskan apa adanya dan tidak direstrukturisasi — hanya indentasi tingkat baris dan penanda daftar yang dinormalisasi.

Untuk sebagian besar tugas sehari-hari "playbook saya berantakan, tolong bersihkan spasi kosongnya", persis itulah yang dibutuhkan. Untuk pelintingan mendalam, jalankan ansible-lint sendiri.

Apakah YAML saya diunggah ke mana pun?

Tidak. Pemformatan terjadi sepenuhnya di browser Anda — YAML yang Anda tempel atau unggah tidak pernah meninggalkan perangkat Anda atau menyentuh server kami.

Apakah alat ini memvalidasi bahwa playbook saya benar?

Tidak — ia hanya menormalkan indentasi dan spasi penanda daftar. Ia tidak akan menangkap kunci wajib yang hilang, nama module yang tidak valid, atau kesalahan logika. Gunakan ansible-playbook --syntax-check atau ansible-lint untuk validasi sungguhan.

Apakah alat ini juga berfungsi pada YAML non-Ansible?

Ya. Meski dirancang seputar playbook Ansible, operasi yang mendasarinya adalah pengindentasi ulang YAML serbaguna — ia bekerja dengan baik pada manifest Kubernetes, alur kerja GitHub Actions, atau file YAML lain yang hanya perlu dibersihkan indentasinya.

Bagaimana jika saya menempel teks yang tidak valid atau bukan YAML?

Formatter tidak pernah gagal. Karena ia bekerja pada baris dan indentasi, bukan mengurai dokumen, ia akan mengindentasi ulang teks apa pun yang Anda berikan sebaik mungkin, alih-alih menampilkan pesan kesalahan parse.