{"canonical_url":"https://engineer.company/sv/glossary/yaml/","content_markdown":"# YAML\n\n## Vad det är\n\nYAML är ett textformat för strukturerade data som markerar strukturen med indrag, kolon och\nbindestreck i stället för klamrar och citattecken, och det är därför det brukar väljas för\nkonfiguration som människor skriver och granskar för hand. Namnet är en rekursiv akronym, ”YAML\nAin't Markup Language”. Filerna slutar på `.yaml` eller `.yml`, och RFC 9512, som publicerades i\nfebruari 2024, registrerade medietypen `application/yaml` och angav `.yaml` som föredragen\nfiländelse.\n\nUnder den sparsamma interpunktionen finns en liten datamodell. Den består av mappningar, som parar\nihop nycklar med värden, sekvenser, som är ordnade listor, och skalärer: strängar, tal, booleska\nvärden och null. Runt den modellen lägger språket till det som en människa som redigerar en fil vill\nha: kommentarer som börjar med `#`, blockskalärer som behåller radbrytningar med `|` eller viker\nihop dem med `\u003e`, flera dokument i en fil åtskilda av `---`, ankare och alias (`\u0026name` och `*name`)\nsom låter ett värde återanvändas på andra ställen, och taggar som anger en typ rakt ut.\n\nDet första ramverket för YAML skrevs i Perl 2001. Version 1.1 av specifikationen följde 2005, och\nversion 1.2 kom 2009 med huvudsyftet att göra YAML till en strikt övermängd av JSON, och med många\nav de äldre reglerna för implicita typer borttagna. Revision 1.2.2, som publicerades i oktober 2021,\nrättade fel och förtydligade formuleringar utan att ändra språket. Mycket programvara läser ändå\nfortfarande enligt de äldre reglerna: dokumentationen för Ansible noterar att PyYAML och libyaml\nimplementerar YAML 1.1.\n\nYAML står alltså mellan två grannar. JSON är en strikt delmängd av YAML, kortfattad och entydig,\ngjord för att program ska utbyta data. TOML är ett plattare konfigurationsformat där varje sträng\nstår inom citattecken, så att ett värdes typ aldrig gissas. YAML erbjuder mer än båda, och den extra\nfriheten är just där problemen kommer ifrån.\n\n## Varför det spelar roll\n\nDet verkliga valet är vilket format en fil ska få när människor kommer att underhålla den i flera\når: beskrivningar av driftsättningar, flödesdefinitioner för CI, serverkonfiguration. Playbooks i\nAnsible är YAML, och det är konfigurationsfilerna för många andra infrastrukturverktyg också, så för\nmycket av det arbetet är beslutet redan fattat högre upp i kedjan, och det som återstår att bestämma\när hur strikt filen ska skrivas.\n\nArgumentet för YAML är läsbarheten. En granskare kan läsa en diff av det utan att räkna klamrar, en\nkommentar kan förklara varför ett värde är som det är, och ett skript eller ett certifikat på flera\nrader får plats i en blockskalär utan att något behöver escapas. Mot det står att blanktecken bär\nbetydelse, så att en nyckel som är indragen två mellanslag för långt kan hamna i en annan mappning\nmedan filen ändå går att tolka. Tabbar är helt förbjudna för indrag. Värden utan citattecken får sin\ntyp av hur de stavas, och stavningsreglerna skiljer sig mellan 1.1 och 1.2. Mallar lägger till en\nandra syntax ovanpå: i Ansible måste ett värde som börjar med `{{` stå inom citattecken, annars tar\ntolken det för en mappning.\n\nDet som avgör beslutet är hur filen ska kontrolleras. YAML med ett lintverktyg och en vana att sätta\nsträngar inom citattecken är ett bekvämt format för konfiguration som ett team redigerar\ntillsammans. YAML utan någotdera är ett format där en giltig fil kan säga något annat än vad\nförfattaren menade. För data som skickas mellan program är JSON det säkrare standardvalet, och för\nen kort inställningsfil med få nivåer av nästling är TOML enklare.\n\n## Så ser det ut i praktiken\n\nFöretagets infrastrukturrepo omfattar publika tjänster i drift och konfiguration\nav andra komponenter, däribland roller för databas, säkerhetskopiering,\ne-posttransport och DNS. Den dokumenterade implementeringen omfattade [19\nAnsible-playbooks och 34 roller, 12 065 rader\nsammanlagt](/sv/portfolio/servers-you-can-rebuild-from-scratch/), en historisk\nsiffra snarare än repots nuvarande storlek. Automatisering av säkerhetskopiering\noch e-post har ett separat steg för aktivering i drift utöver konfigurationen.\nSammansättningen är data snarare än flaggor. Varje värddator tillhör en\nnivågrupp, och gruppens YAML-variabler listar de roller som värddatorn får, så\nen provisioneringskörning behöver inga argument för att föra varje värddator\ntill det tillstånd som dess grupp deklarerar. Det är YAML som språk för\ndeklarerat tillstånd, och resultatet kontrolleras i stället för att antas,\neftersom en konvergerad värddator måste rapportera noll ändringar. YAML kostar\ntid: varje ändring tar längre tid än att redigera en fil direkt på servern, och\neftersom en konvergering som bara tillämpas till hälften är värre än en som\nvägrar körs numera en preflight-play framför den.\n\nTolv tusen rader YAML behöver en maskin som läser dem innan en människa gör det.\nI det dokumenterade implementeringsskedet i augusti 2026\n[var YAML ett av språken som en kvalitetsgrind med 22 lintverktyg kontrollerade](/sv/portfolio/built-a-22-linter-commit-gate/),\ntillsammans med HTML, CSS, JavaScript, Python, Markdown och shell. Grinden saknar varningsnivå, så\nvarje diagnostik stoppar committen, och undertryckningar direkt i koden är helt förbjudna: en\nkommentar som ignorerar en regel eller ett direktiv som stänger av den är ingen nödutgång. För YAML\nspelar det roll, eftersom de flesta av fällorna nedan är helt giltig syntax, och bara en regel som\nvägrar dem fångar dem innan de når en server.\n\n## Var det går fel\n\nFällorna nedan har en sak gemensamt: filen tolkas utan fel och betyder något annat.\n\n**En landskod blir false.** Enligt reglerna i YAML 1.1 är `yes`, `no`, `on`, `off`, `y` och `n` utan\ncitattecken, i flera varianter av versaler och gemener, booleska värden. Kärnschemat i YAML 1.2\nbehåller bara `true` och `false`, i tre skrivsätt, och RFC 9512 varnar för att en tolk som följer\nden äldre syntaxen kan läsa `{insecure: n}` som false i stället för som bokstaven n. En lista över\nnordiska länder visar problemet:\n\n```yaml\ncountries:\n    - DK\n    - SE\n    - NO # YAML 1.1 reads this as false\n```\n\nSätt citattecken kring varje sträng som kan läsas som något annat, skriv booleska värden bara som\n`true` och `false`, och låt ett lintverktyg upprätthålla båda.\n\n**Ett versionsnummer tappar en siffra.** Tal utan citattecken konverteras, så `version: 1.10` kommer\nfram som flyttalet `1.1`, och enligt reglerna i 1.1 markerar en inledande nolla ett oktalt tal, så\nen kod skriven som `010` blir 8. Dokumentationen för Ansible uppmanar sina användare att sätta\ncitattecken kring en version som `\"1.0\"` av just det skälet. Sätt citattecken kring identifierare,\nkoder och versioner, som är strängar som råkar innehålla siffror.\n\n**En nyckel hamnar under fel förälder.** Indraget avgör vilken mappning en nyckel hör till, så en\nrad som flyttas två mellanslag flyttar en inställning någon annanstans utan något fel.\nSpecifikationen kräver också att varje nyckel i en mappning är unik, och en upprepad nyckel långt\nned i ett långt block är lätt att missa vid granskning, så yamllint har en regel för vart och ett av\nde två misstagen. Kör det innan filen används.\n\n**Att ladda en fil kör kod.** Taggar kan namnge språkspecifika typer, och en\nladdare som respekterar dem konstruerar det objekt filen ber om.\nDokumentationen för PyYAML jämför användning av `yaml.load` (med en osäker laddare) med\n`pickle.load`: den kan konstruera objekt och anropa Python-funktioner. Valet\nav laddare spelar roll; aktuella versioner kräver att den anges uttryckligen.\n`yaml.safe_load` känner bara igen grundläggande YAML-taggar. RFC 9512 begär\natt kodkörning i deserialiserare ska vara avstängd som standard. Använd den\nsäkra laddaren för vanliga konfigurationsfiler.\n\n**En kort fil fyller minnet.** Ankare och alias gör ett YAML-dokument till en graf snarare än ett\nträd. När varje ankare upprepar det föregående två gånger fördubblar varje ny rad storleken, så\ntrettio korta rader beskriver mer än en miljard strängar när ett program går igenom resultatet som\nett vanligt träd. RFC 9512 kallar det exponentiell dataexpansion, attacken billion laughs, och möter\ndet med processorer som begränsar rekursionsdjupet för ankare. Ta bara emot YAML utifrån genom en\nsådan processor, och testa gränsen mot den tolk som faktiskt används.\n\n## Läs mer\n\n- [YAML 1.2.2 specification](https://yaml.org/spec/1.2.2/) — själva språket, inklusive kärnschemat\n  som avgör hur värden utan citattecken får sin typ.\n- [RFC 9512: YAML Media Type](https://www.rfc-editor.org/rfc/rfc9512) — registreringen av\n  `application/yaml`, med säkerhetsanteckningar om booleska värden, kodkörning och expansion av\n  alias.\n- [YAML specification changes](https://yaml.org/spec/1.2.2/ext/changes/) — vad varje revision\n  ändrade, från 1.2.1 till 1.2.2.\n- [Ansible: YAML Syntax](https://docs.ansible.com/ansible/latest/reference_appendices/YAMLSyntax.html)\n  — den delmängd som Ansible använder, med dess fällor kring citattecken.\n- [yamllint rules](https://yamllint.readthedocs.io/en/stable/rules.html) — kontrollerna för\n  sanningsvärden (truthy), dubblerade nycklar, oktala tal och indrag.\n- [PyYAML documentation](https://pyyaml.org/wiki/PyYAMLDocumentation) — skillnaden mellan `load` och\n  `safe_load`, med bibliotekets egna ord.\n\n\u003chttps://engineer.company/sv/glossary/yaml/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Vad YAML är, när en fil som redigeras för hand bör använda det i stället för JSON eller TOML, och fällorna med booleska värden, indrag och osäkra laddare.","formats":{"gemtext":"https://engineer.company/sv/glossary/yaml/index.gmi","gopher":"https://engineer.company/sv/glossary/yaml/gophermap","html":"https://engineer.company/sv/glossary/yaml/","json":"https://engineer.company/sv/glossary/yaml/index.json","markdown":"https://engineer.company/sv/glossary/yaml/index.md","pdf":"https://engineer.company/sv/glossary/yaml/index.pdf"},"kind":"page","language":"sv","title":"Vad är YAML?","url":"https://engineer.company/sv/glossary/yaml/","version":1}