Style guides

• Language style guides
  • Jinja templating language
    • Notation
    • Optional mapping keys
    • Optional list keys
    • Optional boolean keys
    • Optional keys
  • YAML data-serialization language
    • Avoid gotchas
• Pillar style guide
• Salt style guide
  • State IDs
  • State functions
    • cmd
    • file
    • service
  • Includes
  • Requisites
  • Macros
  • Looping over Pillar data
• Configuration file style guide

grains

To make Pillar, state and configuration files more reusable, use Grains where possible. Common grains with example values are:

cpuarch

x86_64

kernel

Linux (capitalized)

os

Ubuntu (capitalized)

osarch

amd64

oscodename

bionic

fqdn

The server’s fully-qualified domain name.

fqdn_ip4

The server’s IPv4 address.

fqdn_ip6

The server’s IPv6 address.

mem_total

The amount of RAM, in megabytes.

num_cpus

The number of CPUs.