Deployment Matrix Action

This action outputs a matrix with deployment configuration depending on a configured branch mapping.

Inputs

envs

An object that maps each environment to a branch and/or a tag. Each key corresponds to an environment, with the value being either a string (shorthand syntax) or an object (full syntax).

Default:

prod: master
dev: dev
stage: stage
test: test

Shorthand Syntax

The shorthand syntax allows for a simple key: value configuration, where key corresponds to an environment, and value corresponds to a branch (or a glob or regex). The shorthand string will get converted into the standard syntax, and in the resulting matrix the environment will be accessible at ${{ matrix.env }}.

Full Syntax

The full syntax allows for more configuration. key still corresponds to an environment, but the value is an array with any number of values.
branch and tag can be strings, globs, regex patterns (surrounded by /.../), or an array of these.

Glob Matching

If the value is a glob, the minimatch library will be used to determine whether the current ref matches.

Regex Matching

If the value is a valid regex pattern, then the ref will be matched using RegExp. The regex will be anchored, meaning it must match the entire string. If you want to allow characters before or after the regex, prepend or append the pattern with .*.

Regex patterns must start with / and end with /.

Examples

prod:
  tag: '/[0-9]+\.[0-9]\.[0-9]/'
stage:
  branch: stage*
dev:
  branch: [main, dev]

Custom Environment Name

To configure an explicit environment name, use the full syntax and set the name:

demo:
  branch: demo
  name: Cool Name # If not specified, name would be computed as `Demo`

jobs

List/CSV of jobs to run for each environment. Default: app

Outputs

matrix

JSON to be used for the matrix of a deployment action.
env will be the environment, name will be computed (Unless configured in the full syntax), and any other values added on will be passed through.

Example:

includes:
  - env: dev
    name: Development

count

Count of matching environments.

Example usage

gen-deploy-matrix:
  name: Generate Deployment Matrix
  runs-on: ubuntu-latest
  outputs:
    matrix: ${{ steps.gen-deploy-matrix.outputs.matrix }}
  steps:
    - name: Generate Matrix
      uses: clevyr/deploy-matrix-action@v1
      id: gen-deploy-matrix
      with:
        envs: |
          prod: master
          dev: dev
          stage: stage
          test: test

build:
  name: Deploy ${{ matrix.name }}
  runs-on: ubuntu-latest
  needs: [gen-deploy-matrix]
  strategy:
    matrix: ${{ fromJson(needs.gen-deploy-matrix.outputs.matrix) }}
  steps:
    [...]