Links

Context State

Upon flow execution each action handler gets access to shared context.
EJS template can be used inside options to pass values from shared context. Please refer to plugin documentation if this feature supported and what options are required.
Example:
version: 1.0.0
pipeline:
plugin:
# Pass "something" from "ctx"
contextValue: <%- ctx.something %>
# Pass "password" from "secrets"
secretValue: <%- secrets.password %>
Available actions:
  • ctx - assign values to "ctx"
  • secret - assign values to "secret"
  • summary - report in the end of fbl execution

Action Handler: Context Values Assignment

Assign non-secret values to context ctx field or its child properties by path. General use case: register shared non-sensitive options that later will be used by actions.
ID: com.fireblink.fbl.context.values
Aliases:
  • fbl.context.values
  • context.values
  • context
  • ctx
Example 1: Assign values to context root directly:
ctx:
# assign to "ctx" directly
'$':
inline:
something: true
else: false
Example 2: Assign values from file "vars.yml" to field "vars -> files":
ctx:
# create hierarchy of objects: "files" inside "vars" that is inside "ctx"
$.vars:
files:
- vars.yml
Example 3: Assign values from file "vars.yml" after inline ones:
ctx:
'$':
inline:
test: true
files:
- vars.yml
# specify that files have a priority over inline vars
# if not provided inline vars will have priority over files
priority: 'files'
Example 4: Override instead of assigning
ctx:
'$.test':
inline:
test: true
# [optional] override everything tha tis inside "test" object with { test: true }
# use with caution
override: true
Example 5: Push to array
ctx:
'$.test':
inline: 1
# [optional] override everything tha tis inside "test" object with { test: true }
# use with caution
override: true
# [required] if you want to push inline or value(s) from file(s) to targets array
push: true
# [optional] if enambled and value is array its child items will be pushed instead of array itself
children: false
Example 6: Find files by mask:
ctx:
'$':
files:
- vars/*.yml

Action Handler: Secret Values Assignment

Same as above, but for secrets. All the options will me masked in report to prevent any security leakage.
ID: com.fireblink.fbl.secret.values
Aliases:
  • fbl.secret.values
  • secret.values
  • secrets
  • secret
Example 1: Assign values to secrets root directly:
secrets:
'$':
inline:
something: true
else: false
Example 2: Assign values from file "vars.yml" to field "vars -> files":
secrets:
$.vars:
files:
- vars.yml
Example 3: Assign values from file "vars.yml" after inline ones:
secrets:
'.':
inline:
test: true
files:
- vars.yml
# [optional] specify that files have a priority over inline vars
# if not provided inline vars will have priority over files
priority: 'files'
Example 4: Override instead of assigning
secrets:
'$.test':
inline:
test: true
# [optional] override everything tha tis inside "test" object with { test: true }
# use with caution
override: true
Example 5: Push to array
secrets:
'$.test':
inline: 1
# [optional] override everything tha tis inside "test" object with { test: true }
# use with caution
override: true
# [required] if you want to push inline or value(s) from file(s) to target's array
push: true
# [optional] if enambled and value is array its child items will be pushed instead of array itself
children: false
Example 6: Find files by mask:
secrets:
'$':
files:
- vars/*.yml

Action Handler: Summary

Add summary record. All summary records will be printed once the main flow ends.
ID: com.fireblink.fbl.context.summary
Aliases:
  • fbl.context.summary
  • context.summary
  • summary
Example:
summary:
# summary record title
title: Step Title
# summary record status
# statuses (ignoring case):
# - 'created', 'updated', 'passed', 'success', 'ok', 'yes' will be colored in green
# - 'deleted', 'failed', 'failure', 'error', 'no' - in red
# - 'ignored', 'skipped', 'none' - in yellow
# others will have default text color
status: Failed
# [optional] human readable duration (string)
duration: <%- $.duration(1000) %>
# [optional] additional data associated with record. Not presented in printed table.
payload: anything