Matrix Output

Collect outputs from each matrix job. Currently, setting output for matrix jobs will cause outputs of earlier completed jobs to be overwritten by jobs completed later (see discussion). This action allows the output from each matrix job to be collected into a JSON list to be utilized by dependent jobs.

Requirements

The matrix-output action requires that each job in the job matrix uses a distinct job name which is unique within the workflow file. By default job matrix job names are distinct (e.g. name: Build -> Build (App One, user/app1)) so this only a problem if you accidentally specify the same job name for multiple matrix jobs. If the job name is not unique within the workflow this action will fail and report the ambiguous job name.

Additionally, the matrix-output action is intended to only be used once within a job. Attempting to utilize this action multiple times within the same job will cause the second use of this action to fail.

Finally, it is highly recommended that the matrix-output is either the last step in the job or the near the end of the job. If you choose to have this action run before other slow running actions you may see some extended runtimes for the last few running jobs in the matrix. In order to guarantee correct output we require that the last running job has a complete set of outputs from all other jobs in the matrix. To ensure the last running job has a complete set of outputs we have those jobs wait for other jobs with an incomplete set of outputs.

Examples

```yaml

CI.yaml

jobs: build: name: Build ${{ matrix.build.name }} # These permissions are needed to: # - Use matrix-output: https://github.com/beacon-biosignals/matrix-output#permissions permissions: actions: read runs-on: ubuntu-latest strategy: fail-fast: false matrix: build: - name: App One repo: user/app1 - name: App Two repo: user/app2 outputs: json: ${{ steps.matrix-output.outputs.json }} steps: - uses: docker/build-push-action@v6 id: build-push with: tags: ${{ matrix.build.repo }}:latest push: true # !!! Important: In order to reduce delays we highly recommend that the # matrix-output action is either the last step in a job or close to the end. - uses: beacon-biosignals/matrix-output@v1 id: matrix-output with: yaml: | name: ${{ matrix.build.name }} image: ${{ matrix.build.repo }}@${{ steps.build-push.outputs.digest }}

test: name: Test ${{ matrix.build.name }} needs: build runs-on: ubuntu-latest container: image: ${{ matrix.build.image }} strategy: fail-fast: false matrix: build: ${{ fromJSON(needs.build.outputs.json) }} steps: ... ```

Inputs

The matrix-output action supports the following inputs:

| Name | Description | Required | Example | |:-----------------|:------------|:---------|:--------| | yaml | A string representing a YAML data. Typically, a simple dictionary of key/value pairs. | Yes |

name: ${{ matrix.name }}
...

Outputs

| Name | Description | Example | |:-------|:------------|:--------| | json | A string representing a JSON list of dictionaries. Each dictionary in the list contains the output for a single job from the job matrix. The order of this list corresponds to the job index (i.e. strategy.job-index). |

[
  {
    "name": "Server.jl",
    ...
  },
  {
    "name": "Client.jl",
    ...
  }
]

Permissions

The follow job permissions are required to run this action:

yaml permissions: actions: read contents: read

The permission actions: read is needed to determine which matrix jobs are still running while contents: read is need for running the action beacon-biosignals/job-context.