YAML for distributions
Learn how to configure routing distributions using YAML in Buddy. Map domains, subdomains and paths to tunnels, sandboxes, artifacts or external addresses, per region.
YAML examples for YAML for distributions
Single route to an external backend
yaml
- distribution: my-distro
routes:
- domain: example.com
target:
endpoint: EXTERNAL
address: https://backend.example.com
Distribution with permissions and all target types
yaml
- distribution: my-distro
name: My Distribution
disabled: false
note: Public entry points of the marketing site
agent_note: 'owner: devops-team'
permissions:
others: READ_ONLY
users:
dev@example.com: MANAGE
groups:
admins: MANAGE
routes:
- domain: example.com
subdomain: www
path: /api
type: DIRECT_PROXY
note: Main API entry point
agent_note: 'ticket: OPS-142'
target:
endpoint: EXTERNAL
address: https://backend.example.com
- domain: cdn.example.com
type: CACHED_PROXY
target:
endpoint: SANDBOX
sandbox:
id: my-sandbox
endpoint: web
- domain: app.example.com
target:
endpoint: TUNNEL
tunnel:
agent: my-agent
name: my-tunnel
- domain: downloads.example.com
target:
endpoint: ARTIFACT
artifact:
id: my-artifact
version: 1.0.0
Geolocation routing by region
yaml
- distribution: geo-distro
routes:
- domain: geo.example.com
type: CLOAKING
regions:
Default:
endpoint: EXTERNAL
address: https://global.example.com
Asia:
endpoint: EXTERNAL
address: https://asia.example.com
US:
endpoint: EXTERNAL
address: https://us.example.com