Substitution
Vela imports a substitution library to provide the ability to expand, or substitute, repository and build metadata to facilitate dynamic pipeline configurations.
String Operations
| Syntax | Example with Output | Description |
|---|---|---|
${VAR^} | VAR=example; echo ${VAR^}► Example | Converts the first character of the variable to uppercase |
${VAR^^} | VAR=example; echo ${VAR^^}► EXAMPLE | Converts all characters of the variable to uppercase |
${VAR,} | VAR=EXAMPLE; echo ${VAR,}► eXAMPLE | Converts the first character of the variable to lowercase |
${VAR,,} | VAR=EXAMPLE; echo ${VAR,,}► example | Converts all characters of the variable to lowercase |
${VAR:position} | VAR=example; echo ${VAR:1}► xample | Extracts a substring from the variable starting at the position |
${VAR:position:length} | VAR=example; echo ${VAR:2:3}► amp | Extracts a substring from the variable starting at the position with the specified length |
${VAR#substring} | VAR=exampleexample; echo ${VAR#exa}► mpleexample | Removes the shortest match of substring from the start of the variable |
${VAR##substring} | VAR=exampleexample; echo ${VAR##*exa}► mple | Removes the longest match of substring from the start of the variable |
${VAR%substring} | VAR=exampleexample; echo ${VAR%mple}► exampleexa | Removes the shortest match of substring from the end of the variable |
${VAR%%substring} | VAR=exampleexample; echo ${VAR%%mple*}► exa | Removes the longest match of substring from the end of the variable |
${VAR/substring/replacement} | VAR=exampleexample; echo ${VAR/exam/ap}► appleexample | Replaces the first match of substring with replacement in the variable |
${VAR//substring/replacement} | VAR=exampleexample; echo ${VAR//exam/ap}► appleapple | Replaces all matches of substring with replacement in the variable |
${VAR/#substring/replacement} | VAR=example; echo ${VAR/#exam/ap}► apple | If the variable starts with substring, replace it with replacement |
${VAR/%substring/replacement} | VAR=example; echo ${VAR/%mple/ctly}► exactly | If the variable ends with substring, replace it with replacement |
${#VAR} | VAR=example; echo ${#VAR}► 7 | Returns the length of the variable |
${VAR=default} | unset VAR; echo ${VAR=default}► default | If the variable is unset or null, it will be set to default |
${VAR:=default} | unset VAR; echo ${VAR:=default}► default | If the variable is unset or null, it will be set to default and the assignment is exported |
${VAR:-default} | unset VAR; echo ${VAR:-default}► default | If the variable is unset or null, it will be replaced with default without changing the value of VAR |
tip
If you want to play with the examples above in a terminal, make sure you are in a bash shell.
Escaping
tip
var expressions are evaluated before the yaml is parsed. If you do not want the system to evaluate an expression it must be escaped.
This can come in handy particularly when dealing with runtime build environment variables.
version: "1"
steps:
- name: echo
commands:
# This expression does not escape the evaluation
+ - echo ${VELA_BUILD_COMMIT}
# This expression does escape the evaluation by adding the double '$$'
+ - echo $${VELA_BUILD_COMMIT}