mirror of
https://github.com/tschoffelen/gha.git
synced 2024-08-17 16:30:42 +03:00
2.0 KiB
2.0 KiB
GitHub Actions Tester
This Node application exposes an executable that allows you to test your GitHub workflow locally using Docker.
Installation
Install using NPM:
npm i -g gha
Other prerequisites:
- A local installation of Docker
- A repo with a
.github/main.workflow
file
Usage
Usage: gha [options]
Options:
-V, --version output the version number
-f <workflowfile> Set workflow file path, defaults to .github/main.workflow
-e <event> Set event, defaults to push
-h, --help output usage information
Development
This app currently only supports Github-hosted Dockerfiles (i.e. with the
{user}/{repo}@{ref}
or {user}/{repo}/{path}@{ref}
syntax), so we still need
to add:
- Add support for local Docker images:
./path/to/dir
- Add support for Docker Hub images:
docker://{image}:{tag}
- Add support for custom hosted Docker images:
docker://{host}/{image}:{tag}
Some improvements are also possible in other areas:
- Add support for secrets
- Add support for default
GITHUB_TOKEN
env var - Add
/github/home
volume that should exist by default - Add file
/github/workflow/event.json
that should exist by default