Tärkeimmät kohdat
- 01Muotoile YAML johdonmukaisen sisennyksen kanssa käyttäen js-yaml-jäsentimiä — sama kirjasto, jota käytetään Node.js:n rakentamistyökaluissa.
- 02Vahvista syntaksi ja raportoi tarkat rivinumerot virheille.
- 03Muunna YAML:n ja JSON:n välillä molempiin suuntiin oikean tyypin säilyttämisellä.
- 04Mitään ei ladattu — koko toiminta suoritetaan paikallisesti selaimessasi.
Miksi YAML-muotoilu on tärkeää kokotiedostoille
YAML on Kubernetesin, GitHub Actionsin, Docker Composen, Helm-kaavioiden ja monien muiden työkalujen oletusmäärityskieli. Se on myös kuuluisa sisennysherkkyyteen — yksittäinen väärä sisennys voi tuottaa hiljaisen tyypin epäsuhdan tai kovaa jäsennysvirhettä, joka estää käyttöönottoa. Säännöllinen muotoilu pitää tiedostot johdonmukaisina ja saa ongelmia kiinni ennen kuin ne saavuttavat CI:n.
YAML:n ja JSON:n väliset muunnokset ovat yhtä hyödyllisiä. Jotkut työkalut hyväksyvät vain JSON:ää API-kutsuille tai skeeman määritelmille, kun taas ihmiset yleensä suosivat YAML:ää pitkäaikaisille määritystiedostoille. Mahdollisuus pyöriä tyyppien menettämättä — numerot pysyvät numeroina, boolean pysyvät boolean — säästää aikaa ja estää hienovaraisia virheitä.
YAML-muotoilu tai muuntaminen
- 01
Liitä YAML tai JSON
Liitä Kubernetes-manifesti, GitHub Actions -työnkulku, Helm-arvotiedosto tai mikä tahansa muu YAML-asiakirja. JSON-YAML-muunnosta varten liitä JSON sen sijaan.
- 02
Valitse toiminto
Valitse Muotoile YAML normalisoidaksesi sisennyksen ja puhdista asiakirjan paikalleen. Valitse YAML JSON:ksi tai JSON YAML:ksi muuntaaksesi muodon kokonaan.
- 03
Tarkista virheet jos jokin
Jos syöte on syntaksivirhe, työkalu näyttää tarkan rivinumeron ja syyn js-yaml-jäsennestä — sama jäsennin, jonka Node.js-työkalusi käyttää, joten virhe vastaa mitä näkisit tuotannossa.
- 04
Kopioi lähtötieto
Klikkaa Kopioi muotoilun tai muunnetun lähtötiedon ottamiseksi. Liitä se takaisin määritystiedostoosi, API-runkoon tai skeeman määritelmään.
Kun tämä työkalu säästää aikaasi
- 01Kubernetes-manifesti on ajautunut — normalisoi sisennys ennen sitouttamista.
- 02GitHub Actions -työnkulku ei jäsenny — vahvista saadaksesi tarkan virherivin.
- 03API vain hyväksyy JSON, mutta kokoonpano on tallennettu YAML:ksi — muunna yhdellä klikkauksella.
- 04Uuden palvelun sisäänpääsy — muunna JSON-otoksesta YAML Helm-kaaviolle.
- 05YAML kopioiminen Stack Overflowista — muotoile vastaavan projektisi 2-välilyönnin tyyliin.
- 06Helm-arvojen yhdistämisen virheenetsintä — vahvista, että jokainen values.yaml on yksilöllisesti puhdas.
Yksityinen, lataus ei vaadita
Muotoilu ja muuntaminen suoritetaan kokonaan selaimessasi käyttäen js-yaml-kirjastoa — sama kirjasto, joka on nipussa Webpackissa, Rollupissa ja useimmissa JavaScript-rakentamisen työkaluissa. Kokoonpano-, salaisuuksien viitteet ja ympäristömuuttujien nimet eivät koskaan lähde laitteestasi.
Jäsennin kohdistaa YAML 1.2-versioon, mitä Kubernetes, GitHub Actions ja Docker Compose kaikki käyttävät. Jos tiedosto vahvistetaan tässä, se latautuu oikein näissä työkaluissa.
YAML-muotoilija — UKK
Säilyttääkö YAML-muotoilu kommentit?
Ei. js-yaml-jäsennin poistaa kommentit jäsennyksen aikana — tämä on JavaScript YAML -jäsennimien rajoitus. Muotoile ensin, lisää kommentit takaisin manuaalisesti.
Mitä YAML-versiota tämä tukee?
YAML 1.2, mitä Kubernetes, GitHub Actions, Docker Compose ja Helm käyttävät. Mikä vahvistetaan tässä, latautuu puhtaasti näissä työkaluissa.
Säilyttääkö YAML:stä JSON:ksi muuntaminen tyypit?
Kyllä. Numerot, boolean, null ja päivämäärä-merkkijonot pyörivät oikein ympäri. true YAML:ssa tulee boolean true JSON:ksi, ei merkkijono 'true'.
Mitä eroa muotoilun ja muuntamisen välillä?
Muotoilu pitää tiedoston YAML:nä ja normalisoi välilyönnin ja sisennyksen. Muuntaminen muuttaa lähtötiedon muotoa kokonaan — YAML JSON:ksi tuottaa .json-yhteensopivan asiakirjan.
Minulla on YAML-dokumentteja erillään --- erotteimella. Käsitelläänkö ne kaikki?
Ensimmäinen asiakirja jäsennetään ja lähetetään uudelleen. Multi-dokumenetti-tiedostoille jaa jokainen osio --- ja käsittele ne erikseen.