GitHub Actions · Lesson 9 of 10 · 3 min read
Operating Actions, migrating from Jenkins, troubleshooting
Debugging
- Re-run with debug logging (
ACTIONS_STEP_DEBUG/ACTIONS_RUNNER_DEBUGsecrets or "Enable debug logging" on re-run). actionlintcatches YAML/expression mistakes before pushing;actruns workflows locally (approximately).- Check the run's "Set up job" section for the token permissions actually granted.
- Common failures: missing
permissions: id-token: writefor OIDC ("Could not load credentials" / "Not authorized to perform sts:AssumeRoleWithWebIdentity" when thesubdoesn't match), secrets empty on fork PRs, path filters skipping required checks, cache misses due to changing keys,GITHUB_TOKENpushes not triggering other workflows (by design — use an App token if you need that).
Enlarge diagram
Swipe sideways to see all of it, or tap to open it full screen.
Jenkins → GitHub Actions mapping
| Jenkins | GitHub Actions |
|---|---|
| Jenkinsfile | .github/workflows/*.yml |
| Agent / label | runs-on / runner labels / ARC scale sets |
| Stage | Job (or steps) |
| Shared library | Reusable workflows + composite actions |
| Credentials store | Secrets + environments + OIDC |
input approval |
Environment required reviewers |
parallel / matrix |
Parallel jobs / strategy.matrix |
stash/archiveArtifacts |
Artifacts / caches |
| Multibranch pipeline | Built in (every branch/PR) |
| Plugins | Marketplace actions |
Migration approach: inventory pipelines, build reusable workflows for common patterns, migrate in waves, run in parallel briefly, decommission. (GitHub Actions Importer can convert Jenkins pipelines as a starting point.)
Cost and limits
GitHub-hosted minutes are billed (Linux cheapest; Windows and macOS cost more per minute). Reduce with path filters, concurrency cancellation, caching, timeouts, ARC self-hosted runners for heavy workloads, and skipping work on docs-only changes.