INI naar YAML omzetten

Deze pagina is voor iemand die een applicatie van een handmatig geconfigureerde server afhaalt. De instellingen staan al jaren in een INI-bestand dat over SSH werd bewerkt, en de bestemming is een Helm-waardenbestand, een docker-compose-serviceblok of een Ansible-variabelenset — ergens waar de configuratie in een pull request wordt beoordeeld in plaats van ter plekke aangepast.

Dat verschil in werkwijze — bewerkt op de server versus beoordeeld in een review — is precies waarom deze migratie de moeite waard is, ook al kost het opzetten ervan tijd.

Een onaangehaalde waarde zoals `engine: On` wordt door de YAML 1.2-schrijver die deze site gebruikt gelezen als de letterlijke tekst "On". YAML 1.1-parsers — waaronder PyYAML, en dus Ansible — lezen diezelfde onaangehaalde waarde als het booleaanse `true`.

Dat verschil is het duurste dat er over dit paar te zeggen valt: een instelling die in de ene tool een simpele tekststring is, wordt in de andere stilzwijgend een waar/onwaar-vlag. Controleer elke onaangehaalde On/Off/Yes/No-achtige waarde in het resultaat voordat het naar een YAML 1.1-omgeving zoals Ansible gaat.

Zet een waarde die als boolean bedoeld is expliciet tussen aanhalingstekens of schrijf hem als `true`/`false` in kleine letters — dat wordt door zowel YAML 1.1- als YAML 1.2-lezers eenduidig geïnterpreteerd, in tegenstelling tot de onaangehaalde vorm.

Controleer na de omzetting specifiek de sleutels die in het originele INI-bestand `On`, `Off`, `Yes` of `No` als waarde hadden — dat zijn de plekken waar de dubbelzinnigheid daadwerkelijk optreedt.

INI-secties worden de bovenste sleutels in het YAML-bestand, met de instellingen binnen elke sectie als geneste waarden eronder. Dat geeft een YAML-structuur die de oorspronkelijke indeling van het INI-bestand herkenbaar houdt.

Sleutelvolgorde blijft behouden zoals die in het bronbestand stond — er wordt niets alfabetisch gesorteerd of anders gerangschikt tijdens de omzetting.

Commentaarregels in het INI-bestand worden niet overgenomen: het INI-formaat en de daaropvolgende YAML-structuur hebben allebei geen apart kanaal voor opmerkingen die niet direct bij een waarde horen, dus die informatie gaat verloren.

Voor een configuratiebestand met uitgebreide uitleg in commentaarregels betekent dat: kopieer die uitleg apart over naar documentatie voordat het originele INI-bestand wordt gearchiveerd, want de omzetting bewaart hem niet.

Een waarde die er numeriek uitziet, wordt als getal geschreven in het YAML-bestand, niet als tekststring — dat is meestal precies wat een deploymenttool verwacht bij poortnummers of tellers.

Een waarde met een voorloopnul, zoals een postcode of versiecode geschreven als `007`, kan daarbij zijn voorloopnul verliezen als hij als getal wordt geïnterpreteerd — controleer dat specifiek bij identificatiewaarden die toevallig numeriek ogen.

De omzetting draait volledig in de browser; het configuratiebestand wordt niet naar een server gestuurd. Voor een bestand met wachtwoorden of andere gevoelige instellingen is dat relevant.

De limiet op het gratis plan is 100 MB per bestand, ruim voldoende voor elk INI-configuratiebestand.

Tot honderd INI-bestanden tegelijk kunnen in één sessie worden omgezet, elk met een eigen voortgangsindicator — bruikbaar wanneer meerdere servers dezelfde migratie naar een moderne deployment ondergaan.

Het resultaat komt terug als losse bestanden of als ZIP, met dezelfde bestandsnamen als het origineel maar de `.yaml`-extensie.