configure-build

Action for applying the Bonsai Foundation standard versioning and release scheme in GitHub Actions workflows.

The action determines the build version from the event that triggered the workflow, exports it for the rest of the build to consume, and reports whether the repository contains Bonsai workflows that need to be rendered for documentation.

Usage

Invoke the action early in your build job, after checking out the repository:

- name: Configure build
  id: configure-build
  uses: bonsai-rx/configure-build@v2

The action exports two environment variables for later steps to consume:

• CiBuildVersion is the version to build. It comes from the release tag on a release, from the version input on a manual dispatch, and otherwise from the most recent release with a continuous-integration suffix appended.
• CiIsForRelease is true when the build is producing a public release and false otherwise.

It also sets the need-workflow-image-render output, which is true when the repository contains Bonsai workflows that need images rendered for the documentation website. Expose it as a job output so later jobs can decide whether to run the rendering step:

jobs:
  build:
    outputs:
      need-workflow-image-render: ${{steps.configure-build.outputs.need-workflow-image-render}}

Documentation workflow detection

By default the action looks for Bonsai workflows under docs/workflows/ and docs/examples/. Override the search with the documentation-workflows input:

- name: Configure build
  id: configure-build
  uses: bonsai-rx/configure-build@v2
  with:
    documentation-workflows: |
      docs/workflows/**/*.bonsai
      docs/examples/**/*.bonsai

Documentation

See action.yml for the full list of input parameters and outputs supported by this action.