Skip to content

Importing YAML

Three import paths:

1. Paste / type

The Configuration editor's left pane is a YAML editor with syntax highlighting and inline error markers. Paste the YAML, save as draft.

2. Upload a file

Configurations → New → Upload. Pick a .yaml or .yml file. The content is loaded into the draft. There is no implicit reformatting — what you upload is what gets stored.

3. Import from Git

If a Git source is registered (GitOps), configurations matching the path glob are imported automatically on every commit. You do not need to create them manually.

Naming a configuration

The configuration name must be unique per tenant. The UI suggests:

  • the filename without extension (when uploading), or
  • the value of # ampora.name: <name> if it appears as the very first line of the YAML (frontmatter form).

Existing names are flagged inline; pick another or import a new version of an existing configuration instead.

Importing as a new version of an existing configuration

To replace the current draft on an existing configuration:

  1. Open the configuration.
  2. Versions → New draft.
  3. Paste / upload as above.

Save creates a new draft alongside the previous version. Publishing it makes it immutable.

Size limits

The default OpAmp:MaxMessageBytes is 10 MiB; any configuration larger than that cannot be sent to agents. The editor flags configurations nearing this size with a warning.

Encoding

YAML is read as UTF-8. Files with a UTF-16 BOM or other encodings are flagged on import; convert them to UTF-8 first.

What is preserved

  • Comments — yes, byte-for-byte.
  • YAML anchors and aliases — yes.
  • Trailing whitespace — yes.
  • Section ordering — yes.

What is normalised internally (for visualisation only)

The visualiser builds a graph from the YAML; that involves:

  • expanding YAML anchors,
  • resolving component references,
  • ignoring formatting whitespace.

Those normalisations live in the visualiser's intermediate model. The stored YAML is untouched. This is why round-trip editing of YAML through the visual editor preserves your formatting.