Support YAML Explict Typing

[osterman]

what

Support YAML "explicit types" used in numerous other projects, like Home Assistant.

why

• Greater flexibility to organize configurations
• Greater extensibility; should be able to add more of these explicit types.

Examples

• !env_var FOO will insert the value of the FOO environment variable (inspired by Home Assistant YAML)
• !unset will delete the value from the stack configuration (A YAML way of undefining a value without removing the key #227)
• !include FILE will insert the YAML contents of the file at that position with proper indentation
• !include_dir DIR will insert all the YAML files in lexicographic order with the proper indentation
• !secret aws/ssm FOO will read the value from AWS SSM and insert the value into the in-memory stack configuration

Set the CLOUDFLARE_API_KEY for the cloudflare provider.

env:
  CLOUDFLARE_API_KEY: !secret aws/ssm FOO

Related

#227

See Also

• https://www.home-assistant.io/docs/configuration/splitting_configuration/
• https://www.home-assistant.io/docs/configuration/splitting_configuration/#advanced-usage
• https://www.home-assistant.io/docs/configuration/yaml/
• https://stackoverflow.com/questions/63567945/how-to-extend-go-yaml-to-support-custom-tags

[osterman]

Support for explicit types was added in:

• Introduce Atmos YAML functions #810