{"canonical_url":"https://engineer.company/nb/glossary/yaml/","content_markdown":"# YAML\n\n## Hva det er\n\nYAML, på disk en fil som slutter på `.yaml` eller `.yml`, er et tekstformat for strukturerte data\nsom markerer strukturen med innrykk, kolon og bindestreker i stedet for klammer og anførselstegn, og\ndet er derfor det er det vanlige valget for konfigurasjon som folk skriver og gjennomgår for hånd.\nNavnet er et rekursivt akronym, «YAML Ain’t Markup Language». RFC 9512, publisert i februar 2024,\nregistrerte medietypen `application/yaml` og pekte ut `.yaml` som den foretrukne endelsen.\n\nUnder den lette tegnsettingen ligger en liten datamodell. Det finnes avbildninger (_mappings_), som\nkobler nøkler til verdier, sekvenser, som er ordnede lister, og skalarer: strenger, tall, boolske\nverdier og null. Rundt den modellen legger språket til det en person som redigerer en fil, vil ha:\nkommentarer som starter med `#`, blokkskalarer som beholder linjeskift med `|` eller bretter dem\nsammen med `\u003e`, flere dokumenter i én fil skilt med `---`, ankere og aliaser (`\u0026name` og `*name`)\nsom lar én verdi gjenbrukes et annet sted, og tagger som navngir en type direkte.\n\nDet første YAML-rammeverket ble skrevet i Perl i 2001. Versjon 1.1 av spesifikasjonen fulgte i 2005,\nog versjon 1.2 i 2009, med hovedvekt på å gjøre YAML til et strengt supersett av JSON og med mange\nav de eldre reglene for implisitt typing fjernet. Revisjon 1.2.2, publisert i oktober 2021, rettet\nfeil og klargjorde ordlyden uten å endre språket. Mye programvare leser likevel fortsatt etter de\neldre reglene: dokumentasjonen til Ansible påpeker at PyYAML og libyaml implementerer YAML 1.1.\n\nDermed står YAML mellom to naboer. JSON er en streng delmengde av det, kortfattet og entydig, laget\nfor at programmer skal utveksle data. TOML er et flatere konfigurasjonsformat der hver streng står i\nanførselstegn, så typen til en verdi aldri blir gjettet. YAML tilbyr mer enn begge, og den ekstra\nfriheten er nettopp der problemene kommer fra.\n\n## Hvorfor det er viktig\n\nDet egentlige valget er hvilket format en fil skal få når folk skal vedlikeholde den i årevis:\nbeskrivelser av produksjonssetting, definisjoner av CI-løp, serverkonfigurasjon. Playbooks i Ansible\ner YAML, og det samme er konfigurasjonsfilene til mange andre infrastrukturverktøy, så for mye av\ndet arbeidet er beslutningen allerede tatt lenger opp i kjeden, og det som gjenstår å avgjøre, er\nhvor strengt filene skal skrives.\n\nArgumentet for YAML er lesbarhet. Den som gjennomgår en endring, kan lese en diff av det uten å\ntelle klammer, en kommentar kan forklare hvorfor en verdi er som den er, og et skript eller et\nsertifikat over flere linjer får plass i en blokkskalar uten escaping. Mot det står at mellomrom\nbærer mening, så en nøkkel som er rykket inn to mellomrom for langt, kan havne i en annen avbildning\nmens filen fortsatt lar seg tolke. Tabulatorer er helt forbudt som innrykk. Verdier uten\nanførselstegn får type etter hvordan de staves, og reglene for stavingen er ulike i 1.1 og 1.2.\nMaler legger en syntaks til oppå: i Ansible må en verdi som begynner med `{{`, stå i anførselstegn,\nellers tar tolkeren den for en avbildning.\n\nDet som avgjør valget, er hvordan filen skal sjekkes. YAML med en linter og en vane med å sette\nstrenger i anførselstegn er et behagelig format for konfigurasjon et team redigerer sammen. YAML\nuten noen av delene er et format der en gyldig fil kan si noe annet enn det forfatteren mente. For\ndata som sendes mellom programmer, er JSON det tryggere standardvalget, og for en kort\ninnstillingsfil med få nivåer av nesting er TOML enklere.\n\n## Slik ser det ut i praksis\n\nSelskapets infrastrukturrepo dekker offentlig tilgjengelige tjenester som er satt i drift, og konfigurasjon for andre komponenter, blant annet roller for databaser, sikkerhetskopiering, e-posttransport og DNS. Den dokumenterte implementeringen besto av [19 Ansible-playbooks og 34 roller, til sammen 12 065 linjer](/nb/portfolio/servers-you-can-rebuild-from-scratch/), en historisk opptelling og ikke størrelsen på det nåværende repoet. Automatisering av sikkerhetskopiering og e-post har et eget trinn for aktivering i drift, atskilt fra konfigurasjonen. Sammensetningen er data og ikke flagg. Hver vert tilhører en nivågruppe, og gruppens YAML-variabler angir rollene verten får, slik at en klargjøringskjøring uten argumenter kan bringe hver vert til tilstanden gruppen deklarerer. Her brukes YAML som språket for deklarert tilstand, og vellykket resultat blir kontrollert og ikke antatt, fordi en konvergert vert må rapportere null endringer. YAML-en koster tid: hver endring går tregere enn å redigere en fil på serveren, og fordi en konvergering som bare delvis anvender endringene, er verre enn en som nekter å kjøre, kjører det nå en preflight-play foran den.\n\nTolv tusen linjer YAML trenger en maskin som leser dem før et menneske gjør det.\nPå det dokumenterte implementeringsstadiet i august 2026\n[var YAML ett av språkene en commit-port med 22 lintere sjekket](/nb/portfolio/built-a-22-linter-commit-gate/),\nsammen med HTML, CSS, JavaScript, Python, Markdown og shell. Porten har ikke noe advarselsnivå, så\nhver diagnostikk stopper commiten, og undertrykking i selve koden er forbudt uten unntak: en\nignore-kommentar eller et disable-direktiv i filen er ingen fluktvei. For YAML betyr det noe, fordi\nde fleste fellene nedenfor er helt gyldig syntaks, og bare en regel som avviser dem, fanger dem før\nde når en vert.\n\n## Hvor det går galt\n\nFellene nedenfor har ett trekk felles: filen lar seg tolke uten feil og betyr noe annet.\n\n**En landkode blir til false.** Etter reglene i YAML 1.1 er `yes`, `no`, `on`, `off`, `y` og `n`\nuten anførselstegn boolske verdier, i flere varianter av store og små bokstaver. Kjerneskjemaet i\nYAML 1.2 beholder bare `true` og `false`, i tre varianter av store og små bokstaver, og RFC 9512\nadvarer om at en tolker som følger den eldre syntaksen, kan lese `{insecure: n}` som false og ikke\nsom bokstaven n. En liste over nordiske land viser problemet:\n\n```yaml\ncountries:\n    - DK\n    - SE\n    - NO # YAML 1.1 leser dette som false\n```\n\nSett hver streng som kan leses som noe annet, i anførselstegn, skriv boolske verdier bare som `true`\nog `false`, og la en linter håndheve begge deler.\n\n**Et versjonsnummer mister et siffer.** Tall uten anførselstegn blir konvertert, så `version: 1.10`\nkommer fram som flyttallet `1.1`, og etter reglene i 1.1 markerer en innledende null et oktalt tall,\nså en kode skrevet som `010` blir 8. Dokumentasjonen til Ansible sier at en versjon som `\"1.0\"` skal\nstå i anførselstegn, av nettopp denne grunnen. Sett identifikatorer, koder og versjoner i\nanførselstegn; de er strenger som tilfeldigvis inneholder sifre.\n\n**En nøkkel havner under feil forelder.** Innrykket avgjør hvilken avbildning en nøkkel tilhører, så\nén linje som er forskjøvet to mellomrom, flytter en innstilling et annet sted uten noen feilmelding.\nSpesifikasjonen krever også at hver nøkkel i en avbildning er unik, og en gjentatt nøkkel langt nede\ni en lang blokk er lett å overse i en gjennomgang, så yamllint har en regel for hver av de to\nfeilene. Kjør den før filen tas i bruk.\n\n**Å laste inn en fil kjører kode.** Tagger kan navngi typer som hører til ett\nbestemt programmeringsspråk, og en laster som respekterer dem, bygger det\nobjektet filen ber om. Dokumentasjonen til PyYAML sammenligner bruk av `yaml.load` (med\nen utrygg laster) med `pickle.load`: den kan bygge objekter og kalle\nPython-funksjoner. Valget av laster betyr noe; gjeldende versjoner krever at den\nangis uttrykkelig. `yaml.safe_load` gjenkjenner bare grunnleggende YAML-tagger.\nRFC 9512 ber om at kjøring av kode i deserialiserere er slått av som standard.\nBruk den trygge lasteren til vanlige konfigurasjonsfiler.\n\n**En kort fil fyller minnet.** Ankere og aliaser gjør et YAML-dokument til en graf heller enn et\ntre. Når hvert anker gjentar det forrige to ganger, dobler hver ny linje størrelsen, så tretti korte\nlinjer beskriver mer enn en milliard strenger når et program går gjennom resultatet som et vanlig\ntre. RFC 9512 kaller dette eksponentiell dataekspansjon, angrepet kjent som _billion laughs_, og\nsvarer med prosessorer som begrenser rekursjonsdybden for ankere. Ta bare imot YAML utenfra gjennom\nen slik prosessor, og test grensen mot tolkeren som faktisk er i bruk.\n\n## Les mer\n\n- [YAML 1.2.2 specification](https://yaml.org/spec/1.2.2/) — selve språket, også kjerneskjemaet som\n  avgjør hvilken type verdier uten anførselstegn får.\n- [RFC 9512: YAML Media Type](https://www.rfc-editor.org/rfc/rfc9512) — registreringen av\n  `application/yaml`, med sikkerhetsmerknader om boolske verdier, kjøring av kode og utvidelse av\n  aliaser.\n- [YAML specification changes](https://yaml.org/spec/1.2.2/ext/changes/) — hva hver revisjon endret,\n  fra 1.2.1 til 1.2.2.\n- [Ansible: YAML Syntax](https://docs.ansible.com/ansible/latest/reference_appendices/YAMLSyntax.html)\n  — delmengden Ansible bruker, med fellene rundt anførselstegn.\n- [yamllint rules](https://yamllint.readthedocs.io/en/stable/rules.html) — sjekkene for\n  sannhetsverdier, dupliserte nøkler, oktale tall og innrykk.\n- [PyYAML documentation](https://pyyaml.org/wiki/PyYAMLDocumentation) — forskjellen på `load` og\n  `safe_load`, med bibliotekets egne ord.\n\n\u003chttps://engineer.company/nb/glossary/yaml/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Hvorfor NO kan bli false og 1.10 bli 1.1, hvordan et kort dokument fyller minnet, og hva en linter og en trygg laster gjør med det.","formats":{"gemtext":"https://engineer.company/nb/glossary/yaml/index.gmi","gopher":"https://engineer.company/nb/glossary/yaml/gophermap","html":"https://engineer.company/nb/glossary/yaml/","json":"https://engineer.company/nb/glossary/yaml/index.json","markdown":"https://engineer.company/nb/glossary/yaml/index.md","pdf":"https://engineer.company/nb/glossary/yaml/index.pdf"},"kind":"page","language":"nb","title":"Hva er YAML?","url":"https://engineer.company/nb/glossary/yaml/","version":1}