Skip to content
Configuration Reference

Configuration Reference

Complete reference for GenDI YAML configuration files.

Schema Validation

Add this line at the top of your YAML files for editor autocomplete and validation:

# yaml-language-server: $schema=https://raw.githubusercontent.com/gendi-org/gendi/master/gendi.schema.json

Supported editors:

For local schema validation:

# yaml-language-server: $schema=./gendi.schema.json

Root Structure

A config file has four optional top-level keys and nothing else:

imports: []      # other configs to load and merge before this file
parameters: {}   # scalar defaults, injected as %name%
tags: {}         # tag declarations
services: {}     # service definitions

Each of those keys has its own page: Parameters, Services, Tags and Imports. How an individual argument is spelled is covered in Arguments.

See Also