docs: detail how to run action locally via the Docker container

weierophinney · weierophinney · commit fcd9e04fde88 · 2021-03-05T08:34:33.000-06:00
Signed-off-by: Matthew Weier O'Phinney &lt;matthew@weierophinney.net&gt;
diff --git a/README.md b/README.md
@@ -201,3 +201,13 @@ The easiest way to exclude a single job is via the `name` parameter:
   ]
 }
 ```
+
+## Testing matrix generation locally using Docker
+
+To test matrix generation in a local checkout on your own machine, you can do the following:
+
+```bash
+$ docker run -v $(realpath .):/github/workspace -w=/github/workspace ghcr.io/laminas/laminas-ci-matrix:1
+```
+
+This will run the action locally and detail what matrix will be produced; it can be particularly useful for debugging issues with your `.laminas-ci.json` configuration.

Original file line number	Diff line number	Diff line change
@@ -201,3 +201,13 @@ The easiest way to exclude a single job is via the `name` parameter:
`201`	`201`	`]`
`202`	`202`	`}`
`203`	`203`	```
	`204`	`+`
	`205`	`+## Testing matrix generation locally using Docker`
	`206`	`+`
	`207`	`+To test matrix generation in a local checkout on your own machine, you can do the following:`
	`208`	`+`
	`209`	+```bash
	`210`	`+$ docker run -v $(realpath .):/github/workspace -w=/github/workspace ghcr.io/laminas/laminas-ci-matrix:1`
	`211`	+```
	`212`	`+`
	`213`	+This will run the action locally and detail what matrix will be produced; it can be particularly useful for debugging issues with your `.laminas-ci.json` configuration.