Run a job locally with act

Run an Actions job in Docker locally before pushing; note: pin a real runner image

act -j build --secret-file .secrets -P ubuntu-latest=catthehacker/ubuntu:act-22.04

tool
github-actions7 commands
tags
github-actionscidebug

More github-actions commands

  • gh run rerun <id> --failed

    Retry just the failed jobs of a run, reusing prior successful results

  • gh cache list --sort size_in_bytes --order desc; gh cache delete <id>

    Find the biggest Actions caches and delete stale ones to free quota

  • permissions: id-token: write contents: read

    Job-level perms enabling OIDC token to assume a cloud role without static keys

  • gh workflow run deploy.yml -f env=prod -f version=1.4.2 --ref main

    Dispatch a workflow_dispatch run passing typed inputs; note: needs workflow_dispatch trigger

  • gh run watch $(gh run list -w deploy.yml -L1 --json databaseId -q '.[0].databaseId')

    Stream the newest run's progress live and exit with its status code

all 7 github-actions commands