gha/README.md

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

Passing secrets

You can set the value of secrets defined in your workflow by passing them as environment variables, e.g.:

MY_SECRET_TOKEN=yo-mamma gha

Development

There are still some things to do to achieve full functional parity.

This app currently only supports GitGub-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 default GITHUB_TOKEN env var