Context State

FBL
FireBlink Contact Us Source Code
Search…
About FBL
Execute (Shell & JavaScript)
Anti-Patterns & Pitfalls
Packages
Glossary
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
  '#x27;:
    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:
  '#x27;:
    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:
  '#x27;:
    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:
  '#x27;:
    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:
  '#x27;:
    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
Flow Control
Execute (Shell & JavaScript)
Last modified 2yr ago
Copy link
On this page
Action Handler: Context Values Assignment
Action Handler: Secret Values Assignment
Action Handler: Summary