YAML for domains

View as Markdown

Learn how to configure domain DNS records using YAML in Buddy pipelines. Set up A, AAAA, CNAME, MX, TXT records with geolocation routing.

YAML parameters for YAML for domains

Domain

recordsrequiredRecord<string, RecordYaml[]>

DNS records grouped by subname ('@' for the domain root, e.g. 'www', 'mail'); each subname maps to a list of records. When updating an existing domain, keep the root SOA and NS records unchanged, as the export returns them.

notestring

Note for this resource

agent_notestring

YAML note for AI agents operating on this resource

Last modified on Jul 21, 2026

YAML for agents YAML for distributions

YAML examples for YAML for domains

Minimal domain

yaml

example.com:
  records:
    "@":
      - type: A
        values: 1.2.3.4

Domain with multiple record types and geolocation routing

yaml

example.com:
  records:
    "@":
      - type: A
        ttl: 3600
        values:
          - 1.2.3.4
          - 5.6.7.8
      - type: TXT
        values: "v=spf1 include:_spf.example.com ~all"
    www:
      - type: CNAME
        values: example.com
        note: Points to the apex
        agent_note: 'ticket: OPS-142'
    geo:
      - type: A
        routing: Geolocation
        values:
          Default:
            - 1.1.1.1
          Europe:
            - 2.2.2.2
          US:
            - 3.3.3.3
  note: Private DNS zone of the internal services
  agent_note: 'owner: devops-team'