Chapter 9: GitHub Actions Hands-On
9.9 Troubleshooting table
| Symptom | Likely cause | What to try |
|---|---|---|
| Workflow never runs | Wrong path / YAML invalid / event filter | File under .github/workflows/; Actions tab error |
pytest: command not found |
Deps not installed on runner | Install step before test |
| GHCR push denied | Missing packages: write or login |
Fix permissions + login action |
| Secret empty | Typo in secret name | Exact name match; repo vs org secrets |
| Docker build OOM / timeout | Huge context | .dockerignore (Chapter 6) |
| Flaky network test | External call in unit tests | Mock; keep unit tests offline |