YAML-syöte

Tarkistuksen tulos

Mikä on YAML-tarkistin?

YAML (YAML Ain't Markup Language) on käytössä konfiguraatiotiedostoissa kuten Kubernetes, Docker Compose, GitHub Actions ja monissa muissa työkaluissa. Toisin kuin JSON, YAML käyttää sisennystä rakenteen määrittämiseen — ei hakasulkeita. Se tekee siitä luettavaa, mutta myös herkkää: väärät välilyönnit, tabulaattorit välilyöntien sijaan tai epäjohdonmukainen sisennys aiheuttavat jäsennysvirheitä. YAML 1.2 -määrittely määrittelee säännöt.

YAML-tarkistin tarkistaa, onko dokumenttisi kelvollinen. Se jäsentää YAML:si ja raportoi syntaksivirheet rivin ja sijainnin kanssa. Tämä työkalu toimii kokonaan selaimessasi. Mitään ei lähetetä palvelimelle, joten sitä on turvallista käyttää tuotantokonfiguraatioiden, salaisuuksien tai arkaluonteisen datan kanssa.

YAML-validoinnin esimerkkejä

Kelvollinen YAML käyttää johdonmukaista sisennystä. Virheellisessä YAML:ssa on usein väärä sisennys. Telecom-teemaiset esimerkit:

Esimerkki 1: Kelvollinen YAML

Kelvollinen

Esimerkki 2: Virheellinen YAML (väärä sisennys)

Virheellinen

Tarkistin raportoi virheen. Käytä Kelvollinen esimerkki tai Virheellinen esimerkki ladataksesi esimerkkejä editoriin.

Miten työkalua käytetään

1

Liitä tai lataa YAML

Kopioi YAML ja liitä se vasempaan editoriin. Voit myös napsauttaa Lataa ladataksesi .yaml- tai .yml-tiedoston tietokoneeltasi. Käytä Kelvollinen esimerkki oikean YAML:n näyttämiseen, tai Virheellinen esimerkki näyttämään miltä virheet näyttävät.

2

Tarkista validoinnin tulos

Oikea paneeli näyttää Kelvollinen tai Virheellinen. Jos virheellinen, se listaa virheet rivin ja sijainnin kanssa, jotta voit paikantaa ongelman. Yleisiä ongelmia ovat väärä sisennys, tabulaattorit välilyöntien sijaan, epäjohdonmukainen sisennys, lainaamattomat erikoismerkit tai virheelliset monirivijärjestelmät.

3

Korjaa ja tarkista uudelleen

Korjaa virheet syötteessä ja tarkista uudelleen. Muotoiluun ja sisennykseen käytä YAML-muotoilutyökalua. JSON- tai muihin muunnosiin käytä YAML JSONiksi tai YAML XML:ksi.

Milloin YAML-validoinnista on apua

Useimmat kehittäjät tarvitsevat validointia Kubernetes-manifesteja, Docker Compose -tiedostoja tai CI/CD-konfiguraatioita kuten GitHub Actions käsitellessään. Yksi ylimääräinen välilyönti tai tabulaattori voi rikkoa käyttöönoton. Konfiguraation ajaminen tästä havaitsee syntaksivirheet ennen push-toimintoa.

Konfiguraatiotiedostot kuten application.yml (Spring Boot) tai .gitlab-ci.yml ovat usein syvästi sisennettyjä. Tarkistin auttaa löytämään tarkan rivin, jossa sisennys menee pieleen. YAML-muunnokseen JSONiksi tai XML:ksi käytä YAML JSONiksi tai YAML XML:ksi -työkalua.

Jos muokkaat YAML:ä editorissa ilman hyvää validointia, tämä työkalu antaa välittömän palautteen. Se on myös hyödyllistä ennen konfiguraatioiden jakamista tiimitovereille — validointi ensin varmistaa, että kaikki saavat jäsennettävän tiedoston.

Usein kysyttyä

Mikä tekee YAML:sta virheellisen?

Väärä sisennys (tabulaattorit välilyöntien sijaan), epäjohdonmukainen sisennys, lainaamattomat erikoismerkit kuten : tai # arvoissa, virheelliset monirivijärjestelmät tai duplikaattiavaimet. Tarkistin paikantaa ongelman rivin ja sijainnin kanssa.

Tabulaattorit vai välilyönnit?

YAML vaatii välilyöntejä sisennykseen. Tabulaattorit eivät ole sallittuja. Tabulaattorien ja välilyöntien sekoittaminen aiheuttaa virheitä. Käytä 2 tai 4 välilyöntiä johdonmukaisesti koko tiedostossa.

Lähetetäänkö datani minnekään?

Ei. Validointi toimii kokonaan selaimessasi JavaScriptin avulla. Mitään dataa ei lähetetä palvelimelle. Voit varmistaa tämän avaamalla selaimen Verkko-välilehden työkalua käyttäessäsi.

Entä YAML-ankkurit ja aliakset?

Ankkurit (&nimi) ja aliakset (*nimi) ovat tuettuja. Tarkistin varmistaa, että niitä käytetään oikein. Kehämäiset viittaukset aiheuttavat validointivirheen.

Tarkistaako se skeeman vai pelkän syntaksin?

Tämä työkalu validoi vain syntaksin — onko YAML hyvin muodostettu ja jäsennettävissä. Se ei validoi JSON-skeemaa tai Kubernetes-skeemaa vastaan. Rakenne-validointiin muunna JSONiksi ja käytä JSON-skeema-generaattoria.

Liittyvät työkalut

YAML-määrittely. YAML-pikaopas. JSON-määrittely. MDN. Kubernetes-konfiguraatio. YAML. JSON Schema.