GitHub Action
Run runn
v0.123.0
Latest version
GitHub Action for runn
Add scenario file to your repository.
And set up a workflow file as follows and run runn on GitHub Actions.
The actions of the runn command are executed in the container.
# .github/workflows/ci.yml
name: API scenario Test
on:
push:
branches:
- main
pull_request:
jobs:
test:
runs-on: ubuntu-latest
services:
httpbin:
image: kennethreitz/httpbin:latest
ports:
- 8080:80
steps:
-
uses: actions/checkout@v4
-
uses: k2tzumi/runn-action@latest
with:
path_pattern: testdata/path/to/*.yml
env:
# Override parameters in scenario with environment variables
# NOTE: Specify `172.17.0.1` when accessing services on the GitHub Actions host.
END_POINT: http://172.17.0.1:8080/
command
Required
run
a scenario by specifying run.
list
the contents of a scenario by specifying list.
Ifloadt
is specified, the scenario can be used as a load test. Default isrun
.path_pattern
Required
Specify the path to the Runbook ( runn scenario file ).github-token
The GitHub token. Default is${{ github.token }}
.debug
Enable runtime debug output. Default isfalse
.verbose
Enable detailed progress output. Default isfalse
.version
This parameter specifies the version of runn.
If this parameter is omitted, runn-action automatically selects and runs the same version of runn as its own version.fail-fast
Terminates the process if a step in the scenario fails in the middle of a step. Default isfalse
.skip-test
Scenario runs, but test is not evaluated. Default isfalse
.shuffle
Shuffle multiple Runbooks to run with the runn command. Default isfalse
.concurrent
Enable concurrent execution. Default isfalse
.enable-read-parent-scope
Enableread:parent
scope. Default isfalse
.enable-read-remote-scope
Enableread:remote
scope. Default isfalse
.enable-run-exec-scope
Enablerun:exec
scope. Default isfalse
.labels
Specify a label to narrow down the target of execution. Multiple labels can be separated by commas.
See action.yml and runn README for more details on how to runbook it.