Testing Github Actions workflow, locally.md

Prerequisites

• Install Docker Desktop for Mac

• Make sure socket is accessible

  

• Install act using Homebrew:

  brew install act

Creating GitHub Actions workflow

mkdir -p .github/workflows
touch .github/workflows/build.yml

Edit the yml file according to your workflow needs ...

Running Tests

From your project root directory, run:

act -P ubuntu-latest=ghcr.io/catthehacker/ubuntu:act-latest --container-architecture linux/amd64 -v

Note: The -v flag enables verbose output for better debugging.

Testing Specific Events

Test push event:

act push

Test manual workflow trigger:

act workflow_dispatch

Troubleshooting

• If you see warnings about Apple M-series chip, ensure you're using the --container-architecture linux/amd64 flag
• If Docker isn't running, you'll need to start Docker Desktop first
• Use -v flag for verbose output when debugging issues

For more information about act, visit the nektos/act repository.