The language of Red Hat OpenShift, containers, Red Hat Ansible Automation Platform, and many more modern tools is YAML. Related to the equally popular JSON format, YAML is a clean and minimalist configuration language designed with a mere two data structures. It can look cryptic at first, but it's easy to understand once you know the data types and structure of a YAML file. This article explains how YAML works, and shows you how to write your own YAML and what tool you can use to verify its validity.
There are basically only two data structures in YAML: the sequence and the mapping.
What is a YAML sequence?
A sequence is a string of values listed in a specific order. A YAML sequence always starts with a dash and a space (-
), followed by a value.
This is a valid YAML file containing just a sequence:
--- - sysadmin - developer - engineer
What is a YAML mapping?
A YAML mapping is a key and value pair. Each key must occur only once within a mapping, and a mapping is unordered.
This is a valid YAML file containing just mappings:
--- server: "bare metal" cloud: "cluster" edge: "embedded"
Most YAML files contain a mixture of these two YAML data types. However, there are a few rules to keep in mind when composing or modifying real-world YAML.
Combined data in YAML
One YAML data type can contain the other. You can put a sequence into a mapping by using a sequence as the value of a single mapping.
When you do, you indent the sequence one level (2 spaces):
--- infrastructure: - server - cloud - edge connectors: - ethernet - wifi - sneakers
You can also put a mapping into a sequence:
--- - server: "bare metal" - cloud: "cluster" - edge: "embedded"
Additionally, you can put a sequence into a sequence. When you want to embed one sequence into another sequence, indent the child element one level (2 spaces):
--- - sysadmin - server - cloud - developer - engineer
And a mapping can be embedded into a mapping, but remember that a mapping is unordered. Depending on the data you're trying to preserve, order may or may not matter.
--- infrastructure: # mapping key server: "bare metal" # mapping value... cloud: "cluster" # ...continued
To create an ordered list of mappings, embed a mapping into a sequence, and then the sequence into a mapping:
--- infrastructure: # mapping key - server: "bare metal" # this is a sequence - cloud: "cluster" # with three mapping entities - edge: "embedded"
How to use yamllint
The application yamllint checks YAML files for syntax errors and gives useful feedback when something is wrong or non-optimal. You can install yamllint using Python:
$ python -m pip install yamllint --user
Once it's installed, run yamllint along with the file you want to verify:
$ yamllint bad.yaml bad.yaml 3:1 error wrong indentation: expected 2 but found 0 (indentation) 5:1 error too many blank lines (1 > 0) (empty-lines)
Once you fix your YAML, yamllint responds with silence:
$ yamllint good.yaml $
Use YAML for your data
YAML files can contain an ordered list or an unordered index. It’s a simple configuration language, and yet the two data types can be combined and embedded for a robust representation of relational data. You will see a lot of YAML once you start administering Red Hat OpenShift Service on AWS (ROSA) clusters, for everything from container files to service and security context definitions. You now know how to read YAML files and understand what they're expressing to your toolchain.
Über den Autor
Seth Kenlon is a Linux geek, open source enthusiast, free culture advocate, and tabletop gamer. Between gigs in the film industry and the tech industry (not necessarily exclusive of one another), he likes to design games and hack on code (also not necessarily exclusive of one another).
Nach Thema durchsuchen
Automatisierung
Das Neueste zum Thema IT-Automatisierung für Technologien, Teams und Umgebungen
Künstliche Intelligenz
Erfahren Sie das Neueste von den Plattformen, die es Kunden ermöglichen, KI-Workloads beliebig auszuführen
Open Hybrid Cloud
Erfahren Sie, wie wir eine flexiblere Zukunft mit Hybrid Clouds schaffen.
Sicherheit
Erfahren Sie, wie wir Risiken in verschiedenen Umgebungen und Technologien reduzieren
Edge Computing
Erfahren Sie das Neueste von den Plattformen, die die Operations am Edge vereinfachen
Infrastruktur
Erfahren Sie das Neueste von der weltweit führenden Linux-Plattform für Unternehmen
Anwendungen
Entdecken Sie unsere Lösungen für komplexe Herausforderungen bei Anwendungen
Original Shows
Interessantes von den Experten, die die Technologien in Unternehmen mitgestalten
Produkte
- Red Hat Enterprise Linux
- Red Hat OpenShift
- Red Hat Ansible Automation Platform
- Cloud-Services
- Alle Produkte anzeigen
Tools
- Training & Zertifizierung
- Eigenes Konto
- Kundensupport
- Für Entwickler
- Partner finden
- Red Hat Ecosystem Catalog
- Mehrwert von Red Hat berechnen
- Dokumentation
Testen, kaufen und verkaufen
Kommunizieren
Über Red Hat
Als weltweit größter Anbieter von Open-Source-Software-Lösungen für Unternehmen stellen wir Linux-, Cloud-, Container- und Kubernetes-Technologien bereit. Wir bieten robuste Lösungen, die es Unternehmen erleichtern, plattform- und umgebungsübergreifend zu arbeiten – vom Rechenzentrum bis zum Netzwerkrand.
Wählen Sie eine Sprache
Red Hat legal and privacy links
- Über Red Hat
- Jobs bei Red Hat
- Veranstaltungen
- Standorte
- Red Hat kontaktieren
- Red Hat Blog
- Diversität, Gleichberechtigung und Inklusion
- Cool Stuff Store
- Red Hat Summit