Opscraft
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_DEBUG secrets or "Enable debug logging" on re-run).
  • actionlint catches YAML/expression mistakes before pushing; act runs workflows locally (approximately).
  • Check the run's "Set up job" section for the token permissions actually granted.
  • Common failures: missing permissions: id-token: write for OIDC ("Could not load credentials" / "Not authorized to perform sts:AssumeRoleWithWebIdentity" when the sub doesn't match), secrets empty on fork PRs, path filters skipping required checks, cache misses due to changing keys, GITHUB_TOKEN pushes not triggering other workflows (by design — use an App token if you need that).
Enlarge diagramRead "Set up job"which tokenpermissions weregrantedRe-run with debugstep and runner debuglogsLintactionlint catchesexpression mistakesCheck OIDCid-token: write and thetrust sub1234
Figure 1. A short checklist when a workflow fails.
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.