YAML

Steps and Stages Pipeline use “YAML Ain’t Markup Language” (YAML) which is a data serialization language designed to be human friendly. Vela accepts YAML files with either a .yml or .yaml extension. If you’d like to learn more about the YAML language, we recommend you see, “Learn YAML in five minutes.”.

Terminology Check

Whether you are a YAML expert or a novice, here is some quick terminology that you should be aware of:

Document

A file ending with .yml or .yaml that contains contents following the YAML spec is called a document, see YAML 1.2 spec for full details.

Example:

---
key: value

Keys

A YAML document is compose of one to many key-value pairs where the value is evaluated to an explicit type (Int, Float, string, bool, etc), see YAML 1.2 spec for full details.

Example:

---
# an integer
canonical: 12345

# a float
canonical: 3.14159e+3

# a string
canonical: "Hello, World"

# a bool
canonical: true