Test a specfic matrix configuration

Usually you want to debug exactly one matrix configuration without running all of them.

For example you have this workflow

on: push
jobs:
  _:
    strategy:
      matrix:
        A:
        - A
        - B
        B:
        - 0
        - 1
        C:
        - true
        - false
    runs-on: self-hosted
    steps:
    - run: |
        echo "A=${{ matrix.A }}"
        echo "B=${{ matrix.B }}"
        echo "C=${{ matrix.C }}"

To run the configuration

A: B
B: 1
C: false

Execute the tool like this

Runner.Client --job _ --matrix A:B --matrix B:1 --matrix C:false

If you use runner.client version 3.11.0, you can also encode the matrix filter into the jobid for an action workflow. This is useful if you want to select a matrix configuration of a reusable workflow.

Runner.Client --job "_({A: B, B: 1, C: false})"