Template engine

This page contains description of osdf template commands. Template engine allows you to insert values into your templates from deploy.yaml properties

~set(key)

Set value for key. If (key) arg is emitted, key from template will be used

# source
john:
  age: 18
---
# template
people:
  bob:
    age: 17
  john: ~set
---
# result
people:
  bob:
    age: 17
  john:
    age: 18

~include(key)

Add entries to map. If (key) arg is emitted, key from template will be used

# source
others:
  alice: 3
  bob: 2
closeFriends:
  gary: 7
---
# template
people:
  eve: 5
  friends: ~include(closeFriends)
  others: ~include
---
# result
people:
  eve: 5
  alice: 3
  bob: 2
  gary: 7

~add(key)

Add entries to list

# source
many:
  - alice: 3
  - bob: 2
single:
  kate: 6
---
# template
people:
  - eve: 5
  - ~add(many)
  - ~add(single)
  - ~add(unknown)
---
# result
people:
  - eve: 5
  - alice: 3
  - bob: 2
  - kate: 6

~if(key)

Include key conditionally. False if key doesn't exist or key == false. ~if(...) will be deleted from key.

# source
tls.enabled: false
---
# template
settings:
  http: something
  tls~if(tls.enabled): some-tls-settings
---
# result
settings:
  http: something